Squad

由人类主导的、适用于任何项目的 AI Agent 团队。 一条指令。一个能够助你加速代码开发的团队。

⚠️ Alpha 软件 — Squad 目前处于实验阶段。API 和 CLI 指令在版本更新时可能会发生变化。我们将记录变更详情于 CHANGELOG.md。

什么是 Squad？

Squad 通过 GitHub Copilot 为你提供了一个由人类指挥的 AI 开发团队。描述你正在构建的内容，即可获得一个包含前端、后端、测试人员和项目负责人的专家团队，它们以文件的形式存在于你的代码仓库中。它们能够跨会话持久存在、学习你的代码库、共享决策，并在不让你失去监督权的前提下助你更高效地工作。

Squad 是人类的生产力工具，而非工程师、评审员或决策者的替代品。人类始终负责优先级设定、审批和最终变更；Squad 则负责协调、重复性工作和并行执行。

它不是一个只会换头像的聊天机器人。每个团队成员都在其独立的上下文中运行，只读取其专属知识，并回写学习到的内容，确保工作过程始终可追溯。

负责任的 AI 立场 — Squad 的构建旨在通过 GitHub Copilot 增强人类操作员的能力，而非将人类排除在流程之外。请利用它进行更快速的委派、更高质量的审查，并确保治理过程紧贴代码。

快速入门

1. 创建你的项目

mkdir my-project && cd my-project
git init

✓ 验证： 运行 git status — 你应该能看到 "No commits yet"。

2. 安装 Squad

npm install -g @bradygaster/squad-cli
squad init

⚡ 想要在不到一秒钟内上手？ 使用 squad init --preset default 即可启动一个预先配置好的团队（包含成员、章程和路由规则），即刻投入工作。默认的 squad init（不带参数）会引导你完成分步设置，如果你希望仔细构建和自定义你的团队，这种方式更适合。

✓ 验证： 检查项目中是否已创建 .squad/team.md 文件。

3. 进行 GitHub 身份验证（用于 Issues、PRs 和 Ralph）

gh auth login

✓ 验证： 运行 gh auth status — 你应该能看到 "Logged in to github.com"。

4. 打开 Copilot 并启动

copilot --agent squad --yolo

为什么使用 --yolo？ Squad 在常规会话中会进行大量工具调用。如果不使用该参数，Copilot 会提示你逐个进行确认。

在 VS Code 中，打开 Copilot Chat 并选择 Squad Agent。

然后输入：

I'm starting a new project. Set up the team.
Here's what I'm building: a recipe sharing app with React and Node.

✓ 验证： Squad 会回复团队成员的提议。输入 yes 进行确认 — 它们已准备就绪。

Squad 会提议一个团队——每个成员都来自一个持久化的主题阵容。你说 yes。它们就开始工作了。

升级

升级 Squad 分为两步。

第 1 步：更新 CLI 二进制文件

npm install -g @bradygaster/squad-cli@latest

第 2 步：更新项目中属于 Squad 的文件

squad upgrade

squad upgrade 会将 squad.agent.md、模板和 GitHub 工作流更新到最新版本。它绝对不会触碰你的 .squad/ 团队状态——你的 Agent、决策和历史记录将始终被保留。

使用 --force 可以在已安装版本匹配最新版本时强制重新应用更新。

本地开发安装

若要从源码安装并运行 Squad 以进行开发，请执行：

# 克隆仓库
git clone https://github.com/bradygaster/squad.git
cd squad

# 安装依赖 (npm workspaces)
npm install

# 构建项目 (先构建 SDK，再构建 CLI)
npm run build

# 直接运行 CLI
node ./packages/squad-cli/dist/cli-entry.js init

# 或者为了方便将其全局链接
npm run dev:link

在执行 npm run dev:link 后，squad 命令将在全局可用，并将使用你的本地构建版本。代码变更后，请重新运行 npm run build 以重新编译。

快速指令

在聊天中输入 "squad commands" 即可查看常用操作的分类菜单，包括安装与升级、团队管理、Issues 与 PRs、插件、模型设置和会话状态。你也可以自然地提问："how do I switch state backends?" 或 "how do I add a team member?" — Squad 会识别你的意图并引导你完成。squad-commands 技能随每次 squad init 和 squad upgrade 自动安装。

全部指令 (17 个指令)

指令	说明
`squad init`	初始化 — 在当前目录搭建 Squad（幂等操作，可安全多次运行）；别名：`hire`；使用 `--global` 在个人 squad 目录初始化，`--mode remote` 用于双根模式
`squad upgrade`	将 Squad 拥有的文件更新至最新；不会触碰你的团队状态；使用 `--global` 升级个人 squad，`--migrate-directory` 用于重命名 `.ai-team/` → `.squad/`