hyb-oa/issues/README.md

Issue CSV 规则（hyb-oa）

本项目使用 Issue 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 编码。

权威读取顺序

• 当前执行合同：优先查看时间最新且已批准的 issues/*.csv；当前治理收口入口为 2026-05-05_20-01-18-r90-r91-trialrun-closeout.csv。
• 历史蓝图链：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 判断系统状态。
• 跨文档事实源：业务能力现状优先结合 feature-matrix.md、coverage-matrix.csv 和 manual-trialrun-report.md 阅读。

历史合同处理原则

• 不批量回改旧 CSV 的 TODO/DOING/DONE 来伪造一致性。
• 若后续合同替代前一版合同，在新合同或索引文档里补“superseded / authoritative”说明。
• 需要做全局状态判断时，以最新合同、覆盖矩阵和试运行报告交叉验证，不以单个旧 CSV 为准。