docs: add one-task-per-file convention for multi-agent concurrency

多个 agent 并发时抢改单一看板/进度文件会导致读到旧版本、ID 撞号、合并冲突。
新增 docs/tasks/(README 约定 + _template):一任务一文件、frontmatter、防撞号、
执行记录写进任务文件、不逐任务改共享收尾文件。method-map 增对应失败模式行;
06-tasks/00-ai-start-here 加多 agent 分支;README/docs/README 登记;tasks.md 记 H-407。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
chengma
2026-07-08 15:00:07 +08:00
co-authored by Claude Opus 4.8
parent 791211363e
commit ef288b0021
8 changed files with 90 additions and 2 deletions
+2
View File
@@ -12,6 +12,8 @@
6. **动手前**先读 `00-ai-start-here.md`、`05-coding-rules.md` 和 `current-state.md`。
7. **完成后**把任务状态同步到本文,把执行记录追加到 [`../progress.md`](../progress.md),覆盖更新 [`current-state.md`](current-state.md),并过一遍 [`clean-state-checklist.md`](clean-state-checklist.md)。
> **多 agent / 并发协作**:当多个 agent(或人 + agent)并发在同一仓库工作时,单文件看板会被抢改(读到旧版本、ID 撞号、合并冲突)。此时改用 **一任务一文件** [`tasks/README.md`](tasks/README.md)(`docs/tasks/T-<编号>.md`):新任务只进 `docs/tasks/`、执行记录写进各自任务文件的 `## 执行记录`、不再逐任务追加 `progress.md`/覆盖 `current-state.md`;本单文件看板转为历史归档。单 agent / 小项目继续用本文即可。
如新项目希望任务看板放在根目录,可把本文复制或改名为根目录 `tasks.md`,并同步更新 `README.md`、`docs/README.md`、`00-ai-start-here.md` 和 `current-state.md` 的链接。
## 状态图例