baa-conductor

git clone 

commit
e4bbe2e
parent
8eb6ff1
author
im_wower
date
2026-03-21 19:25:30 +0800 CST
Simplify task status workflow
16 files changed,  +60, -43
M coordination/STATUS_SUMMARY.md
+6, -0
 1@@ -41,3 +41,9 @@
 2 - 当前进行中任务
 3 - 阻塞原因
 4 - 下一波建议分发
 5+
 6+当前阶段不要求记录具体实例名,只看:
 7+
 8+- 哪个 task 已开始
 9+- 哪个 task 已完成
10+- 哪个 task 被阻塞
M coordination/TASK_OVERVIEW.md
+3, -0
 1@@ -14,6 +14,7 @@
 2 
 3 - `T-001` 视为已完成
 4 - 其他任务可以在当前骨架上并行开展
 5+- 当前阶段不强制记录实例名,只要求各任务卡状态及时更新
 6 
 7 ## 2. 启动前必读
 8 
 9@@ -68,3 +69,5 @@
10 - 每个任务的详细状态在对应任务卡中
11 - 全局汇总在 [`STATUS_SUMMARY.md`](./STATUS_SUMMARY.md)
12 - 如需新任务,按现有模板新增到 `coordination/tasks/`
13+- 开始做任务时,Codex 自己把任务卡改成 `in_progress`
14+- 做完并推送后,Codex 自己把任务卡改成 `review` 或 `done`
M coordination/WORKFLOW.md
+35, -7
 1@@ -13,7 +13,6 @@
 2 ## 2. 每个实例开始前要做什么
 3 
 4 1. 在自己的任务卡里填写或更新:
 5-   - `owner`
 6    - `status`
 7    - `base_ref`
 8    - `updated_at`
 9@@ -77,12 +76,41 @@ git worktree add ../baa-conductor-T004 -b feat/T-004-conductor-lease main
10 - `review`
11 - `done`
12 
13-## 8. 当前 owner 字段约定
14+推荐最小规则:
15 
16-`owner` 建议使用稳定字符串,例如:
17+- 开始时:`todo -> in_progress`
18+- 遇阻塞时:改成 `blocked`
19+- 代码完成并已提交推送时:改成 `review`
20+- 整合确认完成后:改成 `done`
21 
22-- `codex-mini-01`
23-- `codex-mac-02`
24-- `claude-dispatch`
25-- `main-rollout`
26+## 8. 不再强制记录实例名
27 
28+为降低协作成本,当前阶段不强制记录:
29+
30+- `owner`
31+- 实例编号
32+- 长进度日志
33+
34+默认假设:
35+
36+- 任务由整合者明确分配
37+- 谁拿到任务,谁就改自己的任务卡状态
38+- 分支名和 commit 已足够定位该任务的实际执行者
39+
40+## 9. 当前最小回写要求
41+
42+开始时最少改这几个字段:
43+
44+- `status`
45+- `base_ref`
46+- `updated_at`
47+
48+结束时最少补这些内容:
49+
50+- `status`
51+- `updated_at`
52+- `files_changed`
53+- `commands_run`
54+- `result`
55+- `risks`
56+- `next_handoff`
M coordination/tasks/T-001-repo-scaffold.md
+1, -3
 1@@ -2,7 +2,6 @@
 2 task_id: T-001
 3 title: 仓库骨架
 4 status: done
 5-owner: main-rollout
 6 branch: feat/T-001-repo-scaffold
 7 repo: /Users/george/code/baa-conductor
 8 base_ref: main
 9@@ -81,9 +80,8 @@ updated_at: 2026-03-21
10 
11 - 开始分发第一波并行任务
12 
13-## progress_log
14+## notes
15 
16 - `2026-03-21`: 初始化新仓库
17 - `2026-03-21`: 写入设计文档
18 - `2026-03-21`: 创建代码骨架与协作文档结构
19-
M coordination/tasks/T-002-d1-schema.md
+1, -3
 1@@ -2,7 +2,6 @@
 2 task_id: T-002
 3 title: D1 Schema 与 Migrations
 4 status: todo
 5-owner: unassigned
 6 branch: feat/T-002-d1-schema
 7 repo: /Users/george/code/baa-conductor
 8 base_ref: main
 9@@ -79,7 +78,6 @@ updated_at: 2026-03-21
10 
11 - 给 `T-003` 和 `T-004` 提供稳定的数据模型基线
12 
13-## progress_log
14+## notes
15 
16 - `2026-03-21`: 创建任务卡
17-
M coordination/tasks/T-003-control-api.md
+1, -3
 1@@ -2,7 +2,6 @@
 2 task_id: T-003
 3 title: Control API Worker
 4 status: todo
 5-owner: unassigned
 6 branch: feat/T-003-control-api
 7 repo: /Users/george/code/baa-conductor
 8 base_ref: main
 9@@ -67,7 +66,6 @@ updated_at: 2026-03-21
10 
11 - 供 `T-004` 和 `T-010` 接入
12 
13-## progress_log
14+## notes
15 
16 - `2026-03-21`: 创建任务卡
17-
M coordination/tasks/T-004-conductor-lease.md
+1, -3
 1@@ -2,7 +2,6 @@
 2 task_id: T-004
 3 title: Conductor Lease 与 Heartbeat
 4 status: todo
 5-owner: unassigned
 6 branch: feat/T-004-conductor-lease
 7 repo: /Users/george/code/baa-conductor
 8 base_ref: main
 9@@ -71,7 +70,6 @@ updated_at: 2026-03-21
10 
11 - 给后续 scheduler 和 status API 提供主备状态基线
12 
13-## progress_log
14+## notes
15 
16 - `2026-03-21`: 创建任务卡
17-
M coordination/tasks/T-005-worker-runner.md
+1, -3
 1@@ -2,7 +2,6 @@
 2 task_id: T-005
 3 title: Worker Runner 与本地日志流
 4 status: todo
 5-owner: unassigned
 6 branch: feat/T-005-worker-runner
 7 repo: /Users/george/code/baa-conductor
 8 base_ref: main
 9@@ -68,7 +67,6 @@ updated_at: 2026-03-21
10 
11 - 给 `T-006` 提供 checkpoint 接入点
12 
13-## progress_log
14+## notes
15 
16 - `2026-03-21`: 创建任务卡
17-
M coordination/tasks/T-006-checkpointing.md
+1, -3
 1@@ -2,7 +2,6 @@
 2 task_id: T-006
 3 title: Checkpoint 与 Git Diff Snapshots
 4 status: todo
 5-owner: unassigned
 6 branch: feat/T-006-checkpointing
 7 repo: /Users/george/code/baa-conductor
 8 base_ref: main
 9@@ -68,7 +67,6 @@ updated_at: 2026-03-21
10 
11 - 给 failover 恢复实现提供基础接口
12 
13-## progress_log
14+## notes
15 
16 - `2026-03-21`: 创建任务卡
17-
M coordination/tasks/T-007-planner.md
+1, -3
 1@@ -2,7 +2,6 @@
 2 task_id: T-007
 3 title: Planner 抽象与模板
 4 status: todo
 5-owner: unassigned
 6 branch: feat/T-007-planner
 7 repo: /Users/george/code/baa-conductor
 8 base_ref: main
 9@@ -68,7 +67,6 @@ updated_at: 2026-03-21
10 
11 - 给 conductor 调用 planner 提供稳定接口
12 
13-## progress_log
14+## notes
15 
16 - `2026-03-21`: 创建任务卡
17-
M coordination/tasks/T-008-ops-nginx.md
+1, -2
 1@@ -2,7 +2,6 @@
 2 task_id: T-008
 3 title: Nginx 与 VPS 运维
 4 status: todo
 5-owner: unassigned
 6 branch: feat/T-008-ops-nginx
 7 repo: /Users/george/code/baa-conductor
 8 base_ref: main
 9@@ -72,6 +71,6 @@ updated_at: 2026-03-21
10 
11 - 提供给后续真实部署
12 
13-## progress_log
14+## notes
15 
16 - `2026-03-21`: 创建任务卡
M coordination/tasks/T-009-firefox-pause.md
+1, -2
 1@@ -2,7 +2,6 @@
 2 task_id: T-009
 3 title: Firefox 插件 Pause 与 Resume 协议
 4 status: todo
 5-owner: unassigned
 6 branch: feat/T-009-firefox-pause
 7 repo: /Users/george/code/baa-conductor
 8 base_ref: main
 9@@ -65,6 +64,6 @@ updated_at: 2026-03-21
10 
11 - 给 `baa-firefox` 仓库实现方使用
12 
13-## progress_log
14+## notes
15 
16 - `2026-03-21`: 创建任务卡
M coordination/tasks/T-010-status-api.md
+1, -3
 1@@ -2,7 +2,6 @@
 2 task_id: T-010
 3 title: Status API 与基础 UI
 4 status: todo
 5-owner: unassigned
 6 branch: feat/T-010-status-api
 7 repo: /Users/george/code/baa-conductor
 8 base_ref: main
 9@@ -65,7 +64,6 @@ updated_at: 2026-03-21
10 
11 - 提供给浏览器控制面或 CLI 面板使用
12 
13-## progress_log
14+## notes
15 
16 - `2026-03-21`: 创建任务卡
17-
M coordination/tasks/T-011-launchd-runtime.md
+1, -2
 1@@ -2,7 +2,6 @@
 2 task_id: T-011
 3 title: launchd 与本地 Runtime 布局
 4 status: todo
 5-owner: unassigned
 6 branch: feat/T-011-launchd-runtime
 7 repo: /Users/george/code/baa-conductor
 8 base_ref: main
 9@@ -67,6 +66,6 @@ updated_at: 2026-03-21
10 
11 - 给真实部署阶段使用
12 
13-## progress_log
14+## notes
15 
16 - `2026-03-21`: 创建任务卡
M coordination/tasks/T-012-auth-model.md
+1, -2
 1@@ -2,7 +2,6 @@
 2 task_id: T-012
 3 title: 鉴权与 Token 模型
 4 status: todo
 5-owner: unassigned
 6 branch: feat/T-012-auth-model
 7 repo: /Users/george/code/baa-conductor
 8 base_ref: main
 9@@ -69,6 +68,6 @@ updated_at: 2026-03-21
10 
11 - 给 control API 实现与部署配置使用
12 
13-## progress_log
14+## notes
15 
16 - `2026-03-21`: 创建任务卡
M coordination/tasks/_TEMPLATE.md
+4, -4
 1@@ -2,7 +2,6 @@
 2 task_id: T-XXX
 3 title: 任务标题
 4 status: todo
 5-owner: unassigned
 6 branch: feat/T-XXX-short-name
 7 repo: /Users/george/code/baa-conductor
 8 base_ref: main
 9@@ -42,7 +41,6 @@ TODO
10 完成时更新 frontmatter 的:
11 
12 - `status`
13-- `owner`
14 - `base_ref`
15 - `updated_at`
16 
17@@ -68,7 +66,9 @@ TODO
18 
19 - TODO
20 
21-## progress_log
22+开始时建议直接把 `status` 改为 `in_progress`。
23 
24-- `2026-03-21`: 创建任务卡
25+做完并推送后:
26 
27+- 如果等待整合,改为 `review`
28+- 如果确认结束,改为 `done`