baa-conductor

commit

e62e98d

parent

9bc2519

author

im_wower

date

2026-03-25 00:06:30 +0800 CST

chore: drop plans workflow doc

  1@@ -1,123 +0,0 @@
  2-# 协作工作流
  3-
  4-这份文档保留最小协作规则，供以后需要临时并行开发时复用。
  5-
  6-## 1. 每个实例启动后要读什么
  7-
  8-按顺序阅读：
  9-
 10-1. [`../DESIGN.md`](../DESIGN.md)
 11-2. [`../docs/api/README.md`](../docs/api/README.md)
 12-3. [`TASK_OVERVIEW.md`](./TASK_OVERVIEW.md)
 13-4. 自己的活动任务卡
 14-
 15-## 2. 每个实例开始前要做什么
 16-
 17-1. 在自己的任务卡里填写或更新：
 18-   - `status`
 19-   - `base_ref`
 20-   - `updated_at`
 21-2. 建自己的 branch
 22-3. 建自己的 worktree
 23-4. 在新 worktree 中先执行依赖安装
 24-5. 只在 `write_scope` 内开发
 25-
 26-## 3. 每个实例开发时的规则
 27-
 28-- 只改自己的任务卡
 29-- 不改别人的任务卡
 30-- 不把聊天内容当作任务真相
 31-- 不和其他任务共用 worktree
 32-- 不随手改超出 `write_scope` 的文件
 33-- 所有新任务默认以 `100.71.210.78:4317` 和 `conductor.makefile.so` 为 canonical 接口面
 34-- `control-api.makefile.so`、Cloudflare Worker、D1、`baa-hand` / `baa-shell` 只作为 legacy 背景，不再写成默认主路径
 35-
 36-如果确实需要越界：
 37-
 38-- 先在任务卡里记录原因
 39-- 再由整合者决定是扩 scope 还是拆新任务
 40-
 41-## 4. 每个实例完成后要做什么
 42-
 43-任务完成后，必须在自己的任务卡中更新：
 44-
 45-- `status`
 46-- `updated_at`
 47-- `files_changed`
 48-- `commands_run`
 49-- `result`
 50-- `risks`
 51-- `next_handoff`
 52-
 53-## 5. 汇总规则
 54-
 55-- 各个 worker 只更新自己的任务卡
 56-- 全局状态板由整合者更新
 57-- 如果出现冲突，以任务卡和代码为准
 58-- 当前主线不再保留历史任务归档；需要历史上下文时，直接查 git tag
 59-
 60-## 6. 推荐的分支与 worktree 模式
 61-
 62-建议：
 63-
 64-```bash
 65-git worktree add ../baa-conductor-T004 -b feat/T-004-conductor-lease main
 66-cd ../baa-conductor-T004
 67-npx --yes pnpm install
 68-```
 69-
 70-对应关系：
 71-
 72-- 一个 task
 73-- 一个 branch
 74-- 一个 worktree
 75-- 一个 owner
 76-
 77-## 7. 当前状态字段约定
 78-
 79-任务卡 frontmatter 的 `status` 统一使用：
 80-
 81-- `todo`
 82-- `in_progress`
 83-- `blocked`
 84-- `review`
 85-- `done`
 86-
 87-推荐最小规则：
 88-
 89-- 开始时：`todo -> in_progress`
 90-- 遇阻塞时：改成 `blocked`
 91-- 代码完成并已提交推送时：改成 `review`
 92-- 整合确认完成后：改成 `done`
 93-
 94-## 8. 不再强制记录实例名
 95-
 96-为降低协作成本，当前阶段不强制记录：
 97-
 98-- `owner`
 99-- 实例编号
100-- 长进度日志
101-
102-默认假设：
103-
104-- 任务由整合者明确分配
105-- 谁拿到任务，谁就改自己的任务卡状态
106-- 分支名和 commit 已足够定位该任务的实际执行者
107-
108-## 9. 当前最小回写要求
109-
110-开始时最少改这几个字段：
111-
112-- `status`
113-- `base_ref`
114-- `updated_at`
115-
116-结束时最少补这些内容：
117-
118-- `status`
119-- `updated_at`
120-- `files_changed`
121-- `commands_run`
122-- `result`
123-- `risks`
124-- `next_handoff`