用途:当组织运行多个 Squad 实例(如 platform-squad、frontend-squad、data-squad)时,cross-squad 用于让这些实例互相发现、共享上下文并跨仓库边界交接工作,避免形成紧耦合。适用于任务需要其他 Squad 能力、架构决策影响多个 Squad、特性跨多个仓库、或某 Squad 需请求基础设施/工具/支持等场景。
主要能力:1)通过清单发现:各 Squad 发布 .squad/manifest.json,声明名称、能力与联系方式;可通过已知仓库的 well-known 路径、upstream 配置(.squad/upstream.json 中已列出的 Squad)或中心化 squad-registry.json 进行发现。2)上下文共享:委派时只共享目标 Squad 所需内容,包括能力列表、相关决策与交接上下文;不共享内部团队状态、完整决策档案、认证凭据或密钥。3)工作交接协议:检查目标清单是否接受 issues/PRs,在目标仓库创建工单,标题格式为 [cross-squad] <description>,使用 squad:cross-squad 或对方配置的标签,正文包含上下文、验收标准及回链,并在发起方编排日志中记录该 URL,随后定期轮询状态。4)反馈循环:通过 gh issue view 轮询目标工单状态,更新发起工单,并在委派工作合并后关闭循环。
必要用法:命令示例包括 squad discover(列出可发现的 Squad)、squad delegate platform-squad "Add Prometheus metrics endpoint for the auth service"(在目标仓库创建带 cross-squad 标签与上下文的工单)。也可在 squad.config.ts 中通过 defineSquad 配置 manifest,包含 name、capabilities、contact、accepts、skills 等字段。
限制与反模式:不得直接跨仓库写文件或修改他方 .squad/ 目录,应使用 issues 与 PRs 通信;不要依赖他方内部结构,应以 manifest 作为公开 API 契约;委派须包含验收标准与超时,避免无界请求;不要硬编码 Squad 位置,应使用清单与发现协议;切勿在跨 Squad 工单中包含凭据、令牌或内部 URL;需跟踪委派链,防止 A 委派 B 再委派回 A 的循环。其他具体平台、收费或效果信息暂未提供。