shop_helm/docs/tasks/README.md

多 agent 一任务一文件

当前默认使用 ../06-tasks.md 单文件看板。只有多个 agent 或人/agent 并发开发时才切换本模式。

切换规则

1. 把 docs/06-tasks.md 冻结为已存在任务的索引，不再并发修改任务行。
2. 新任务在本目录使用 T-<编号>.md。
3. 每个 agent 只编辑自己领取的任务文件和该任务必要的代码。
4. 执行记录写入任务文件，不逐任务抢改共享 progress.md 和 current-state.md。
5. 阶段性汇总由单一协调者更新共享文件。

文件名和编号

• 文件名：T-101.md，细分任务可用 T-101a.md。
• 新编号取 06-tasks.md 与本目录现有任务最大编号加一。
• 目标文件存在时换下一个编号，不覆盖。
• _template.md 不参与编号。

Frontmatter

---
id: T-XXX
title: 一句话任务名
phase: 1
deps: []
status: TODO
created: YYYY-MM-DD
owner:
---

状态只允许 TODO、DOING、DONE、BLOCKED。

领取

• 选择编号最小且依赖全 DONE 的 TODO。
• 设置 owner 和 DOING 后再开始。
• 同一 agent 一次只领取一个。
• 发现已有 owner 或状态刚变化时不得覆盖，重新选择任务。

完成

• 在任务文件记录变更、真实命令、结果、手工 smoke、决策和残余风险。
• 全部验收通过后改为 DONE。
• 验证失败时保持 DOING；确有外部决策阻塞时标 BLOCKED 并写清恢复条件。
• 不以“代码已写”代替证据。

流程和安全规则的唯一权威源仍是 ../../AGENTS.md。用户使用 grill me: 时只做反方评审，不自动建立或实现任务。