Issue CSV 规则(hyb-oa)
本项目使用 Issue CSV 作为需求驱动与执行合同。
连续型 Issue 原则
GOV8 后默认采用“少量长期连续合同 + 多行任务 + 阶段收口”,避免每次聊天、小反馈或单点修正都创建新 CSV。
- 同类型、同目标、同风险域的问题进入同一个连续 CSV。
- 一个连续 CSV 最多承载一个治理流,不混入无关业务域。
- 只有跨业务域、跨风险等级、跨里程碑,或当前治理流阶段性收口后,才新建下一版 CSV。
- 新反馈进入执行前必须先查当前活跃治理流;同类型反馈优先追加新行或更新 Notes,不因单点修复、试运行反馈、真机反馈或小范围返工新建一次性 CSV。
- 若确需新建 CSV,必须在方案中说明为什么现有活跃流不能承载,例如没有对应治理流、当前流已 CLOSE、涉及跨域高风险变更或用户明确要求新合同。
- 旧 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 |
2026-05-13_18-23-51-org8-master-data-permission.csv |
组织账号和权限主数据(已阶段收口,本地代表性角色验收通过) |
WF8 |
2026-05-13_18-23-52-wf8-approval-notification.csv |
审批与通知增强(待移动审批历史方案批准) |
BIZ8 |
2026-05-13_18-23-53-biz8-finance-ocr-project.csv |
报销/OCR/财务/项目轻量增强(财务台账和项目关联方案已固化,待代码/迁移批准) |
QAOPS8 |
2026-05-13_17-30-00-qaops8-test-release-ops.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 为准。