Files
2026-07-28 22:30:20 +08:00

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 为准。

维护规则

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