4.0 KiB
4.0 KiB
Issue CSV 规则(hyb-oa)
本项目使用 Issue CSV 作为需求驱动与执行合同。
连续型 Issue 原则
GOV8 后默认采用“少量长期连续合同 + 多行任务 + 阶段收口”,避免每次聊天、小反馈或单点修正都创建新 CSV。
- 同类型、同目标、同风险域的问题进入同一个连续 CSV。
- 一个连续 CSV 最多承载一个治理流,不混入无关业务域。
- 只有跨业务域、跨风险等级、跨里程碑,或当前治理流阶段性收口后,才新建下一版 CSV。
- 旧 Issue CSV 不删除、不批量回写、不移动到归档目录;它们是历史审计证据。
- 当前可执行合同以
docs/文档索引.md和docs/文档事实源状态矩阵.md标注的“当前活跃治理流”为准。
当前优先治理流:
| 治理流 | 建议/当前文件 | 用途 |
|---|---|---|
GOV8 |
2026-05-13_16-31-09-gov8-system-governance.csv |
文档、流程、Issue 管理和审计治理(已收口) |
R7E |
2026-05-13_17-11-44-r7e-human-trialrun.csv |
真实扩大试运行(当前等待人工确认) |
ORG8 |
待新建连续 CSV | 组织账号和权限主数据 |
WF8 |
待新建连续 CSV | 审批与通知增强 |
BIZ8 |
待新建连续 CSV | 报销/OCR/财务/项目轻量增强 |
QAOPS8 |
待新建连续 CSV | 测试、发布、运维和上线准备 |
必填列(全部必填)
IDTitleDescriptionAcceptanceTest_MethodToolsDev_StatusReview1_StatusRegression_StatusFilesDependenciesNotes
状态值
仅允许:TODO | DOING | DONE
字段规范
ID:唯一标识(如A1、A2)。Acceptance:可判定完成与否。Test_Method:必须可复现(命令或明确步骤)。Tools:优先写实际工具/SDK;不可自动化则写manual。Files:必须给出实际路径范围或哨兵值,不能留空。Dependencies:统一 JSON 数组字符串(不再使用A1|A2)。
哨兵值
Files:N/A | external | TBD | module:<name> | <glob>Dependencies:[]Notes:noneTools:manual | none
Review 与 Regression
Review1_Status:Issue 实现后的单项验证。Regression_Status:全部相关变更合并后的回归验证。
仅在 Test_Method 实测通过后,状态可标记 DONE。
CSV 格式约束
- 字段含英文逗号时,必须用双引号包裹。
- 字段内多值可用
|。 - UTF-8 编码。
权威读取顺序
- 当前执行合同:优先查看
docs/文档索引.md和docs/文档事实源状态矩阵.md标注的当前活跃治理流;不要只按文件时间最新判断。 - 历史蓝图链:P5 相关只把 2026-02-09_13-39-02-p5-blueprint-v3.csv 视为权威完成态;2026-02-09_11-17-07-p5-blueprint.csv 和 2026-02-09_12-34-42-p5-blueprint-v2.csv 保留为历史快照,不再单独作为当前待办来源。
- 试运行链:本地/外部试运行相关优先串读
R70 -> R71 -> R73 -> R74 -> R75 -> R76 -> R77 -> R78 -> R79 -> R80 -> R82 -> R83-R86 -> R87 -> R88 -> R89 -> R90/R91,不要只看单一 CSV 判断系统状态。 - 跨文档事实源:业务能力现状优先结合 历史功能状态矩阵.md、试运行覆盖矩阵.csv 和 人工试运行报告.md 阅读。
历史合同处理原则
- 不批量回改旧 CSV 的
TODO/DOING/DONE来伪造一致性。 - 若后续合同替代前一版合同,在新合同或索引文档里补“superseded / authoritative”说明。
- 需要做全局状态判断时,以最新合同、覆盖矩阵和试运行报告交叉验证,不以单个旧 CSV 为准。