hyb-oa/issues

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	测试、发布、运维和上线准备（当前贯穿治理）

必填列（全部必填）

• ID
• Title
• Description
• Acceptance
• Test_Method
• Tools
• Dev_Status
• Review1_Status
• Regression_Status
• Files
• Dependencies
• Notes

状态值

仅允许：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: none
• Tools: 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 为准。