solobatonlisted

# Solobaton —— 一个 Builder + N 个 AI 会话交付中大型项目(Builder 协作总线) > 蒸馏自一个真实跑了多期迭代的实践:单人 + 4 个并行 AI 会话,把一个含前端/BFF/多个后端服务/网关/审计的内部产品从零迭代上线 30+ 次。方法论与项目解耦,模板可直接拷贝。 ## 0. 何时��� / 不用 - **用**:项目 ≥ 2 个仓或部署单元、要跑多期迭代、一个人同时扮演 PM/开发/测试/运维、AI 会话之间需要交接。 - **不用**:单仓小任务、一次性脚本、预计一周内收尾的事——直接开一个会话干完,上总线纯属 ceremony(对应 §5 快轨思想)。 ## 1. 四根支柱(命根子,所有零件都为它们服务) 1. **真多会话隔离**:每个"域"= 一个独立 AI 会话(独立 cwd / 独立上下文 / 只写自己的文件)。天然抗 context rot,天然实现"写者≠审者"。 2. **人在 Gate**:规格、设计、合并、上线四个决策点必须人拍板,**不可自动跨过**。人只当"节拍器 + 拍板者",不当信息搬运工。 3. **文件总线**:会话间不靠人转述,信息全部走 repo 文件(指针 → 看板 → 契约 → 状态),开工自取。 4. **证据制完成**:任何域声明"完成"必须带 ① commit hash ② 可核验证据(测试命令 / `文件:行` / 线上实测 / 截图)。**无证据 = 没完成。** > 需求编号可以细,但**执行边界不能跟着编号碎掉**:一个会话同时只认领一个可验收的用户级工作包,通常覆盖多个任务 ID / 文档 / commit;同一工作包可由多个域按各自写边界接力,看板也可容纳少量并行工作包。子产物提交、reviewer 返回、status 回写都只是工作包内事件,不是自动结束会话的理由。 ## 2. 域模型(宁少勿多,从 3 个起步) | 域 | 干什么 | 写哪 | |---|---|---| | **产品**(记账/编排) | 拆需求、定契约要点、维护看板与决策台账、派核查门 | `pm/**` | | **全栈**(实现,含运维) | 实现 + 改契约 + 部署;可同持多仓但**按仓分别 stage** | 代码仓 + `contracts/` | | **测试**(E2E·走查) | 黑盒 E2E + 视觉回归 + 设计走查,不合格直接提带图 bug | `tests/**` + 证据产物(落 `pm/archive/<期>/evidence/`) | - **reviewer = 只读 subagent**(不是常驻会话):支持 `milestone`(里程碑候选全核)/ `risk-delta`(高风险语义定向核)/ `closure`(只复核 finding 修复)三种模式,模板见 [templates/.claude/agents/reviewer.md](templates/.claude/agents/reviewer.md)。 - **设计生成 = 外部工具**(可选):产品域写 brief → 人喂设计工具 → 稿落 `design/design_N期/`;走查归测试域。 - **切域依据是"物理边界(仓/部署单元)+ 是否需要独立核查",不是人类公司职能表。** 实践教训:按职能切出 6 个域,两个月内被迫合并回 4 个(前端+后端合并、设计+测试合并)——每多一个域,人的编排成本和信息差面积都翻倍。**合并会丢"天然独