1.7 KiB
1.7 KiB
任务上下文模板
每张任务卡只允许一个主要行为变化或一个证据变化。卡片上限 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>；不要写“相关代码”或整目录。
范围
- 做：
- 不做：
验收
<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 的成功证据。