文件
hyb-oa/issues/2026-05-13_16-31-09-gov8-system-governance.csv
T

12 KiB

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