52 lines
1.7 KiB
Markdown
52 lines
1.7 KiB
Markdown
# 任务上下文模板
|
||
|
||
每张任务卡只允许一个主要行为变化或一个证据变化。卡片上限 8 KiB，最多 12 个输入路径和 8 条命令；实现细节放在代码和测试中，
|
||
运行结果放在 `docs/status/<task>.md`，不要在任务卡复制长日志。机器生成 gap 也必须有同样的短卡；
|
||
catalog 只供工具随机读取，不替代任务卡，也不应被执行者通读。
|
||
|
||
不要在任务卡引用 `next-task-plan.json`、完整路线图、全量 status 或 `test-results/`；需要背景时只
|
||
点名一个稳定契约的小节。
|
||
|
||
## 任务
|
||
|
||
- `task`: `<ID>`
|
||
- `parent`: `<parent ID>`
|
||
- `status`: `pending | in_progress | done | blocked`
|
||
|
||
## 目标
|
||
|
||
一句话描述唯一可观察变化，以及明确不改变的状态轴。
|
||
|
||
## 输入
|
||
|
||
- 上一个 manifest：`tests/golden/<parent>/manifest.json`
|
||
- 最小 fixture：`<fixture path or NOT_APPLICABLE>`
|
||
- 生产入口：`<single source/test/checker path>`；不要写“相关代码”或整目录。
|
||
|
||
## 范围
|
||
|
||
- 做：
|
||
- 不做：
|
||
|
||
## 验收
|
||
|
||
```text
|
||
<focused command>
|
||
```
|
||
|
||
至少列出一个负例、取消、重复或预算超限场景；不要把全量回归命令复制到卡片。
|
||
|
||
适用时补充 Node、Chromium、typecheck、lint；每条命令必须真实运行并记录退出码。
|
||
|
||
## 产物和交接
|
||
|
||
- 报告：`tests/golden/<task>/...`
|
||
- 状态页：`docs/status/<task>.md`
|
||
- manifest：`tests/golden/<task>/manifest.json`
|
||
- 下一任务：由 manifest 的 `nextTask` 决定
|
||
|
||
## 回滚
|
||
|
||
删除本任务新增的生产入口、测试、报告、manifest、package 命令和状态页，并将 parent manifest
|
||
恢复为队列尾；不得删除或改写 parent 的成功证据。
|