AB
AiBoss站
project

squadra - 让多个 AI 编码窗口像一个团队协作并留下可核查记录

squadra 是 dagoSte 维护的 MIT 开源工具,面向 Claude Code、Codex 与 Cursor 的多窗口协作:一个窗口协调、一个窗口改代码、另一个非作者窗口复核,所有步骤记录在本机注册表中,并配有仪表盘。本文据事实表与项目自述介绍其维护状态、主要能力、使用入口与许可边界。

squadra 是一个面向 AI 编码代理的团队协作工具,项目自述其目标是让多个 AI 代理窗口在同一个项目上像一支可追踪的团队那样工作:一个窗口负责协调,另一个窗口执行改动,第三个窗口负责复核,而且复核者永远不是改动作者。它针对的是代理协作中常见的几类失误——作者自己审自己的代码、通过的测试其实跑在另一份代码上、关键决策淹没在冗长对话里。据项目说明,它由三部分组成:代理遵循的 skill、记录每一步的 CLI,以及用来阅读记录的仪表盘。它适合已经在使用 Claude Code、Codex 或 Cursor 进行多窗口开发、并希望把分工与验证过程留痕的开发者。

维护者与状态

项目由 dagoSte 维护,仓库创建于 2026-09-28,最后一次提交时间为 2026-10-16。最新正式版本为 v3.10.1,发布于 2026-10-16。截至 2026-10-17,仓库星标数为 238。项目采用 MIT 许可证。

主要能力

以下能力均据项目自述整理,未做独立验证。

  • 统一注册表。 项目称所有窗口共用一份注册表,任务分配、验证结果与决策都保存在本机,而不是留在某个聊天窗口的记忆里;每个窗口可以在自己的代码副本(checkout)中工作。
  • 作者与复核者分离。 每一处改动都由没有编写它的窗口检查;若代码在验证之后又发生变化,原有的验证与复核结果不再有效。
  • 任务确认后才开始。 任务只有在接收方确认收到之后才会启动。
  • 决策附带现成措辞。 当某个决定需要由人来做时,工具会给出选项、建议以及可以直接回复的原话。
  • 用量视图。 3.10.0 起提供 Usage 页面,读取 Claude Code 与 Codex 已保存在本机的会话文件,只保留 token 计数以及用于去重的模型、时间、会话与消息标识,按窗口、日期、模型和任务展示;项目称从不存储、展示或发送对话正文。3.10.1 新增 Balance 系统技能,按负载、配额与历史给出窗口与模型分配建议,并列出建议所依据的数字,但本身不做任何分配。
  • 系统技能。 3.9.0 引入可自行激活的系统技能:errata 在新任务触及相同文件或词语时带回此前记录的教训;rasoio 是面向代码阅读的精简视角;previsione 将新任务与相似的已完成任务比较并建议路线。
  • 缺陷修复验证。 通过 task --defect-fix 声明修复后,在关闭前 challenge 会在原始代码与交付代码上分别运行约定测试。
  • 插件。 项目提供 memoranda、Playwright、Sentry 等插件,其中 Sentry 插件在 3.8.0 中标注为预览,项目称仅用合成连接测试过。
  • 性能改进。 项目自述在自身约 9,980 条事件的注册表上测得,squadra status 从 8.6 秒降至 0.85 秒,squadra output 从 10.7 秒降至 0.86 秒,命令输出从 75–95 KB 降至约 2.2 KB。这些数字来自维护者自己的环境,不是第三方基准。

使用入口

仓库地址:https://github.com/dagoSte/squadra。

据项目说明,在 Claude Code 与 Codex 中可通过 /plugin 安装,具体步骤见仓库的 Installation 一节。项目自述的运行环境要求为 Python 3.12+,支持 macOS / POSIX。典型起步方式是先安装,然后对第一个窗口说:“Use squadra for this project. Use the registry at /path/to/registry. Find the other windows and introduce yourself; describe the work in plain words.” 之后在该注册表上打开其他窗口。

关于 Cursor:项目明确说明 Cursor 窗口只能以交互方式工作,需要用户自己打开 cursor-agent,它像其他窗口一样调用 squadra CLI;squadra 不会自行启动它,原因是 Cursor 会在任何沙箱之外运行团队、用户与企业级 hook,且无法关闭。

许可与限制

许可证为 MIT。项目自述免费、开源、无需账号,所有内容在本机运行。

使用边界方面,项目说明了几点:Cursor 窗口需手动启动,且仅支持交互模式;用量统计依赖 Claude Code 与 Codex 已保存在本机的会话文件,且只保留计数类元数据;成本估算只有在用户自行填入价格后才会出现;Codex 配额按实际测量值展示。Sentry 插件为预览状态,项目称仅以合成连接测试。项目 README 中提到的静态、行为与依赖检查不包含 tests/ 目录,通过的含义是没有 HIGH 或 CRITICAL 级别发现,较低严重度的问题仍会留在报告中。