# 多 agent 一任务一文件

> 当前默认使用 [`../06-tasks.md`](../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

```yaml
---
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`](../../AGENTS.md)。用户使用 `grill me:` 时只做反方评审，不自动建立或实现任务。