Squad：倉庫內可检查的 GitHub Copilot 代理团队
小隊：適用於任何專案的人工智慧代理團隊。為了獲得最佳的 Squad 體驗，請使用 [GitHub Copilot CLI]。
秒懂
- 它是什麼？
- MIT 的 TypeScript 單體倉庫，用 squad init 生成 .squad/ 文件化团队，经 Copilot 命令行或 VS Code 代理协作。
- 適合誰用？
- Squad 适合已在用 GitHub Copilot 命令行、希望把多角色人工智能协作沉淀為倉庫文件的团队；不适合无法使用 Copilot 或不能接受 Alpha 接口变更的環境。試用前 npm install -g @bradygaster/squad-cli，squad init 确認生成 .squad/team.md，再 copilot --agent squad --yolo 發起一次团队搭建對话。
- 可以商用嗎？
- 可以。MIT 是寬鬆授權：你可以使用、修改並販售以它為基礎的軟體，只需保留著作權與授權聲明。
- 還在維護嗎？
- 有在維護。儲存庫在最近一天內有新的提交。
- 用什麼語言寫的？
- 主要是 TypeScript（依據 GitHub 的語言統計）。
以上回答依據專案的 GitHub 資料（最近同步於 2026年9月15日）與我們的分析，不構成法律意見。
開源專案深度解析
人類主導的多角色 Copilot 团队
bradygaster/squad 的 README 定義 Squad 為面向任意項目、由人類主導的 AI 代理团队，通過 GitHub Copilot 提供前端、后端、測試、负责人等角色，並以文件形式持久化在倉庫。README 寫這是面向人類的生产力工具，人仍對優先級、审批和最终改动负责；不是戴不同帽子的聊天机器人。
項目標注 Alpha 軟件，應用程序接口與命令行可能在版本間变化，破坏性变更记录在 CHANGELOG.md。默認分支 dev，最新 release v0.13.1。Responsible AI 段落强调放大人類操作者能力，而不是把人類移出循環。
补充1：CHANGELOG.md 记录 Alpha 期間 breaking CLI 变更；squad update-check --json 供 CI 检測 CLI 是否過期。
补充9：Responsible AI 段落强调人類對優先級與审批负责，代理文件可审計而非黑盒聊天。
补充17：squad copilot 子命令管理 @copilot 自动指派；squad nap 做上下文压缩，長会话倉庫應定期 nap --dry-run 预览。
补充25：SDK-first 模式用 squad.config.ts 定義团队仍處實验阶段，生产環境 README 建议 markdown-first。
补充33：bradygaster.github.io/squad 提供在線文檔入口；README.zh.md 與英文 README 並列。
bradygaster-squad-deep-analysis 第 1 節的具體核對點是 人類主導的多角色 Copilot 团队。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
Quick Start 四步與验證点
快速開始：mkdir 項目並 git init；npm install -g @bradygaster/squad-cli 后 squad init（--preset default 可秒級生成完整团队）；gh auth login；copilot --agent squad --yolo 或在 VS Code Copilot Chat 選 Squad 代理。
README 寫验證点：git status 應显示尚无提交；squad init 后應出現 .squad/team.md；gh auth status 應显示已登录 github.com。--yolo 减少 Copilot 對大量工具调用的逐条确認。首次對话示例描述用 React 與 Node 做食谱分享應用，Squad 提议成员后输入 yes 确認。
补充2：Responsible AI 段落强调人類對優先級與审批负责，代理文件可审計而非黑盒聊天。
补充10：squad copilot 子命令管理 @copilot 自动指派；squad nap 做上下文压缩，長会话倉庫應定期 nap --dry-run 预览。
补充18：SDK-first 模式用 squad.config.ts 定義团队仍處實验阶段，生产環境 README 建议 markdown-first。
补充26：bradygaster.github.io/squad 提供在線文檔入口；README.zh.md 與英文 README 並列。
补充34：squad aspire 打開 Aspire 仪表盘，适合已用 .NET Aspire 栈的团队观測代理调用。
bradygaster-squad-deep-analysis 第 2 節的具體核對點是 Quick Start 四步與验證点。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
.squad/ 目录與 upgrade 边界
README 與基線稿描述 .squad/ 保存 team.md 花名册、routing.md 路由、decisions.md 决策、ceremonies.md 仪式；各代理文件夹含 charter.md 與 history.md；另有 skills/、identity/、log/ 等。
squad upgrade 更新 squad.agent.md、模板與 GitHub workflows，但不触及 .squad/ 团队状態。externalize 與 internalize 可把状態移到工作树外以在切換分支時保留上下文。提交 .squad/ 到 git 后，克隆者獲得相同代理阵容。
补充3：squad copilot 子命令管理 @copilot 自动指派；squad nap 做上下文压缩，長会话倉庫應定期 nap --dry-run 预览。
补充11：SDK-first 模式用 squad.config.ts 定義团队仍處實验阶段，生产環境 README 建议 markdown-first。
补充19：bradygaster.github.io/squad 提供在線文檔入口；README.zh.md 與英文 README 並列。
补充27：squad aspire 打開 Aspire 仪表盘，适合已用 .NET Aspire 栈的团队观測代理调用。
补充35：squad scrub-emails 可扫描目录去邮箱；squad upstream sync 同步上游 Squad 模板。
bradygaster-squad-deep-analysis 第 3 節的具體核對點是 .squad/ 目录與 upgrade 边界。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
squad triage 监视與 Ralph 停止
命令表列出 squad triage（别名 watch、loop）為监视模式，默認 --interval 10 分钟轮询 issues；加 --execute 可调度 Copilot 代理。相關標志包括 --agent-cmd、--copilot-flags、--auth-user、--state-backend（git-notes、orphan-branch 或內存）。
README 描述通過 .squad/ralph-stop 哨兵文件優雅停止监视。启用 --execute 前應在沙盒倉庫用 --interval 1 观察日志，再决定是否在生产倉庫自动分诊。
补充4：SDK-first 模式用 squad.config.ts 定義团队仍處實验阶段，生产環境 README 建议 markdown-first。
补充12：bradygaster.github.io/squad 提供在線文檔入口；README.zh.md 與英文 README 並列。
补充20：squad aspire 打開 Aspire 仪表盘，适合已用 .NET Aspire 栈的团队观測代理调用。
补充28：squad scrub-emails 可扫描目录去邮箱；squad upstream sync 同步上游 Squad 模板。
补充36：CHANGELOG.md 记录 Alpha 期間 breaking CLI 变更；squad update-check --json 供 CI 检測 CLI 是否過期。
bradygaster-squad-deep-analysis 第 4 節的具體核對點是 squad triage 监视與 Ralph 停止。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
命令行指令集與本地開發
README 列 init、upgrade、upgrade --self、update-check、status、triage、copilot、doctor、link、externalize、internalize、export/import、plugin marketplace、upstream、nap、aspire、scrub-emails 等。squad shell 已弃用，改 copilot --agent squad。
本地開發：git clone 倉庫，npm install，npm run build，node ./packages/squad-cli/dist/cli-entry.js init，或 npm run dev:link 全局链接 CLI。聊天中說 squad commands 可打開分類菜單；squad-commands 技能随 init 與 upgrade 自带。
补充5：bradygaster.github.io/squad 提供在線文檔入口；README.zh.md 與英文 README 並列。
补充13：squad aspire 打開 Aspire 仪表盘，适合已用 .NET Aspire 栈的团队观測代理调用。
补充21：squad scrub-emails 可扫描目录去邮箱；squad upstream sync 同步上游 Squad 模板。
补充29：CHANGELOG.md 记录 Alpha 期間 breaking CLI 变更；squad update-check --json 供 CI 检測 CLI 是否過期。
补充37：Responsible AI 段落强调人類對優先級與审批负责，代理文件可审計而非黑盒聊天。
bradygaster-squad-deep-analysis 第 5 節的具體核對點是 命令行指令集與本地開發。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
Squad.Agents.AI 预览與 monorepo
README 的 .NET 包预览段介绍 Squad.Agents.AI NuGet 预览包，位于 src/Squad.Agents.AI，可在依赖注入注册 Squad 支持的 AIAgent，目標 0.1.0-preview 早期消费者。與 Node 命令行主路径並行，面向 Microsoft Agent Framework 集成。
Monorepo 含 @bradygaster/squad-sdk 與 @bradygaster/squad-cli。MIT 許可允許試验，但 Alpha 状態要求锁定 @bradygaster/squad-cli 版本並在 CHANGELOG 中跟踪破坏性变更。bradygaster.github.io/squad 提供在線文檔。
补充6：squad aspire 打開 Aspire 仪表盘，适合已用 .NET Aspire 栈的团队观測代理调用。
补充14：squad scrub-emails 可扫描目录去邮箱；squad upstream sync 同步上游 Squad 模板。
补充22：CHANGELOG.md 记录 Alpha 期間 breaking CLI 变更；squad update-check --json 供 CI 检測 CLI 是否過期。
补充30：Responsible AI 段落强调人類對優先級與审批负责，代理文件可审計而非黑盒聊天。
补充38：squad copilot 子命令管理 @copilot 自动指派；squad nap 做上下文压缩，長会话倉庫應定期 nap --dry-run 预览。
bradygaster-squad-deep-analysis 第 6 節的具體核對點是 Squad.Agents.AI 预览與 monorepo。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
Squad 倉庫內冒烟測試
空目录 git init 后 squad init，确認 .squad/team.md 存在；gh auth status 通過后 copilot --agent squad --yolo，發送 README 示例項目描述；最后 squad doctor 检查诊斷输出。
升級分两步：npm install -g @bradygaster/squad-cli@latest，再在項目內 squad upgrade。企業環境引入前應评估 Copilot 發送哪些倉庫片段、--yolo 是否允許自动执行 shell、.squad/log 是否含敏感决策。
补充7：squad scrub-emails 可扫描目录去邮箱；squad upstream sync 同步上游 Squad 模板。
补充15：CHANGELOG.md 记录 Alpha 期間 breaking CLI 变更；squad update-check --json 供 CI 检測 CLI 是否過期。
补充23：Responsible AI 段落强调人類對優先級與审批负责，代理文件可审計而非黑盒聊天。
补充31：squad copilot 子命令管理 @copilot 自动指派；squad nap 做上下文压缩，長会话倉庫應定期 nap --dry-run 预览。
bradygaster-squad-deep-analysis 第 7 節的具體核對點是 Squad 倉庫內冒烟測試。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
Squad 在企業倉庫 pilot 時的權限边界
Squad 與 GitHub Copilot 命令行深度绑定，gh auth login 之后才能使用 issues、拉取请求與 Ralph 监视模式。README 中文链 README.zh.md 與英文並列，中文团队可先看中文版快速開始，但 npm 包名與命令仍以 @bradygaster/squad-cli 為准。
企業環境引入前應评估 Copilot 会發送哪些倉庫片段、--yolo 是否允許自动执行 shell、.squad/log 是否含敏感决策。squad link 可連接远程团队倉庫，export 與 import 便于在模板倉庫間複制团队結構。Alpha 阶段不建议把 Squad 寫進合规流程，除非每步合並仍有人工門禁。
补充8：CHANGELOG.md 记录 Alpha 期間 breaking CLI 变更；squad update-check --json 供 CI 检測 CLI 是否過期。
补充16：Responsible AI 段落强调人類對優先級與审批负责，代理文件可审計而非黑盒聊天。
补充24：squad copilot 子命令管理 @copilot 自动指派；squad nap 做上下文压缩，長会话倉庫應定期 nap --dry-run 预览。
补充32：SDK-first 模式用 squad.config.ts 定義团队仍處實验阶段，生产環境 README 建议 markdown-first。
bradygaster-squad-deep-analysis 第 8 節的具體核對點是 Squad 在企業倉庫 pilot 時的權限边界。請依文件中的專案名稱、命令、檔案或設定鍵檢查結果，記錄成功與失敗的差異；這個觀察只用來界定本節能力，不延伸成文件沒有承諾的結論。
編輯結論
Squad 适合已在用 GitHub Copilot 命令行、希望把多角色人工智能协作沉淀為倉庫文件的团队；不适合无法使用 Copilot 或不能接受 Alpha 接口变更的環境。試用前 npm install -g @bradygaster/squad-cli，squad init 确認生成 .squad/team.md，再 copilot --agent squad --yolo 發起一次团队搭建對话。
社群筆記