# 中国电信研发项目初始化目录

将本目录与项目根目录的 `AGENTS.md` 一起复制到新项目根目录。支持 `.agents/skills` 的 Codex、OpenCode 等 Agent 会发现 `telecom-rd-standards`；其他 Agent 应按 `AGENTS.md` 直接读取该技能。

## 目录契约

| 路径 | 用途 | 使用时机 |
| --- | --- | --- |
| `AGENTS.md` | 项目级红线与加载规则 | 每个新 Agent 或新任务开始 |
| `skills/telecom-rd-standards/SKILL.md` | 完整工作流与审查输出要求 | 新项目、设计、审查、交付或涉及规范的任务 |
| `skills/telecom-rd-standards/references/01-09-*.md` | 按功能加载的操作规范 | 按下表选择；高风险变更必须加载 |
| `skills/telecom-rd-standards/references/standards-map.md` | 原文索引 | 输出规范结论、高风险变更或条款争议时 |
| `references/quick-guides/` | 高频速查摘要 | 实现或日常自查 |
| `skills/telecom-rd-standards/references/source-documents/` | 脱敏 Markdown 原文整理版 | 规范结论、C 级别、阻断/整改项和强制条款核验；争议时回查原始 DOCX |

## 复用与核验

同一任务内可复用已读取且未变更的文件，无需重复全量阅读。任务范围、目标 C 级别、技术栈、数据敏感性、外部接口或部署方式变化时，重新按矩阵选择。

普通小范围实现先读相关速查指南；涉及安全、密钥、鉴权、数据库权限、外部接口、CI/CD、制品或部署时，必须读取对应功能规范。仅在输出 `规范要求`、C 级别结论、阻断/整改项，处理高风险变更、发生条款争议，或功能规范明确要求时，核验对应原文。

## 高频速查指南

| 文件 | 范围 |
| --- | --- |
| `01-overall-rd-standard.md` | 研发流程、角色、交付与评审 |
| `02-python-coding.md` / `03-frontend-coding.md` | Python 与前端编码 |
| `04-database-design.md` | 数据库设计与 SQL |
| `05-code-management.md` | 仓库、分支、提交和版本 |
| `06-artifact-management.md` / `07-pipeline-management.md` | 制品、溯源和 CI/CD |
| `08-test-management.md` / `09-security.md` | 测试、缺陷和安全 |
| `10-deployment.md` / `11-requirements-management.md` | 部署与需求追踪 |
| `12-rd-cloud-interoperability.md` / `13-development-checklist.md` | 研发云集成与日常自查 |

## 任务—规范选择矩阵

| 任务 | 首先读取的功能规范 | 需要核验的原文（触发时） |
| --- | --- | --- |
| 新建项目、服务、模块或目录结构 | `01-project-init-and-architecture.md` | 01、03、04、08、12 |
| 需求、验收、变更或追踪 | `02-requirements-and-traceability.md` | 03、04 |
| Python 或前端编码、代码审查 | `03-code-standards.md` | 03、06/07、12 |
| 表、字段、索引、SQL、迁移或数据库权限 | `04-database-and-data-model.md` | 04、05、12 |
| REST/OpenAPI、OAuth、研发云或数据接入 | `05-api-and-rd-cloud-integration.md` | 12、20-24 |
| 安全、密钥、认证、依赖或安全扫描 | `06-security-and-secrets.md` | 03、09、12 |
| Git、仓库、分支、提交、评审或版本 | `07-repository-and-change-management.md` | 03、04、08 |
| CI/CD、制品、组件、SBOM、晋级或发版 | `08-ci-artifacts-and-release.md` | 08-10、12 |
| 测试、缺陷、部署、验证或回退 | `09-testing-and-deployment.md` | 03、10、11、13 |

功能规范只负责缩小阅读范围；所有 `规范要求`、C 级别结论和阻断/整改项均必须回到对应原文的章节和 C 级别核验。

## 原文编号

`00` 为发布通知；`01-13` 为软件研发规范体系；`20-24` 为研发云互联互通试行规范。原文整理版使用稳定的 ASCII Markdown 文件名，中文全称保留在文件正文及 `standards-map.md` 中；条款争议、版式、表格和模板以工作区 `规范文档/` 的原始 DOCX 为准。

## 维护规则

1. 修改原文、速查摘要或技能时，同步检查 `standards-map.md` 与本索引。
2. 原文优先于速查摘要；速查摘要优先于个人经验。
3. 不在多个位置复制同一条强制要求；在索引中链接到唯一来源。