Define multi-agent download workflow (T-301)

This commit is contained in:
ila
2026-07-16 18:48:15 +08:00
parent a52acbf926
commit 2d302b731a
5 changed files with 108 additions and 5 deletions
+16
View File
@@ -53,6 +53,22 @@ write_paths: # 允许修改的仓库相对路径
- **执行记录写进本任务文件的 `## 执行记录` 一节**(改了什么、跑了什么验证、结果、决策)——不逐任务追加共享的 `progress.md`(可选历史归档)、也不逐任务覆盖 `current-state.md`(项目级快照,只在启动/验证路径、目录结构或 blocker 变化时更新)。
- **只改自己那个任务文件**;不要编辑别人正在做的任务文件。
### 同一任务的多 Agent 模式
当任务本身不能安全拆成互不依赖的写路径时,使用“单写入者 + 多只读审查者”:
1. coordinator 先落成任务文件并提交,明确唯一写入 Agent、只读测试 Agent、只读安全/架构 Agent。
2. 写入 Agent 独占任务 `write_paths`;只读 Agent 不调用文件编辑、`git add`、`git commit` 或会改变仓库状态的命令。
3. 只读 Agent 返回可复现的测试矩阵、风险和审查意见;coordinator 决定是否采纳并由唯一写入者或 coordinator 修改。
4. 所有意见合并后由 coordinator 跑任务完整闸门、更新执行记录并创建唯一任务提交。
若要让多个 Agent 并行写代码,必须先:
- 拆成带后缀的独立任务文件(如 `T-301a.md` / `T-301b.md`)。
- 先完成并提交共享接口/协议冻结任务。
- 确保依赖均 DONE,且 `write_paths` 互不重叠、没有目录前缀包含关系。
- 每个子任务独立状态、验证证据和 Git 提交;最后另设串行集成任务。
未启用 Gitea 时,在独立分支 / worktree 中把任务文件从 `TODO` 改为 `DOING` 即可。启用 Gitea 时,必须先按 [`../gitea-collaboration.md`](../gitea-collaboration.md) 由 dispatcher 串行分配并创建 `claims/T-<编号>` 防御性标记;assignee、标签、读回和普通 create-branch API 都不能单独提供并发互斥。
## 与 Gitea Issue / PR 的映射(可选)