4.1 KiB
4.1 KiB
中国电信研发项目初始化目录
将本目录与项目根目录的 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 为准。
维护规则
- 修改原文、速查摘要或技能时,同步检查
standards-map.md与本索引。 - 原文优先于速查摘要;速查摘要优先于个人经验。
- 不在多个位置复制同一条强制要求;在索引中链接到唯一来源。