chore: 建立 AGENTS 与 Issue CSV 执行合同基线

issues/README.md

@@ -0,0 +1,45 @@
+# 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 编码。