Squad

为任何项目打造 AI 智能体团队。 一条命令即可实现。一个能随代码共同成长的团队。

⚠️ Alpha 版本软件 — Squad 目前处于实验阶段。API 和 CLI 命令在不同版本间可能会有变化。我们将会在 CHANGELOG.md 中记录重大变更。

什么是 Squad？

Squad 通过 GitHub Copilot 为你提供一支 AI 开发团队。只需描述你正在构建的内容，即可获得一支由前端、后端、测试、负责人组成的专家团队，它们以文件形式存在于你的代码库中。它们能在不同会话中保持状态、学习你的代码库、共享决策，并随着你的使用而不断进步。

它不仅仅是一个披着“角色”外壳的聊天机器人。每个团队成员都在其独立的上下文环境中运行，只读取自己的知识库，并将学习到的内容记录下来。

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

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

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

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

gh auth login

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

copilot --agent squad --yolo

为什么要用 --yolo？ Squad 在常规会话中会进行多次工具调用。如果不加此参数，Copilot 会提示你逐个批准每项调用。

在 VS Code 中，打开 Copilot Chat 并选择 Squad 智能体。

然后输入：

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 分为两步。

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

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

第二步：更新项目中 Squad 所属的文件

squad upgrade

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

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

命令	功能描述
`squad init`	初始化 — 在当前目录搭建 Squad（幂等操作 — 可多次运行）；别名：`hire`；使用 `--global` 可在个人 squad 目录初始化，`--mode remote` 可开启双根模式
`squad upgrade`	将 Squad 相关文件更新至最新；绝不触碰团队状态；使用 `--global` 可升级个人 squad，`--migrate-directory` 可将 `.ai-team/` 重命名为 `.squad/`
`squad status`	显示当前活动的 squad 及其原因
`squad triage`	监控 issue 并自动分发给团队（别名：`watch`, `loop`）；使用 `--interval` 设置轮询频率（默认为 10）
`squad copilot`	添加/移除 Copilot 编码智能体 (@copilot)；使用 `--off` 移除，`--auto-assign` 启用自动分配
`squad doctor`	检查配置并诊断问题（别名：`heartbeat`）
`squad link <remote>`	连接到远程团队
`squad shell`	显式启动交互式 shell
`squad export`	将 squad 导出为便携式 JSON 快照
`squad import <file>`	从导出文件导入 squad
`squad plugin marketplace add\|remove\|list\|browse`	管理插件市场
`squad upstream add\|remove\|list\|sync`	管理上游 Squad 来源
`squad nap`	上下文清理 — 压缩、修剪、归档；使用 `--deep` 进行深度压缩，`--dry-run` 预览变更
`squad aspire`	打开 Aspire 仪表盘以进行可观测性查看
`squad scrub-emails [directory]`	从 Squad 状态文件中移除电子邮件地址（默认：`.squad/`）

厌倦了每次都输入 squad 加命令？试试交互式 shell。

squad

无需参数，直接输入 squad。你将看到提示符：

squad >

你现在已经连接到你的团队了。开始与他们交流吧。

所有 shell 命令均以 / 开头：

使用 @AgentName（不区分大小写）或通过逗号分隔的自然语言：

squad > @Keaton, analyze the codebase.