46 行
1.2 KiB
Markdown
46 行
1.2 KiB
Markdown
# 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 编码。
|