如果你同时开着 Claude Code、Codex、Cursor 好几个AI编码窗口一起干活，Squadra 就是一个免费的本地协调工具：它让多个AI窗口像一个小团队一样分工协作——一个窗口当协调者派活、其他窗口当构建者写码、还有一个没写过这段代码的窗口当审查者验收。任务、确认、检查记录和审查报告全部落在同一份本地共享注册表里，再用双语仪表盘实时盯住每一步。

一、痛点：3个AI窗口一起干活，为什么反而乱？

单开一个AI写代码还算顺手，但窗口一多，常见问题就来了：

• 各说各话：每个窗口只记得自己会话里的上下文，A窗口改了接口，B窗口还在按老契约写；
• 自己写自己审：同一个模型"既当运动员又当裁判"，测试能过就宣布完成，隐患溜过去了；
• 进度靠猜：谁在干什么、卡在哪、等谁拍板，你只能挨个窗口问，聊天记录散落在各家的对话框里；
• 证据会漂移：跑测试那一刻的代码和你最后提交的代码，可能已经不是同一份了。

Squadra 的思路很直接：把"团队纪律"写进一套所有窗口都遵守的协议，并用一份共享注册表（registry）把分工、确认、证据和决策记下来，谁都不能只靠聊天记忆办事。

二、Squadra是什么：给AI窗口团队配一个"共享账本"

Squadra 由三部分组成，你可以理解为一套"规则 + 记账本 + 监控大屏"：

仪表盘首页：一句话说清进展，每张任务卡片显示走到哪一步、谁在写、谁在读、下一步是什么。

三个核心角色是这样分工的：

完整规则定义在 SKILL.md 里，任务、证明与审查的详细协议见 references/work.md。

三、协调者：先"点名"、再派活的调度台

Squadra 规定协调者必须是 Claude 窗口（因为它能看见并唤醒项目里的其他窗口）。它上岗后第一件事不是派活，而是点名：用census命令找出项目里所有 Codex、Claude、Cursor 窗口，再逐一发送自我介绍，等对方确认收到才继续。

协调者负责的事包括：

• 派活：给每个空闲窗口分配独立任务，规定"一个构建者一棵代码树"，并行推进、互不阻塞；
• 记录决策：你的每一句拍板（比如"旧密钥保留可读一个月"）都带着原话和渠道记进注册表，可追溯；
• 合并与关单：构建者交付后，协调者核对"证明、审查、代码"三者是否仍然匹配，确认一致才关单；
• 盯人：用ping向各窗口发心跳，长时间不回的窗口被记为"待命"（stand-by），不再派新活，但不会打断它正在跑的东西。

Windows 视图一眼看清四个窗口的角色分工：一个协调者（Claude）、两个构建者、一个审查者，以及各自的任务状态和下一步。

💡 新手提示：如果先被叫起来的是 Codex 窗口，它不会抢着当协调者——它会明说自己在沙箱里看不到其他窗口，并给你一句可以直接粘贴到 Claude 窗口里开启协调的话。

四、构建者：写代码，还要留下"绑定到代码"的证据

构建者的工作流是一条严格的"确认 → 开工 → 证明 → 交付"链路：

1. 确认（ack）：收到任务先明确回执，没确认不许动手——任务不是"发出去"就算开始了；
2. 开工（start）：在自己的独立代码副本里实现；
3. 证明（prove）：在精确到文件指纹的代码上运行事先约定好的检查（比如整套测试），结果连同输入输出一起留档；
4. 交付（deliver）：把经过证明的冻结候选打包移交给审查者。

这里最关键的设计是证据绑定：交付后如果代码又变了，旧的证明和审查自动作废，必须重新证明、重新审。这堵住了"测试跑的是旧代码、提交的是新代码"这个经典漏洞。

五、审查者：谁写的代码，谁就不能自己审

审查者是 Squadra 质量守门的核心，规则简单又硬：

• 写的人不许自己审。而且更进一步——跨模型审查：Codex 写的代码优先由 Claude 读，Claude 写的优先由 Codex 读，因为不同模型的"盲区"不同，异源视角更容易发现问题；
• 读的是冻结副本，审查者不会碰构建者的工作区，多个审查者可以并行读不同任务的候选；
• 判定三选一：通过（accepted）、要求修改（changes required）、阻断（blocked）。只有"严重发现"才会真正挡住发布，其余问题记录为后续跟进，避免小问题卡死全队；
• 只读不改：审查者可以跑自己的探测脚本（含必须失败的负向对照），但绝不直接修代码——修是构建者的事。

任务视图里，每个任务都清楚标出 Builder 和 Reviewer 分别是谁、最新证明是否通过、下一步是什么——分工透明到每个角色。

审查的积累结果可以在 Reads 页面回看：一共记录了多少次独立审查、多少次通过、多少次要求修改，以及要求修改后提交的新版本。这是"审查真的发生过"的账，而不是自我声明。

六、一条任务的完整链路：从派活到关单

把三角色的动作串起来，一个任务在 Squadra 里走完整圈是这样的：

全程你不需要敲这些命令——用大白话跟窗口说话就行，比如"把'密钥轮换服务'这个任务派给构建者窗口，审查者用那个独立窗口，证明就是整套测试"，窗口会自己执行对应命令。协议细节见 references/work.md，初始化与注册窗口见 references/start.md。

七、上手清单：第一次使用怎么开始

✅第1步｜安装：Python 3.12+ 环境，把安装引导语粘贴给你的编码助手，它会先展示计划、等你点头再动手；

✅第2步｜开局：对 Claude 窗口说"用 squadra 管理这个项目，共享注册表在 <路径>，找到其他窗口并逐一自我介绍"；

✅第3步｜派第一个任务：描述你要的结果和验收方式，让协调者派人、派审查；

✅第4步｜盯盘：让协调者运行squadra dash --open打开本地仪表盘，跟着"确认 → 干活 → 检查 → 独立审查 → 关单"的链路看进展；

✅第5步｜只在你被需要时出现：仪表盘出现 "Needs you" 说明有事项等你拍板，回复协调者即可，选项、推荐和应答措辞都会给你备好。

几个新手容易误解的点：

• 完成 ≠ 可以发布：关单不等于获得发布授权，发布永远由你决定；
• 待命 ≠ 停工：stand-by 只是暂停派新任务，不会杀掉已在运行的进程；
• 仪表盘是只读的：页面上没有按钮能替你发布或执行命令，一切写操作走 CLI 协议。

一句话总结：Squadra 不替你写代码，它给多个AI窗口装上了**"点名分活、证据绑定、异源审查、全程留痕"**的团队纪律——窗口再多，你也能像看一块白板一样，看清谁在干什么、哪些代码被验证过、还有哪些事在等你拍板。