Agents Squads
用持久记忆、验证与反馈循环协调多模型 AI 团队。
- Star 数
- ★ 56
- 最近更新
- 1 个月前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 63/100 · 存在缺口
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Claude Code
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 工程负责人希望让规划者、实现者和验证者围绕同一目标协作,并在 Git 中保留可审计状态。
- 不适合
- 无法安装 Claude Code 的团队
- 需要免 Git、免文件系统状态管理的团队
- 寻找托管式无服务器平台的用户
- 官网
- agents-squads.com ↗ 来自 GitHub 仓库设置
- 维护状态
- 近半年有提交最近提交 2026-10-20最新版本 v0.10.1(2026-10-20)
- 源码审查
- 63/100 · 存在缺口
这个 Agent 能做什么,适合哪些场景?
Agents Squads 是一个用 TypeScript 构建的命令行框架,用于组织承担工程、营销、财务和运营工作的 AI agent 团队。它把业务背景、系统规则、团队身份、目标、学习记录和反馈保存为 Git 仓库中 .agents/ 目录下的 Markdown 文件,不需要数据库、服务器或专用 DSL。每次运行前,系统会按角色加载由公司战略、团队目标、上一轮反馈和当前工作组成的上下文级联,然后由负责人规划、执行者工作、验证者检查结果。CLI 可调用 claude、gemini、aider 等原生 AI 命令行工具,并支持为不同 agent 选择不同模型。用户通过 squads run 发起团队或定向任务,通过 squads inbox 处理需要人工批准、拒绝或延后的事项;状态、记忆、目标、反馈和仪表板也属于仓库描述所列的管理范围。它完全在用户机器上运行,状态和审计轨迹由本地文件与 Git 承载,但需要 Node.js、Git、Claude Code 以及相应 AI 提供商的凭据。
运行时,Squads 从 .agents/BUSINESS_BRIEF.md 读取业务背景,从 .agents/config/SYSTEM.md 读取共享规则,从 .agents/squads/ 读取 SQUAD.md 和各 agent 的 Markdown 定义,并从 .agents/memory/ 读取战略、目标、学习记录与反馈。它根据角色组装上下文级联,让扫描型角色获得较轻的上下文,让负责人获得更完整的信息。squads run research 执行规划、工作、评审和验证组成的团队对话;squads run intelligence --task "Scan X" 发起有明确边界的定向任务。执行阶段会 shell out 到 claude、gemini、aider 等原生 AI CLI,因此不同角色可以路由到不同模型。每轮反馈会注入下一轮,团队状态则继续保存在 Markdown 文件和 Git 历史中;squads inbox 汇总等待用户批准、拒绝或延后的决策。
- 工程负责人希望让规划者、实现者和验证者围绕同一目标协作,并在 Git 中保留可审计状态。
- 研究团队需要先用成本较低的模型扫描信息,再交给推理能力更强的模型处理,并由另一模型复核。
- 营销或运营负责人希望把业务背景和团队目标放入持久记忆,减少 agent 在不同运行之间重复工作。
- 本地优先的团队希望在自己的机器和 API 密钥范围内运行多 agent 工作流,不部署数据库或服务器。
- 需要人工治理的管理者希望集中查看待决事项,并使用
squads inbox批准、拒绝或延后处理。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm install -g squads-cli
- 运行环境
- Node.js 20
如何安装或部署这个 Agent?
先安装 Node.js 20 或更高版本、Git 和 Claude Code。Claude Code 必须已经安装并通过 claude /login 登录;其他提供商为可选项。随后安装 CLI 并初始化一个 Git 工作目录:
npm install -g squads-cli
mkdir my-workforce && cd my-workforce
git init
squads init
squads run demo hello-world可以运行以下检查来确认机器满足要求:
squads doctor如果要从源码开发,则使用:
git clone https://github.com/agents-squads/squads-cli.git
cd squads-cli
npm install
npm run build && npm link
npm test如何使用这个 Agent?
完成初始化和演示运行后,可启动第一个实际 agent:
squads run research/analyst运行完整 research 团队对话,其流程包括规划、执行、评审和验证:
squads run research为 intelligence 团队提交一个有边界的任务:
squads run intelligence --task "Scan X"查看等待人工决策的事项:
squads inbox团队定义、业务背景、规则和记忆均位于 .agents/ 中,可通过 Markdown 文件和 Git 工作流进行管理。
这个 Agent 有哪些优点和局限?
- 用 Markdown 和 Git 同时承载状态与审计轨迹,不需要数据库、常驻服务器或专用 DSL。
- 明确提供负责人、执行者和验证者组成的规划—工作—评审—验证闭环,并将每轮反馈注入下一轮。
- 可 shell out 到
claude、gemini、aider等原生 CLI,为不同角色组合不同模型。 - 上下文级联会按角色调整载入内容,兼顾轻量扫描任务和需要完整背景的负责人任务。
- 数据、密钥和运行环境留在用户机器上,且项目声明不要求登录其自有云服务或发送遥测。
- 首次运行明确依赖 Claude Code 已安装并登录,即使项目也支持其他可选提供商。
- 需要 Node.js 20 以上、Git、本地文件系统和 AI 提供商凭据,设置复杂度高于单一托管式聊天产品。
- 状态以 Markdown 和 Git 管理;需要数据库事务、集中式服务状态或无 Git 工作流的团队需要改变现有流程。
- 混合模型运行依赖多个外部原生 CLI,各提供商的安装、认证和使用成本仍需用户自行承担。
- 来源没有给出仪表板的具体启动命令、界面形式或部署方式,因此无法据此评估其成熟度。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Agents Squads 当前 | 63 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 56 | 1 个月前 | TypeScript | Claude Code |
| AI DevOps 框架(aidevops) | 63 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 468 | 今天 | Shell | OpenAI API · Claude API |
| Manifold | 55 · 缺口较多 | 自托管服务免费 | ★ 504 | 1 个月前 | Go | OpenAI API · Claude API |
| VCP ToolBox | 50 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 2.5k | 今天 | JavaScript | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
文档说明默认工具链有限,并按 agent 配置额外工具;inbox 决策、PR gate、超时和预算上限体现确认与约束。README 和配置文档说明本地存储、匿名遥测字段及退出方式,也给出密钥和提交推送规则。扣分原因:agent 仍可运行命令,文档建议而非证明沙箱隔离;遥测目的地及传输细节未说明;安全建议不等于加密或强制权限控制;源码样本未展示依赖漏洞审计结果。Git worktree、自动保存和 opt-in 提交推送有恢复线索,但恢复具体流程未充分说明。作者和维护联系可见,但发布者身份未验证,不能据此认定其身份。
文档、包配置和测试材料共同展示 Node 20+、原生 AI CLI 依赖、CI lint/typecheck/build/test 与安装冒烟流程,也有缺失 CLI 时设置非零退出码的源契约测试。扣分原因:README 示例称本地提交且不推送,其他文档也解释 opt-in 自动提交;但 seed skill 声称每次运行都在独立 worktree 且绝不产生工作树散改,给出的材料未充分化解这些表述间的范围差异。外部 CLI/API 可用性取决于用户环境,静态材料无法证明运行成功。
README、配置文档和 skill 覆盖人类操作者、agents、多个业务领域及 Claude/Gemini 等 provider;提供 task、dry-run、timeout、budget、provider、tool grants 和本地默认说明。扣分原因:主要面向 Node、Git 与终端用户;对非技术使用者及不支持原生 CLI 环境的边界说明有限,工具可配置也意味着能力随配置扩张。
仓库指引、README、配置文档、包元数据和安全策略提供可识别的结构、安装开发命令、示例、MIT 正文及漏洞报告渠道。扣分原因:部分命令示例在所给 skill 片段中不完整,FAQ 较少;0.x 版本和包版本可见,但材料未给出变更历史;AGENTS.md 明确是贡献者指南而非产品运行规范,产品说明主要分散于 README、docs 和模板。
CLI 以状态、memory、goals、feedback、inbox 和 dashboard 管理 agent squad;JSON 输出、reviewable artifacts、成本/超时限制和多 provider 编排显示了面向自动化及人工决策的实际价值。扣分原因:效用和成本节省主要由文档主张,样本没有独立结果证据;依赖多个本机 CLI 和配置会增加安装维护成本。
具体功能主张可在 README、配置文档、package.json、seed skill、CI 配置和测试源码之间找到对应材料;CI 声明覆盖测试流程,测试文件展示部分断言。扣分原因:本次是静态样本审查,CI 配置和测试源码不能证明本修订实际通过;某些产品效果主张没有独立佐证,区分了文件直接陈述与由文档推得的判断。
- 运行前请检查 agent 定义、授予的工具和可用凭证;文档指出 agent 可执行系统命令,安全隔离取决于部署环境。
- 将项目级和用户级 .env、memory 文件视为敏感数据;文档建议忽略 .env、限制文件权限并谨慎处理 memory。
- 自动推送会推送当前分支上的其他未推送提交;启用前请核对分支状态。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
What's Changed * release: v0.10.1 — security patch by @agents-squads[bot] in https://github.com/agents-squads/squads-cli/pull/1326 Full Changelog: https://github.com/agents-squads/squads-cli/compare/v0.10.0...v0.10.1在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * release: v0.10.0 by @agents-squads[bot] in https://github.com/agents-squads/squads-cli/pull/1286 Full Changelog: https://github.com/agents-squads/squads-cli/compare/v0.9.0...v0.10.0在 GitHub 查看 ↗ -
发布说明摘录
What's Changed * release: v0.9.0 — the loop release by @kokevidaurre in https://github.com/agents-squads/squads-cli/pull/1033 Full Changelog: https://github.com/agents-squads/squads-cli/compare/v0.8.3...v0.9.0在 GitHub 查看 ↗
常见问题
软件本身收费吗?
可以完全不用 Claude Code 吗?
claude /login 登录。虽然系统还能调用 Gemini、Aider 等 CLI,但来源没有说明可完全移除这一初始依赖。它需要数据库或后台服务器吗?
运行数据会发送到项目方的云端吗?
如何发现环境或登录问题?
squads doctor。它会检查机器环境和 Claude Code,并指出缺少的组件;来源没有进一步列出所有故障恢复行为。Agents Squads 官网是什么?
Agents Squads 开源吗?
Agents Squads 安全吗?
Agents Squads 还在维护吗?
Agents Squads 是谁开发的?
谢谢反馈,我们会据此改进页面。