baa-conductor

T-S006.md

  1# Task T-S006：清理历史 `control-api` 命名残留
  2
  3## 直接给对话的提示词
  4
  5读 `/Users/george/code/baa-conductor/tasks/archive/T-S006.md` 任务文档，完成开发任务。
  6
  7如需补背景，再读：
  8
  9- `/Users/george/code/baa-conductor/tasks/TASK_OVERVIEW.md`
 10- `/Users/george/code/baa-conductor/plans/STATUS_SUMMARY.md`
 11- `/Users/george/code/baa-conductor/bugs/README.md`
 12- `/Users/george/code/baa-conductor/docs/api/README.md`
 13- `/Users/george/code/baa-conductor/docs/runtime/README.md`
 14- `/Users/george/code/baa-conductor/docs/api/hand-shell-migration.md`
 15
 16## 当前基线
 17
 18- 仓库：`/Users/george/code/baa-conductor`
 19- 分支：`main`
 20- 提交：`d349be1`
 21- 开工要求：不要从其他任务分支切出；如需新分支，从当前 `main` 新切
 22
 23## 建议分支名
 24
 25- `chore/clean-legacy-control-api-names`
 26
 27## 目标
 28
 29把仓库里仍然误导当前主线的 `control-api` / `control-api.makefile.so` 命名清掉，只保留必要的历史背景描述。
 30
 31## 背景
 32
 33- 当前功能与运行时已经切到 `4317` 和 `conductor.makefile.so`。
 34- 剩余风险之一是历史任务文档、缺陷文档、迁移说明和部分兼容说明里还保留 `control-api` 命名。
 35- 这些命名如果不清，会继续误导后续协作和任务拆分。
 36
 37## 涉及仓库
 38
 39- `/Users/george/code/baa-conductor`
 40
 41## 范围
 42
 43- 清理历史文档里的 misleading current-tense `control-api` 命名
 44- 保留必要的历史背景，但要明确“legacy / 兼容 / 已移除”
 45- 统一当前任务与状态文档的口径
 46
 47## 路径约束
 48
 49- 只做文档和任务/缺陷记录清理，不改运行时代码。
 50- 如果某处是“历史事实”，可以保留，但必须明确是历史背景。
 51
 52## 推荐实现边界
 53
 54建议优先做：
 55
 56- `tasks/**`、`plans/**`、`bugs/**` 的当前口径清理
 57- `docs/api/**`、`docs/runtime/**` 里仍像当前配置说明的 legacy 命名收口
 58- 避免把历史 bug / 任务的复现描述洗掉
 59
 60## 允许修改的目录
 61
 62- `/Users/george/code/baa-conductor/tasks/`
 63- `/Users/george/code/baa-conductor/plans/`
 64- `/Users/george/code/baa-conductor/bugs/`
 65- `/Users/george/code/baa-conductor/docs/api/`
 66- `/Users/george/code/baa-conductor/docs/runtime/`
 67- `/Users/george/code/baa-conductor/README.md`
 68
 69## 尽量不要修改
 70
 71- `/Users/george/code/baa-conductor/apps/`
 72- `/Users/george/code/baa-conductor/scripts/runtime/`
 73- `/Users/george/code/baa-conductor/ops/launchd/`
 74- `/Users/george/code/baa-conductor/tests/`
 75
 76## 必须完成
 77
 78### 1. 清理误导性的当前时态表述
 79
 80- 把仍像“当前主线配置”的 `control-api` 描述改成 legacy 背景说明
 81- 当前 canonical 接口必须始终指向 `4317` / `conductor.makefile.so`
 82
 83### 2. 保留必要的历史信息
 84
 85- 不要删除仍有排障价值的历史背景
 86- 历史事实必须明确标成 “legacy / 迁移前 / 已移除”
 87
 88### 3. 统一状态文档口径
 89
 90- `tasks/`、`plans/`、`bugs/` 的现状描述要彼此一致
 91- 不再出现一份文档说“已修复”，另一份还写“未解决”
 92
 93## 需要特别注意
 94
 95- 不要改代码逻辑
 96- 不要为了追求“全删干净”而损失历史排障信息
 97- 与 `T-S005` 同时改 `docs/runtime/**` 会冲突，避免并行落地
 98
 99## 验收标准
100
101- 当前主线相关文档不再把 `control-api` 写成现行默认入口
102- 历史背景仍可追溯，但不会误导当前维护
103- `tasks/`、`plans/`、`bugs/` 三处状态口径一致
104- `git diff --check` 通过
105
106## 推荐验证命令
107
108- `rg -n "control-api\\.makefile\\.so|control-api" /Users/george/code/baa-conductor/tasks /Users/george/code/baa-conductor/plans /Users/george/code/baa-conductor/bugs /Users/george/code/baa-conductor/docs`
109- `git -C /Users/george/code/baa-conductor diff --check`
110
111## 交付要求
112
113完成后请说明：
114
115- 修改了哪些文件
116- 哪些 `control-api` 命名被改掉了
117- 哪些历史描述被保留了
118- 你如何区分“历史事实”和“误导性当前口径”
119- 还有哪些遗留命名决定暂时不动