51 lines
1.7 KiB
Markdown
51 lines
1.7 KiB
Markdown
# 多 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:` 时只做反方评审，不自动建立或实现任务。
|