12 KiB
12 KiB
| 1 | ID | Title | Description | Acceptance | Test_Method | Tools | Dev_Status | Review1_Status | Regression_Status | Files | Dependencies | Notes |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 2 | GOV8-0 | 连续型治理合同建档 | 建立 GOV8 连续型系统治理合同,锁定本轮只做文档、流程、Issue 管理和审计脚本治理,不改 server/client 业务代码。 | 1) 本 CSV 校验通过;2) 范围限定 docs/issues/scripts/qa;3) 不删除旧 Issue CSV;4) 不部署;5) 后续同类治理任务优先进入本 CSV。 | 流程级验证:python3 /home/shunli/.codex/skills/plan/scripts/validate_issues_csv.py issues/2026-05-13_16-31-09-gov8-system-governance.csv;人工核对 Files 范围不含 server/client 业务代码。 | python3|manual | DONE | DONE | DONE | issues/2026-05-13_16-31-09-gov8-system-governance.csv | [] | 回滚路径:删除本 CSV 与本轮 docs/scripts/qa 变更;不影响运行环境。 |
| 3 | GOV8-1 | 旧 Issue 现状盘点 | 盘点当前 Issue CSV 过多且不可轻易删除的问题,明确旧 Issue 作为历史审计证据保留,不批量回写、不挪 archive。 | 1) 文档写明旧 Issue 不删除;2) 当前活跃合同和历史合同分层;3) 旧合同只通过索引/状态矩阵降级;4) 不修改旧 CSV。 | 流程级验证:rg -n '旧 Issue|历史合同|不删除|不批量回写|当前活跃治理流' docs/文档索引.md docs/文档事实源状态矩阵.md issues/README.md。 | rg | DONE | DONE | DONE | docs/文档索引.md|docs/文档事实源状态矩阵.md|issues/README.md | ["GOV8-0"] | 不回写历史快照;只增加治理口径。 |
| 4 | GOV8-2 | 文档台账字段设计 | 把文档事实源状态矩阵升级为轻量文档台账,固定 Doc_ID、Path、Category、Authority、Status、Owner、Related_Issues、Evidence、Supersedes、Last_Audited、Audit_Method、Risk、Notes 字段。 | 1) 状态矩阵包含文档台账字段说明;2) 状态值包含 CURRENT/DRAFT/EVIDENCE/HISTORICAL/SUPERSEDED/REMOVED;3) 核心文档至少登记一轮;4) 审计脚本能检查字段存在。 | 流程级验证:node scripts/qa/audit-docs.mjs --check-registry;rg -n 'Doc_ID|CURRENT|DRAFT|EVIDENCE|HISTORICAL|SUPERSEDED|REMOVED' docs/文档事实源状态矩阵.md。 | node|rg | DONE | DONE | DONE | docs/文档事实源状态矩阵.md|scripts/qa/audit-docs.mjs | ["GOV8-0"] | 台账先覆盖核心事实源、操作手册、草案/证据和技术参考;后续可在 GOV8 继续补全。 |
| 5 | GOV8-3 | 核心文档分类登记 | 在文档台账中登记核心当前事实源、操作手册、草案证据、技术参考和已移除历史材料。 | 1) 当前事实源、操作手册、草案/证据、技术参考均有分类;2) 每行有 Authority 和 Status;3) 当前事实源可指导开发;4) 草案/历史不能直接派工。 | 流程级验证:node scripts/qa/audit-docs.mjs --check-registry;人工核对状态矩阵中核心文档分类。 | node|manual | DONE | DONE | DONE | docs/文档事实源状态矩阵.md|scripts/qa/audit-docs.mjs | ["GOV8-2"] | 不要求一次登记所有历史 Issue;先固定核心文档台账。 |
| 6 | GOV8-4 | 文档索引按开发阶段重写 | 把文档索引从文档清单升级为按开发阶段阅读入口,覆盖需求、设计、开发、测试、发布、审计、历史追溯。 | 1) 索引有按开发阶段阅读规则;2) 当前活跃治理流可见;3) 历史合同入口被降级;4) 草案和历史证据不得直接开发。 | 流程级验证:rg -n '按开发阶段阅读|需求阶段|设计阶段|开发阶段|测试阶段|发布阶段|审计阶段|当前活跃治理流|不得直接开发' docs/文档索引.md。 | rg | DONE | DONE | DONE | docs/文档索引.md | ["GOV8-1","GOV8-3"] | 保留 DCL7 中文优先和物理精简策略。 |
| 7 | GOV8-5 | 核心文档统一头部规则 | 固定核心文档顶部元数据规则,明确文档状态、分类、适用范围、上级事实源、关联 Issue、最近审计和不得误读。 | 1) 开发交付规约写明统一头部规则;2) 文档索引/状态矩阵已有当前头部;3) 后续新增核心文档必须套用;4) 不批量强改所有历史文档。 | 流程级验证:rg -n '文档状态|分类|适用范围|上级事实源|关联 Issue|最近审计|不得误读' docs/开发交付与变更管理规约.md docs/文档索引.md docs/文档事实源状态矩阵.md。 | rg | DONE | DONE | DONE | docs/开发交付与变更管理规约.md|docs/文档索引.md|docs/文档事实源状态矩阵.md | ["GOV8-4"] | 只要求当前事实源和后续新增文档遵守;历史证据不大规模重写。 |
| 8 | GOV8-6 | 需求冻结规则 | 补强需求冻结规则:非微小需求必须先进入事实源和当前连续 CSV,冻结后新增想法默认进入后续池。 | 1) 需求冻结规则写入开发交付规约;2) 当前轮变更准入条件明确;3) 不再为小反馈单独开 CSV;4) 后续池和冻结项分流清楚。 | 流程级验证:rg -n '需求冻结|后续池|当前轮变更|小反馈|连续 CSV' docs/开发交付与变更管理规约.md issues/README.md。 | rg | DONE | DONE | DONE | docs/开发交付与变更管理规约.md|issues/README.md | ["GOV8-5"] | 开发中临时变更必须先做影响评估。 |
| 9 | GOV8-7 | 变更请求规则 | 补强变更请求规则:开发中新增范围必须说明原因、影响、测试变化和是否替代原需求。 | 1) 变更请求字段明确;2) 不满足准入条件时进入下一阶段或同治理流后续行;3) 测试影响必须同步;4) 旧 Issue 不回写。 | 流程级验证:rg -n '变更请求|变更原因|影响范围|测试影响|替代原需求|下一阶段' docs/开发交付与变更管理规约.md。 | rg | DONE | DONE | DONE | docs/开发交付与变更管理规约.md | ["GOV8-6"] | 只做流程规则,不改业务逻辑。 |
| 10 | GOV8-8 | 设计方案模板 | 在开发交付规约中加入设计方案模板,覆盖数据/API、权限、状态流、页面、异常、回滚和测试影响。 | 1) 模板字段完整;2) 涉及权限/状态机/迁移时必须写回滚;3) 可映射到 Issue CSV;4) 不引入外部平台。 | 流程级验证:rg -n '设计方案模板|数据/API|权限|状态流|回滚|测试影响' docs/开发交付与变更管理规约.md。 | rg | DONE | DONE | DONE | docs/开发交付与变更管理规约.md | ["GOV8-7"] | 复用现有 Issue CSV,不新增外部工具。 |
| 11 | GOV8-9 | 开发计划模板 | 在开发交付规约中加入开发计划模板,明确治理流、Issue 行、文件范围、依赖、验证和交接物。 | 1) 模板能指导 backend/frontend/qa 分工;2) 文件范围和依赖清晰;3) 交接物明确;4) 与连续型 CSV 规则一致。 | 流程级验证:rg -n '开发计划模板|治理流|Issue 行|文件范围|依赖|交接物' docs/开发交付与变更管理规约.md。 | rg | DONE | DONE | DONE | docs/开发交付与变更管理规约.md | ["GOV8-8"] | 后续实现 worker 仍按 AGENTS 作用域约束。 |
| 12 | GOV8-10 | 测试方案模板 | 在开发交付规约中加入测试方案模板,覆盖主流程、异常、权限、视觉、企业微信、公网和 SKIP 条件。 | 1) 测试方案字段完整;2) 明确流程级 Test_Method;3) 区分本地/公网匿名/带凭据;4) SKIP 不是通过。 | 流程级验证:rg -n '测试方案模板|主流程|异常流程|权限|视觉|企业微信|公网|SKIP' docs/开发交付与变更管理规约.md。 | rg | DONE | DONE | DONE | docs/开发交付与变更管理规约.md | ["GOV8-9"] | 测试细节仍以测试规约为准。 |
| 13 | GOV8-11 | 测试计划模板 | 在开发交付规约中加入测试计划模板,明确执行时机、命令、环境、证据路径、负责人和阻断条件。 | 1) 测试计划字段完整;2) 可形成执行清单;3) 证据路径明确;4) 阻断条件清晰。 | 流程级验证:rg -n '测试计划模板|执行时机|命令|环境|证据路径|负责人|阻断条件' docs/开发交付与变更管理规约.md。 | rg | DONE | DONE | DONE | docs/开发交付与变更管理规约.md | ["GOV8-10"] | 不替代 docs/测试规约与回归门禁.md。 |
| 14 | GOV8-12 | 文档审计脚本 | 新增只读文档审计脚本,检查文档台账字段、核心路径、状态值、链接引用、敏感词和旧口径风险。 | 1) 脚本只读;2) --check-registry 可校验核心台账;3) --help 可用;4) 不打印真实 secret;5) 默认输出摘要。 | 流程级验证:node --check scripts/qa/audit-docs.mjs;node scripts/qa/audit-docs.mjs --help;node scripts/qa/audit-docs.mjs --check-registry。 | node | DONE | DONE | DONE | scripts/qa/audit-docs.mjs | ["GOV8-2"] | 脚本用于治理门禁;后续可在 QAOPS8 中扩展。 |
| 15 | GOV8-13 | 旧口径和敏感词审计 | 用文档审计脚本和 rg 扫描旧口径、TODO、未部署、尚未完成、密钥和敏感词风险。 | 1) 风险输出可解释;2) 不把历史证据误判为当前缺口;3) 不泄露密钥;4) 发现阻断风险时记录到 GOV8 后续行。 | 流程级验证:node scripts/qa/audit-docs.mjs;rg -n 'TODO|未部署|尚未完成|secret|token|密码|密钥' docs issues scripts/qa。 | node|rg | DONE | DONE | DONE | docs|issues|scripts/qa | ["GOV8-12"] | rg 命中可能包含规则说明,需人工解释。 |
| 16 | GOV8-14 | 链接和路径审计 | 用文档审计脚本检查 Markdown 链接指向的本地 .md/.csv 路径是否存在。 | 1) 相对链接可解析;2) 绝对仓库链接可解释;3) 外部链接不误报;4) 断链进入后续修复行。 | 流程级验证:node scripts/qa/audit-docs.mjs --check-links。 | node | DONE | DONE | DONE | scripts/qa/audit-docs.mjs|docs | ["GOV8-12"] | 脚本先覆盖 docs 下 Markdown 文档链接。 |
| 17 | GOV8-15 | 当前执行合同索引规则 | 固定当前活跃治理流入口,只在文档索引和状态矩阵列当前活跃连续合同,历史合同通过 README 和 git 历史追溯。 | 1) 当前活跃治理流表存在;2) GOV8 为当前活跃治理流;3) 未来 R7E/ORG8/WF8/BIZ8/QAOPS8 有规划入口;4) 旧 Issue 不在主入口铺开。 | 流程级验证:rg -n '当前活跃治理流|GOV8|R7E|ORG8|WF8|BIZ8|QAOPS8|历史合同' docs/文档索引.md docs/文档事实源状态矩阵.md issues/README.md。 | rg | DONE | DONE | DONE | docs/文档索引.md|docs/文档事实源状态矩阵.md|issues/README.md | ["GOV8-4"] | 减少 Issue 文件膨胀后的入口噪声。 |
| 18 | GOV8-16 | 历史 Issue 降级规则 | 固定旧 Issue CSV 的处理规则:不删除、不回写、不归档目录,只通过新合同 Notes 或索引说明 supersedes。 | 1) 规则写入索引、状态矩阵或 README;2) 明确旧 Issue 是审计历史;3) supersedes 只写在新合同或索引;4) 不移动旧文件。 | 流程级验证:rg -n 'supersedes|不删除|不回写|历史审计|旧 Issue' docs/文档索引.md docs/文档事实源状态矩阵.md issues/README.md。 | rg | DONE | DONE | DONE | docs/文档索引.md|docs/文档事实源状态矩阵.md|issues/README.md | ["GOV8-15"] | 保持 git 历史和审计语义。 |
| 19 | GOV8-17 | 治理试运行 | 用 GOV8 本身试运行连续型 Issue 流程,验证一个治理流承载多行任务、状态回填和阶段收口是否可行。 | 1) GOV8 CSV 承载 18 行以上任务;2) 文档/脚本变更归入同一合同;3) 校验命令可执行;4) 不额外开小 CSV。 | 流程级验证:读取 GOV8 CSV 行数;validate_issues_csv.py 本 CSV;人工确认本轮无额外治理 CSV。 | python3|manual | DONE | DONE | DONE | issues/2026-05-13_16-31-09-gov8-system-governance.csv | ["GOV8-0"] | 本轮即为治理试运行。 |
| 20 | GOV8-18 | GOV8 回归与状态回填 | 执行 GOV8 所有文档、CSV 和脚本校验,根据实测结果回填状态。 | 1) CSV 校验通过;2) audit-docs 关键模式通过;3) rg 关键规则命中;4) git diff --check 通过;5) 状态按证据回填。 | 流程级验证:validate_issues_csv.py 本 CSV;node --check scripts/qa/audit-docs.mjs;node scripts/qa/audit-docs.mjs --check-registry;node scripts/qa/audit-docs.mjs --check-links;git diff --check。 | python3|node|git | DONE | DONE | DONE | issues/2026-05-13_16-31-09-gov8-system-governance.csv|docs|scripts/qa | ["GOV8-13","GOV8-14","GOV8-17"] | 回归失败不得标 DONE。 |
| 21 | GOV8-19 | GOV8 收口报告 | 输出 GOV8 变更摘要、验证结果、残留风险和后续连续治理流建议。 | 1) 最终回复说明改了什么;2) 说明验证命令和结果;3) 说明未部署;4) 指出下一步 R7E/ORG8/QAOPS8 入口;5) 如提交则引用 GOV8。 | 流程级验证:最终交付说明包含变更摘要、验证结果、部署状态和后续建议。 | manual | DONE | DONE | DONE | N/A | ["GOV8-18"] | 本轮面向用户的收口报告;不要求部署。 |