- commit
- 3bcf667
- parent
- a207f82
- author
- codex@macbookpro
- date
- 2026-03-30 14:42:37 +0800 CST
docs: align task docs with shared template
6 files changed,
+152,
-41
+22,
-1
1@@ -32,12 +32,33 @@
2 1. `cd /Users/george/code/baa-conductor`
3 2. `git worktree add ../baa-conductor-renewal-storage-foundation -b feat/renewal-storage-foundation main`
4 3. `cd ../baa-conductor-renewal-storage-foundation`
5+4. 在这个 worktree 目录里开发，不要回到主仓库目录
6
7 完成后提交与推送：
8
9-1. 在 worktree 里提交所有变更
10+1. 在 worktree 里提交所有变更（包括更新后的任务文档）
11 2. `git push -u origin feat/renewal-storage-foundation`
12
13+合并步骤（由合并者执行）：
14+
15+1. `cd /Users/george/code/baa-conductor`
16+2. `git fetch origin`
17+3. `git merge origin/feat/renewal-storage-foundation`
18+4. `git push`
19+5. `git worktree remove ../baa-conductor-renewal-storage-foundation`（如果 worktree 还在）
20+
21+合并冲突处理：
22+
23+1. 如果 `git merge` 报冲突，先 `git diff` 查看冲突文件
24+2. 手动解决冲突后 `git add` 冲突文件
25+3. `git merge --continue` 完成合并
26+4. 不要用 `git merge --abort` 然后 force 覆盖
27+
28+命名规则：
29+
30+- 功能任务分支名以 `feat/` 开头
31+- 缺陷任务分支名以 `bug/` 开头
32+
33 ## 目标
34
35 为续命系统补齐首版存储基础：本地对话表、对话关联表、续命任务表，以及对应的本地 store 和 D1 同步能力。
+22,
-1
1@@ -32,12 +32,33 @@
2 1. `cd /Users/george/code/baa-conductor`
3 2. `git worktree add ../baa-conductor-renewal-automation-control -b feat/renewal-automation-control main`
4 3. `cd ../baa-conductor-renewal-automation-control`
5+4. 在这个 worktree 目录里开发，不要回到主仓库目录
6
7 完成后提交与推送：
8
9-1. 在 worktree 里提交所有变更
10+1. 在 worktree 里提交所有变更（包括更新后的任务文档）
11 2. `git push -u origin feat/renewal-automation-control`
12
13+合并步骤（由合并者执行）：
14+
15+1. `cd /Users/george/code/baa-conductor`
16+2. `git fetch origin`
17+3. `git merge origin/feat/renewal-automation-control`
18+4. `git push`
19+5. `git worktree remove ../baa-conductor-renewal-automation-control`（如果 worktree 还在）
20+
21+合并冲突处理：
22+
23+1. 如果 `git merge` 报冲突，先 `git diff` 查看冲突文件
24+2. 手动解决冲突后 `git add` 冲突文件
25+3. `git merge --continue` 完成合并
26+4. 不要用 `git merge --abort` 然后 force 覆盖
27+
28+命名规则：
29+
30+- 功能任务分支名以 `feat/` 开头
31+- 缺陷任务分支名以 `bug/` 开头
32+
33 ## 目标
34
35 让 `conductor` 正式持有对话级自动化状态，并维护本地对话与平台对话、浏览器目标、页面路由之间的关联。
+22,
-1
1@@ -32,12 +32,33 @@
2 1. `cd /Users/george/code/baa-conductor`
3 2. `git worktree add ../baa-conductor-timed-jobs-framework -b feat/timed-jobs-framework main`
4 3. `cd ../baa-conductor-timed-jobs-framework`
5+4. 在这个 worktree 目录里开发，不要回到主仓库目录
6
7 完成后提交与推送：
8
9-1. 在 worktree 里提交所有变更
10+1. 在 worktree 里提交所有变更（包括更新后的任务文档）
11 2. `git push -u origin feat/timed-jobs-framework`
12
13+合并步骤（由合并者执行）：
14+
15+1. `cd /Users/george/code/baa-conductor`
16+2. `git fetch origin`
17+3. `git merge origin/feat/timed-jobs-framework`
18+4. `git push`
19+5. `git worktree remove ../baa-conductor-timed-jobs-framework`（如果 worktree 还在）
20+
21+合并冲突处理：
22+
23+1. 如果 `git merge` 报冲突，先 `git diff` 查看冲突文件
24+2. 手动解决冲突后 `git add` 冲突文件
25+3. `git merge --continue` 完成合并
26+4. 不要用 `git merge --abort` 然后 force 覆盖
27+
28+命名规则：
29+
30+- 功能任务分支名以 `feat/` 开头
31+- 缺陷任务分支名以 `bug/` 开头
32+
33 ## 目标
34
35 为续命系统建立独立的定时任务框架，提供 leader-only 周期调度、批量扫描配置和统一外部日志写入能力。
+22,
-1
1@@ -34,12 +34,33 @@
2 1. `cd /Users/george/code/baa-conductor`
3 2. `git worktree add ../baa-conductor-renewal-message-projector -b feat/renewal-message-projector main`
4 3. `cd ../baa-conductor-renewal-message-projector`
5+4. 在这个 worktree 目录里开发，不要回到主仓库目录
6
7 完成后提交与推送：
8
9-1. 在 worktree 里提交所有变更
10+1. 在 worktree 里提交所有变更（包括更新后的任务文档）
11 2. `git push -u origin feat/renewal-message-projector`
12
13+合并步骤（由合并者执行）：
14+
15+1. `cd /Users/george/code/baa-conductor`
16+2. `git fetch origin`
17+3. `git merge origin/feat/renewal-message-projector`
18+4. `git push`
19+5. `git worktree remove ../baa-conductor-renewal-message-projector`（如果 worktree 还在）
20+
21+合并冲突处理：
22+
23+1. 如果 `git merge` 报冲突，先 `git diff` 查看冲突文件
24+2. 手动解决冲突后 `git add` 冲突文件
25+3. `git merge --continue` 完成合并
26+4. 不要用 `git merge --abort` 然后 force 覆盖
27+
28+命名规则：
29+
30+- 功能任务分支名以 `feat/` 开头
31+- 缺陷任务分支名以 `bug/` 开头
32+
33 ## 目标
34
35 实现“消息同步任务”：定时扫描旧消息，按照对话自动化状态和可用路由规则，生成续命任务。
+22,
-1
1@@ -32,12 +32,33 @@
2 1. `cd /Users/george/code/baa-conductor`
3 2. `git worktree add ../baa-conductor-renewal-dispatcher-ops -b feat/renewal-dispatcher-ops main`
4 3. `cd ../baa-conductor-renewal-dispatcher-ops`
5+4. 在这个 worktree 目录里开发，不要回到主仓库目录
6
7 完成后提交与推送：
8
9-1. 在 worktree 里提交所有变更
10+1. 在 worktree 里提交所有变更（包括更新后的任务文档）
11 2. `git push -u origin feat/renewal-dispatcher-ops`
12
13+合并步骤（由合并者执行）：
14+
15+1. `cd /Users/george/code/baa-conductor`
16+2. `git fetch origin`
17+3. `git merge origin/feat/renewal-dispatcher-ops`
18+4. `git push`
19+5. `git worktree remove ../baa-conductor-renewal-dispatcher-ops`（如果 worktree 还在）
20+
21+合并冲突处理：
22+
23+1. 如果 `git merge` 报冲突，先 `git diff` 查看冲突文件
24+2. 手动解决冲突后 `git add` 冲突文件
25+3. `git merge --continue` 完成合并
26+4. 不要用 `git merge --abort` 然后 force 覆盖
27+
28+命名规则：
29+
30+- 功能任务分支名以 `feat/` 开头
31+- 缺陷任务分支名以 `bug/` 开头
32+
33 ## 目标
34
35 实现“续命执行任务”：扫描待执行续命任务，通过浏览器 API 代理发送，并补齐最小运维读接口。
+42,
-36
1@@ -1,43 +1,43 @@
2-# baa-conductor 任务文档模板
3+# 通用任务文档模板
4
5 ## 用途
6
7-这个模板用于给 `baa-conductor` 新建任务文档。
8+这个模板用于在任意代码仓里快速生成新的任务文档。
9+
10+适用场景：
11+
12+- 单仓开发任务
13+- 多仓联动任务
14+- 文档整理任务
15+- 测试与回归任务
16+- 重构或迁移任务
17
18 目标：
19
20 - 给新对话一条可以直接复制的提示词
21-- 把当前基线、写入范围、验收标准写清楚
22+- 把边界、写入范围、验收标准写清楚
23 - 每个任务强制使用独立分支和 worktree，避免代码冲突
24 - AI 在执行过程中主动更新任务文档状态
25
26 ## 使用方式
27
28-如果是"帮我创建新的任务文档"，先读这个模板，再按当前需求生成任务 `md`。
29+新对话如果是"帮我创建任务文档"，可以先读这个模板，再按当前需求生成新的任务 `md`。
30
31 推荐提示词：
32
33-- `读 /Users/george/code/baa-conductor/tasks/task-doc-template.md 任务模板，按当前需求创建新的任务 md 文档。`
34+- `读 </绝对路径/任务文档模板.md> 任务模板，按当前需求创建新的任务 md 文档。`
35
36 如果是"按某个任务文档开始开发"，推荐提示词：
37
38-- `读 /Users/george/code/baa-conductor/tasks/<当前任务文档>.md 任务文档，完成开发任务。`
39+- `读 /绝对路径/某个任务文档.md 任务文档，完成开发任务。`
40
41-## 编写规则
42+任务文档本身建议放在项目内固定位置，例如：
43
44-- 路径一律写绝对路径
45-- 任务文档统一放在 `/Users/george/code/baa-conductor/tasks/`
46-- 当前基线要写明 `main` 和具体提交
47-- **每个任务必须强制使用独立的新分支和新的 git worktree**，避免代码冲突
48-- 功能任务分支名以 `feat/` 开头，缺陷任务以 `bug/` 开头
49-- worktree 路径统一为 `/Users/george/code/baa-conductor-<short-branch-name>`
50-- 禁止直接在 main 上修改代码
51-- 禁止多个任务共用同一个 worktree
52-- 能并行的任务优先拆开，并明确写清 `允许修改的目录`
53-- 不要把背景、实现边界、验收标准混成一段
54-- 验收标准必须能直接检查，不要只写"功能正常"
55-- 如果有明确边界，不要只写"参考现有实现"，要写"尽量不要修改哪些目录"
56-- 任务文档的"执行记录"区域创建时留空，由执行任务的 AI 填写
57+- `<repo>/tasks/`
58+- `<repo>/docs/tasks/`
59+- `<repo>/.codex/tasks/`
60+
61+如果是多仓任务，也可以集中放在一个单独目录里统一管理。
62
63 ## 模板正文
64
65@@ -55,16 +55,16 @@
66
67 ## 直接给对话的提示词
68
69-读 `/Users/george/code/baa-conductor/tasks/<当前任务文档>.md` 任务文档，完成开发任务。
70+读 `</绝对路径/当前任务文档.md>` 任务文档，完成开发任务。
71
72 如需补背景，再读：
73
74-- `</绝对路径/背景文件1.md>`
75-- `</绝对路径/背景文件2.md>`
76+- `</绝对路径/背景文档1.md>`
77+- `</绝对路径/背景文档2.md>`
78
79 ## 当前基线
80
81-- 仓库：`/Users/george/code/baa-conductor`
82+- 仓库：`</绝对路径/仓库>`
83 - 分支基线：`main`
84 - 提交：`<当前 main 提交>`
85
86@@ -73,13 +73,13 @@
87 每个任务必须使用独立的分支和 worktree，禁止直接在 main 上修改，禁止多个任务共用同一个 worktree。
88
89 - 分支名：`<feat/short-branch-name 或 bug/short-branch-name>`
90-- worktree 路径：`/Users/george/code/baa-conductor-<short-branch-name>`
91+- worktree 路径：`</绝对路径/仓库>-<short-branch-name>`
92
93 开工步骤：
94
95-1. `cd /Users/george/code/baa-conductor`
96-2. `git worktree add ../baa-conductor-<short-branch-name> -b <分支名> main`
97-3. `cd ../baa-conductor-<short-branch-name>`
98+1. `cd </绝对路径/仓库>`
99+2. `git worktree add ../$(basename $(pwd))-<short-branch-name> -b <分支名> main`
100+3. `cd ../$(basename $(pwd))-<short-branch-name>`
101 4. 在这个 worktree 目录里开发，不要回到主仓库目录
102
103 完成后提交与推送：
104@@ -89,11 +89,11 @@
105
106 合并步骤（由合并者执行）：
107
108-1. `cd /Users/george/code/baa-conductor`
109+1. `cd </绝对路径/仓库>`
110 2. `git fetch origin`
111 3. `git merge origin/<分支名>`
112 4. `git push`
113-5. `git worktree remove ../baa-conductor-<short-branch-name>`（如果 worktree 还在）
114+5. `git worktree remove ../$(basename $(pwd))-<short-branch-name>`（如果 worktree 还在）
115
116 合并冲突处理：
117
118@@ -105,7 +105,7 @@
119 命名规则：
120
121 - 功能任务分支名以 `feat/` 开头
122-- 缺陷任务分支名以 `bug/` 开头
123+- 缺陷任务以 `bug/` 开头
124
125 ## 目标
126
127@@ -117,7 +117,8 @@
128
129 ## 涉及仓库
130
131-- `/Users/george/code/baa-conductor`
132+- `</绝对路径/仓库1>`
133+- `</绝对路径/仓库2>`
134
135 ## 范围
136
137@@ -127,19 +128,24 @@
138
139 ## 路径约束
140
141-<如果有固定目录、接口、脚本或文档边界，在这里写清楚>
142+<如果有固定新路径前缀、目录位置或接口命名约束，在这里写清楚>
143
144 ## 推荐实现边界
145
146-建议优先做：
147+建议新增：
148+
149+- `<service/controller/vo/...>`
150
151-- <实现点 1>
152-- <实现点 2>
153+建议放到：
154+
155+- `</绝对路径/目录1/>`
156+- `</绝对路径/目录2/>`
157
158 ## 允许修改的目录
159
160 - `</绝对路径/目录1/>`
161 - `</绝对路径/目录2/>`
162+- `</绝对路径/目录3/>`
163
164 ## 尽量不要修改
165