bradygaster/squad

Squad – 人類導向的 AI 開發團隊（Alpha 版）

是什麼 – Squad 是一個生產力工具，讓單一開發者能在 Git 倉庫內建立並管理一組 AI 代理（前端、後端、測試、負責人等）。這些代理由 GitHub Copilot 驅動，並透過 CLI（@bradygaster/squad-cli）進行協調。團隊以 .squad/ 資料夾下的 Markdown 檔案形式持久化，因此累積的「知識」會隨著程式碼一起移動。

核心概念

• 團隊定義 – squad init 會建立一個 .squad/ 目錄，包含 team.md、routing.md、decisions.md，以及每個代理的章程與歷程資料夾。
• 人類在迴圈中 – 人類始終是決策主體；代理僅負責自動化協調、重複性程式碼、問題分類與測試。所有操作皆會記錄並可審查。
• 監聽模式（Ralph） – 可選的守護程序會輪詢 GitHub 問題/拉取請求，自動進行分類，並可自動啟動 Copilot 代理來處理問題。支援可設定的狀態後端（記憶體、git-notes、孤島分支）與分層錯誤復原策略。
• CLI 命令 – 17 個一等級命令（init、upgrade、triage、copilot、nap、aspire 等）涵蓋設定、升級、健康檢查、外部化狀態、匯出/匯入團隊、外掛/市場管理等功能。
• SDK 優先模式 – 除了預設的 Markdown 驅動設定外，開發者也可使用 @bradygaster/squad-sdk 在 TypeScript（squad.config.ts）中定義團隊，再透過 squad build 產生 Markdown 檔案。
• GitHub 自動化工作流程 – Squad 可作為可重用的 GitHub 自動化工作流程安裝，支援透過問題評論中的斜線指令進行控制。

典型工作流程

1. mkdir my-project && git init
2. npm install -g @bradygaster/squad-cli && squad init
3. 使用 gh auth login 進行認證
4. 在 VS Code 中開啟 Copilot Chat 並選擇 Squad 代理（或執行 copilot --agent squad --yolo）。
5. 描述專案（例如：「一個使用 React 與 Node 的食譜分享應用」）。
6. Squad 提出代理名單；輸入 yes 確認。
7. 代理並行工作——前端建構 UI，後端建立 API，測試人員撰寫測試等——人類則審查 PR 並批准決策。

安裝方式

• CLI（全域）：npm install -g @bradygaster/squad-cli
• 從原始碼：克隆倉庫，npm install（工作區），npm run build，然後執行 npm run dev:link 將開發版本全域連結。
• .NET 預覽版：Microsoft Agent Framework 整合的 NuGet 套件 Squad.Agents.AI 可在 src/Squad.Agents.AI 下取得。

狀態 – Alpha 版（README 中有徽章）。API 與 CLI 標誌預期會變更；重大變更記錄於 CHANGELOG.md 中。

適合誰使用

• 希望在不失去控制權的前提下獲得 AI 協助並行開發的單人開發者。
• 希望在倉庫內原型化「AI 增強」工作流程的小團隊。
• 探索代理編排、GitHub Copilot 與自動問題分類的研究人員或愛好者。

進一步了解

• 完整命令參考在 README 中（每個命令與標誌的表格）。
• SDK 文件（docs/src/content/docs/reference/sdk.md）。
• 範例專案（samples/README.md）。
• GitHub 自動化工作流程指南（README 中的連結）。

---

以上所有細節均直接來自倉庫的 README；未推斷任何額外功能。