bradygaster/squad

Squad – 人类主导的AI开发团队（阿尔法版）

是什么 – 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 下获取。

状态 – 阿尔法版（README 中有徽章）。API 和 CLI 标志预计会更改；重大变更记录在 CHANGELOG.md 中。

适合谁使用

• 希望在不失去控制权的前提下获得 AI 协助并行开发的单人开发者。
• 希望在仓库内原型化“AI 增强”工作流的小团队。
• 探索代理编排、GitHub Copilot 和自动问题分类的研究人员或爱好者。

了解更多

• 完整命令参考在 README 中（每个命令和标志的表格）。
• SDK 文档（docs/src/content/docs/reference/sdk.md）。
• 示例项目（samples/README.md）。
• GitHub 自动化工作流指南（README 中的链接）。

---

以上所有细节均直接来自仓库的 README；未推断任何额外功能。