feat: add China Telecom R&D project template
This commit is contained in:
@@ -0,0 +1,59 @@
|
||||
# 中国电信研发项目初始化目录
|
||||
|
||||
将本目录与项目根目录的 `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. 不在多个位置复制同一条强制要求;在索引中链接到唯一来源。
|
||||
Reference in New Issue
Block a user