Agents Squads

用持久记忆、验证与反馈循环协调多模型 AI 团队。

Star 数
★ 56
最近更新
1 个月前
License
MIT
主语言
TypeScript

30 秒速览

运行形态
命令行工具开发框架
可在哪里用
通用 · 跨平台Claude Code
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Node.js >= 20GitClaude CodeAI 提供商 API 密钥Shell / 命令行网络访问本地文件系统
典型场景
工程负责人希望让规划者、实现者和验证者围绕同一目标协作,并在 Git 中保留可审计状态。
不适合
  • 无法安装 Claude Code 的团队
  • 需要免 Git、免文件系统状态管理的团队
  • 寻找托管式无服务器平台的用户
官网
agents-squads.com ↗ 来自 GitHub 仓库设置
维护状态
近半年有提交最近提交 2026-10-20最新版本 v0.10.1(2026-10-20)

这个 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 汇总等待用户批准、拒绝或延后的决策。

  1. 工程负责人希望让规划者、实现者和验证者围绕同一目标协作,并在 Git 中保留可审计状态。
  2. 研究团队需要先用成本较低的模型扫描信息,再交给推理能力更强的模型处理,并由另一模型复核。
  3. 营销或运营负责人希望把业务背景和团队目标放入持久记忆,减少 agent 在不同运行之间重复工作。
  4. 本地优先的团队希望在自己的机器和 API 密钥范围内运行多 agent 工作流,不部署数据库或服务器。
  5. 需要人工治理的管理者希望集中查看待决事项,并使用 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?

FollowAgents 源码审查 · FARS-2.1
存在缺口
63/ 100 五分制 3.2 / 5
信任安全 18/29
可靠稳定 8/14
适用触发 12/18
规范维护 11/18
有效结果 9/13
证据核验 5/8
查看各维度的扣分理由
信任安全18 / 29 · 3.1/5

文档说明默认工具链有限,并按 agent 配置额外工具;inbox 决策、PR gate、超时和预算上限体现确认与约束。README 和配置文档说明本地存储、匿名遥测字段及退出方式,也给出密钥和提交推送规则。扣分原因:agent 仍可运行命令,文档建议而非证明沙箱隔离;遥测目的地及传输细节未说明;安全建议不等于加密或强制权限控制;源码样本未展示依赖漏洞审计结果。Git worktree、自动保存和 opt-in 提交推送有恢复线索,但恢复具体流程未充分说明。作者和维护联系可见,但发布者身份未验证,不能据此认定其身份。

可靠稳定8 / 14 · 2.9/5

文档、包配置和测试材料共同展示 Node 20+、原生 AI CLI 依赖、CI lint/typecheck/build/test 与安装冒烟流程,也有缺失 CLI 时设置非零退出码的源契约测试。扣分原因:README 示例称本地提交且不推送,其他文档也解释 opt-in 自动提交;但 seed skill 声称每次运行都在独立 worktree 且绝不产生工作树散改,给出的材料未充分化解这些表述间的范围差异。外部 CLI/API 可用性取决于用户环境,静态材料无法证明运行成功。

适用触发12 / 18 · 3.3/5

README、配置文档和 skill 覆盖人类操作者、agents、多个业务领域及 Claude/Gemini 等 provider;提供 task、dry-run、timeout、budget、provider、tool grants 和本地默认说明。扣分原因:主要面向 Node、Git 与终端用户;对非技术使用者及不支持原生 CLI 环境的边界说明有限,工具可配置也意味着能力随配置扩张。

规范维护11 / 18 · 3.1/5

仓库指引、README、配置文档、包元数据和安全策略提供可识别的结构、安装开发命令、示例、MIT 正文及漏洞报告渠道。扣分原因:部分命令示例在所给 skill 片段中不完整,FAQ 较少;0.x 版本和包版本可见,但材料未给出变更历史;AGENTS.md 明确是贡献者指南而非产品运行规范,产品说明主要分散于 README、docs 和模板。

有效结果9 / 13 · 3.5/5

CLI 以状态、memory、goals、feedback、inbox 和 dashboard 管理 agent squad;JSON 输出、reviewable artifacts、成本/超时限制和多 provider 编排显示了面向自动化及人工决策的实际价值。扣分原因:效用和成本节省主要由文档主张,样本没有独立结果证据;依赖多个本机 CLI 和配置会增加安装维护成本。

证据核验5 / 8 · 3.1/5

具体功能主张可在 README、配置文档、package.json、seed skill、CI 配置和测试源码之间找到对应材料;CI 声明覆盖测试流程,测试文件展示部分断言。扣分原因:本次是静态样本审查,CI 配置和测试源码不能证明本修订实际通过;某些产品效果主张没有独立佐证,区分了文件直接陈述与由文档推得的判断。

风险与缓解建议
  • 运行前请检查 agent 定义、授予的工具和可用凭证;文档指出 agent 可执行系统命令,安全隔离取决于部署环境。
  • 将项目级和用户级 .env、memory 文件视为敏感数据;文档建议忽略 .env、限制文件权限并谨慎处理 memory。
  • 自动推送会推送当前分支上的其他未推送提交;启用前请核对分支状态。
证据充分度:低 评估于 2026年11月8日 审查版本 db96bb905cd9
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/squads-cli.svg?lang=zh)](https://followagents.com/zh/agents/squads-cli)
<a href="https://followagents.com/zh/agents/squads-cli"><img src="https://followagents.com/badge/squads-cli.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.10.1
    发布说明摘录
    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 查看 ↗
  2. v0.10.0
    发布说明摘录
    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 查看 ↗
  3. v0.9.0
    发布说明摘录
    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 查看 ↗

常见问题

软件本身收费吗?
仓库采用 MIT 许可证。运行时需要用户自己的 AI 提供商凭据,因此仍可能产生模型、API 或 Claude Code 相关费用;来源未列出具体价格。
可以完全不用 Claude Code 吗?
现有快速开始明确要求在首次运行前安装 Claude Code 并通过 claude /login 登录。虽然系统还能调用 Gemini、Aider 等 CLI,但来源没有说明可完全移除这一初始依赖。
它需要数据库或后台服务器吗?
不需要。业务背景、规则、团队定义和记忆均保存为 Git 仓库中的 Markdown 文件,README 明确说明没有数据库或服务器。
运行数据会发送到项目方的云端吗?
项目声明所有内容在本机运行,不需要其自有登录或云服务,也没有遥测;但调用外部 AI 提供商 CLI 时,数据处理仍受相应提供商机制约束。
如何发现环境或登录问题?
运行 squads doctor。它会检查机器环境和 Claude Code,并指出缺少的组件;来源没有进一步列出所有故障恢复行为。
Agents Squads 官网是什么?
Agents Squads 的 GitHub 仓库填写的官网是 https://agents-squads.com。这个链接由仓库作者设置;源码在 GitHub(agents-squads/squads-cli)。
Agents Squads 开源吗?
开源。源码在 GitHub(agents-squads/squads-cli),许可证是 MIT。
Agents Squads 安全吗?
FollowAgents 的 FARS 评审(2026年11月8日)给 Agents Squads 的“信任与安全”打了 18/29 分。评审检查的 8 项安全措施没有完全缺失的。
Agents Squads 还在维护吗?
更新变慢了:GitHub 上最近一次提交是 2026-10-20,在最近半年内,但不在最近 30 天内。最新版本是 v0.10.1(2026-10-20)。
Agents Squads 是谁开发的?
Agents Squads 由 GitHub 账号 agents-squads 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念