- commit
- 7c9f009
- parent
- e62e98d
- author
- im_wower
- date
- 2026-03-25 00:12:42 +0800 CST
chore: align task docs format
7 files changed,
+182,
-231
+7,
-47
1@@ -1,20 +1,3 @@
2----
3-task_id: T-S001
4-title: 修复 codexd turn 完成状态
5-status: todo
6-branch: fix/codexd-turn-completion-state
7-repo: /Users/george/code/baa-conductor
8-base_ref: main@803c895
9-depends_on: []
10-write_scope:
11- - apps/codexd/**
12- - packages/codex-app-server/**
13- - docs/runtime/codexd.md
14- - bugs/BUG-008-codexd-second-thread-turn-timeout.md
15- - bugs/BUG-010-codexd-turn-status-stuck-inprogress.md
16-updated_at: 2026-03-24
17----
18-
19 # Task T-S001：修复 codexd turn 完成状态
20
21 ## 直接给对话的提示词
22@@ -30,6 +13,13 @@ updated_at: 2026-03-24
23 - `/Users/george/code/baa-conductor/apps/codexd/src/index.test.js`
24 - `/Users/george/code/baa-conductor/docs/runtime/codexd.md`
25
26+## 当前基线
27+
28+- 仓库：`/Users/george/code/baa-conductor`
29+- 分支：`main`
30+- 提交：`e62e98d`
31+- 开工要求：不要从其他任务分支切出；如需新分支，从当前 `main` 新切
32+
33 ## 建议分支名
34
35 - `fix/codexd-turn-completion-state`
36@@ -127,33 +117,3 @@ updated_at: 2026-03-24
37 - 修复点落在哪些 lifecycle / transport / session 状态逻辑
38 - 跑了哪些测试
39 - `BUG-008`、`BUG-010` 现在各自状态
40-
41-## 更新要求
42-
43-开始时更新 frontmatter 的：
44-
45-- `status`
46-- `base_ref`
47-- `updated_at`
48-
49-完成后补充下面这些内容：
50-
51-## files_changed
52-
53-- 待完成
54-
55-## commands_run
56-
57-- 待完成
58-
59-## result
60-
61-- 待完成
62-
63-## risks
64-
65-- 待完成
66-
67-## next_handoff
68-
69-- 待完成
+7,
-46
1@@ -1,19 +1,3 @@
2----
3-task_id: T-S002
4-title: 清理 control-api-worker 残留与坏测试
5-status: todo
6-branch: chore/remove-control-api-worker-residuals
7-repo: /Users/george/code/baa-conductor
8-base_ref: main@803c895
9-depends_on: []
10-write_scope:
11- - apps/control-api-worker/**
12- - tests/control-api/**
13- - ops/cloudflare/**
14- - scripts/cloudflare/**
15-updated_at: 2026-03-24
16----
17-
18 # Task T-S002：清理 control-api-worker 残留与坏测试
19
20 ## 直接给对话的提示词
21@@ -30,6 +14,13 @@ updated_at: 2026-03-24
22 - `/Users/george/code/baa-conductor/scripts/cloudflare/prepare-control-api-local-db.mjs`
23 - `/Users/george/code/baa-conductor/README.md`
24
25+## 当前基线
26+
27+- 仓库：`/Users/george/code/baa-conductor`
28+- 分支：`main`
29+- 提交：`e62e98d`
30+- 开工要求：不要从其他任务分支切出；如需新分支，从当前 `main` 新切
31+
32 ## 建议分支名
33
34 - `chore/remove-control-api-worker-residuals`
35@@ -126,33 +117,3 @@ updated_at: 2026-03-24
36 - `tests/control-api` 最终是修复、替换还是删除
37 - 跑了哪些验证
38 - 还保留了哪些兼容件
39-
40-## 更新要求
41-
42-开始时更新 frontmatter 的：
43-
44-- `status`
45-- `base_ref`
46-- `updated_at`
47-
48-完成后补充下面这些内容：
49-
50-## files_changed
51-
52-- 待完成
53-
54-## commands_run
55-
56-- 待完成
57-
58-## result
59-
60-- 待完成
61-
62-## risks
63-
64-- 待完成
65-
66-## next_handoff
67-
68-- 待完成
+7,
-47
1@@ -1,20 +1,3 @@
2----
3-task_id: T-S003
4-title: 切换 status-api 到 conductor 主接口
5-status: todo
6-branch: feat/status-api-local-truth-cutover
7-repo: /Users/george/code/baa-conductor
8-base_ref: main@803c895
9-depends_on: []
10-write_scope:
11- - apps/status-api/**
12- - scripts/runtime/**
13- - ops/launchd/**
14- - docs/runtime/**
15- - docs/api/README.md
16-updated_at: 2026-03-24
17----
18-
19 # Task T-S003：切换 status-api 到 conductor 主接口
20
21 ## 直接给对话的提示词
22@@ -32,6 +15,13 @@ updated_at: 2026-03-24
23 - `/Users/george/code/baa-conductor/ops/launchd/so.makefile.baa-status-api.plist`
24 - `/Users/george/code/baa-conductor/docs/api/README.md`
25
26+## 当前基线
27+
28+- 仓库：`/Users/george/code/baa-conductor`
29+- 分支：`main`
30+- 提交：`e62e98d`
31+- 开工要求：不要从其他任务分支切出；如需新分支，从当前 `main` 新切
32+
33 ## 建议分支名
34
35 - `feat/status-api-local-truth-cutover`
36@@ -129,33 +119,3 @@ updated_at: 2026-03-24
37 - 哪些地方仍保留 `BAA_CONTROL_API_BASE` 兼容入口
38 - 跑了哪些验证
39 - 还有哪些 legacy 没清完
40-
41-## 更新要求
42-
43-开始时更新 frontmatter 的：
44-
45-- `status`
46-- `base_ref`
47-- `updated_at`
48-
49-完成后补充下面这些内容：
50-
51-## files_changed
52-
53-- 待完成
54-
55-## commands_run
56-
57-- 待完成
58-
59-## result
60-
61-- 待完成
62-
63-## risks
64-
65-- 待完成
66-
67-## next_handoff
68-
69-- 待完成
+7,
-15
1@@ -1,18 +1,3 @@
2----
3-task_id: T-S004
4-title: 修复 conductor-daemon 测试 listener 泄漏
5-status: todo
6-branch: fix/conductor-daemon-test-listener-leak
7-repo: /Users/george/code/baa-conductor
8-base_ref: main@803c895
9-depends_on: []
10-write_scope:
11- - apps/conductor-daemon/src/index.test.js
12- - apps/conductor-daemon/src/index.ts
13- - bugs/BUG-009-conductor-daemon-index-test-leaks-local-listener.md
14-updated_at: 2026-03-24
15----
16-
17 # Task T-S004：修复 conductor-daemon 测试 listener 泄漏
18
19 ## 直接给对话的提示词
20@@ -25,6 +10,13 @@ updated_at: 2026-03-24
21 - `/Users/george/code/baa-conductor/apps/conductor-daemon/src/index.test.js`
22 - `/Users/george/code/baa-conductor/apps/conductor-daemon/src/index.ts`
23
24+## 当前基线
25+
26+- 仓库：`/Users/george/code/baa-conductor`
27+- 分支：`main`
28+- 提交：`e62e98d`
29+- 开工要求：不要从其他任务分支切出；如需新分支，从当前 `main` 新切
30+
31 ## 建议分支名
32
33 - `fix/conductor-daemon-test-listener-leak`
+10,
-2
1@@ -9,6 +9,7 @@
2 - `control-api.makefile.so`、Cloudflare Worker、D1 只剩迁移期兼容残留
3 - `baa-hand` / `baa-shell` 只保留为接口语义参考，不再作为主系统维护
4 - 当前任务卡都放在本目录
5+- 当前任务基线：`main@e62e98d`
6
7 ## 当前活动任务
8
9@@ -23,7 +24,13 @@
10
11 - `T-S001`、`T-S002` 优先，且可以并行
12 - `T-S003`、`T-S004` 也可以并行，但优先级略低于前两项
13-- 新任务继续按 `write_scope` 尽量拆成零重叠目录
14+- 新任务继续按“允许修改的目录”尽量拆成零重叠范围
15+
16+## 任务文档约定
17+
18+- 任务卡统一使用纯 Markdown 结构，不再使用 frontmatter
19+- 每张任务卡都要写清当前基线、建议分支名、允许修改目录和验收命令
20+- 新任务优先参考 [`task-doc-template.md`](./task-doc-template.md)
21
22 ## 现在该读什么
23
24@@ -40,5 +47,6 @@
25 - 所有新任务默认以 `100.71.210.78:4317` 和 `conductor.makefile.so` 为 canonical 接口面
26 - `control-api.makefile.so` 只允许作为删旧前的兼容背景出现
27 - 当前任务编号继续使用 `T-S***`
28-- 能并行的任务优先拆开，并明确写清 `write_scope`
29+- 能并行的任务优先拆开，并明确写清允许修改的目录
30+- 新任务文档结构参考 [`task-doc-template.md`](./task-doc-template.md)
31 - 不再恢复旧 wave 文档；历史内容继续靠 tag `ha-failover-archive-2026-03-22` 回溯
+0,
-74
1@@ -1,74 +0,0 @@
2----
3-task_id: T-XXX
4-title: 任务标题
5-status: todo
6-branch: feat/T-XXX-short-name
7-repo: /Users/george/code/baa-conductor
8-base_ref: main
9-depends_on: []
10-write_scope: []
11-updated_at: 2026-03-21
12----
13-
14-# 任务标题
15-
16-## 目标
17-
18-TODO
19-
20-## 本任务包含
21-
22-- TODO
23-
24-## 本任务不包含
25-
26-- TODO
27-
28-## 建议起始文件
29-
30-- TODO
31-
32-## 交付物
33-
34-- TODO
35-
36-## 验收
37-
38-- TODO
39-
40-## 更新要求
41-
42-完成时更新 frontmatter 的：
43-
44-- `status`
45-- `base_ref`
46-- `updated_at`
47-
48-并补充下面这些内容：
49-
50-## files_changed
51-
52-- TODO
53-
54-## commands_run
55-
56-- TODO
57-
58-## result
59-
60-- TODO
61-
62-## risks
63-
64-- TODO
65-
66-## next_handoff
67-
68-- TODO
69-
70-开始时建议直接把 `status` 改为 `in_progress`。
71-
72-做完并推送后：
73-
74-- 如果等待整合，改为 `review`
75-- 如果确认结束，改为 `done`
+144,
-0
1@@ -0,0 +1,144 @@
2+# baa-conductor 任务文档模板
3+
4+## 用途
5+
6+这个模板用于给 `baa-conductor` 新建任务文档。
7+
8+目标：
9+
10+- 给新对话一条可以直接复制的提示词
11+- 把当前基线、写入范围、验收标准写清楚
12+- 尽量减少并行任务之间的改动冲突
13+
14+## 使用方式
15+
16+如果是“帮我创建新的任务文档”，先读这个模板，再按当前需求生成任务 `md`。
17+
18+推荐提示词：
19+
20+- `读 /Users/george/code/baa-conductor/tasks/task-doc-template.md 任务模板，按当前需求创建新的任务 md 文档。`
21+
22+如果是“按某个任务文档开始开发”，推荐提示词：
23+
24+- `读 /Users/george/code/baa-conductor/tasks/T-S001.md 任务文档，完成开发任务。`
25+
26+## 编写规则
27+
28+- 路径一律写绝对路径
29+- 任务文档统一放在 `/Users/george/code/baa-conductor/tasks/`
30+- 当前基线要写明 `main` 和具体提交
31+- 能并行的任务优先拆开，并明确写清 `允许修改的目录`
32+- 不要把背景、实现边界、验收标准混成一段
33+- 验收标准必须能直接检查，不要只写“功能正常”
34+- 如果有明确边界，不要只写“参考现有实现”，要写“尽量不要修改哪些目录”
35+
36+## 模板正文
37+
38+下面是可直接复制的结构。生成新任务时，把尖括号占位内容替换掉即可。
39+
40+```md
41+# Task <编号>：<任务标题>
42+
43+## 直接给对话的提示词
44+
45+读 `</Users/george/code/baa-conductor/tasks/当前任务文档.md>` 任务文档，完成开发任务。
46+
47+如需补背景，再读：
48+
49+- `</绝对路径/背景文件1.md>`
50+- `</绝对路径/背景文件2.md>`
51+
52+## 当前基线
53+
54+- 仓库：`/Users/george/code/baa-conductor`
55+- 分支：`main`
56+- 提交：`<当前 main 提交>`
57+- 开工要求：不要从其他任务分支切出；如需新分支，从当前 `main` 新切
58+
59+## 建议分支名
60+
61+- `<type>/<short-branch-name>`
62+
63+## 目标
64+
65+<一句话说明这个任务要完成什么>
66+
67+## 背景
68+
69+<说明为什么要做这个任务，当前问题是什么>
70+
71+## 涉及仓库
72+
73+- `/Users/george/code/baa-conductor`
74+
75+## 范围
76+
77+- <任务范围 1>
78+- <任务范围 2>
79+- <任务范围 3>
80+
81+## 路径约束
82+
83+<如果有固定目录、接口、脚本或文档边界，在这里写清楚>
84+
85+## 推荐实现边界
86+
87+建议优先做：
88+
89+- <实现点 1>
90+- <实现点 2>
91+
92+## 允许修改的目录
93+
94+- `</绝对路径/目录1/>`
95+- `</绝对路径/目录2/>`
96+
97+## 尽量不要修改
98+
99+- `</绝对路径/目录或文件1>`
100+- `</绝对路径/目录或文件2>`
101+
102+## 必须完成
103+
104+### 1. <子目标 1>
105+
106+- <要求 1>
107+- <要求 2>
108+
109+### 2. <子目标 2>
110+
111+- <要求 1>
112+- <要求 2>
113+
114+### 3. <子目标 3>
115+
116+- <要求 1>
117+- <要求 2>
118+
119+## 需要特别注意
120+
121+- <兼容性约束>
122+- <不要破坏的旧行为>
123+- <本任务和其他并行任务的边界>
124+
125+## 验收标准
126+
127+- <可验证结果 1>
128+- <可验证结果 2>
129+- <可验证结果 3>
130+
131+## 推荐验证命令
132+
133+- `<命令 1>`
134+- `<命令 2>`
135+- `<命令 3>`
136+
137+## 交付要求
138+
139+完成后请说明：
140+
141+- 修改了哪些文件
142+- 核心实现思路是什么
143+- 跑了哪些测试
144+- 还有哪些剩余风险
145+```