FollowAgents AI AGENTS 目录
首页 / 全部 Agents / Agent Toolkit
开发与工程 coding-assistantsskills-catalogmulti-agent-orchestrationworkflow-loopsmcpgithub-copilotcursor

Agent Toolkit

用一套技能、角色与工作流配置多个主流编程助手。

在 GitHub 查看 ↗ 快速上手 ↓
源仓库
ulises-jeremias/agent-toolkit
Star 数
★ 19
最近更新
今天
License
MIT
主语言
V
FA 评分
71/100 · 存在缺口

30 秒速览

运行形态
命令行工具桌面应用Agent 插件 / 技能
可在哪里用
通用 · 跨平台ChatGPT · Codex · Claude Code
费用
免费，无需付费服务
上手难度
低 · 几分钟可跑通
开始前需要
agent-toolkit 原生 V 二进制文件受支持的 AI 编码助手Shell / 命令行本地文件系统
典型场景
同时使用 Claude Code、Cursor 和 Copilot 的开发团队，希望从同一套技能与角色定义生成各客户端所需配置。
不适合
  • 需要稳定一体化发行版的团队：完整目录包仍属实验性且尚未上架市场
  • 依赖已弃用 profiles/ 目录布局的团队，需迁移到 plugins/ 输出
  • 期望各目标客户端功能完全一致的团队：Cursor、Copilot、OpenCode 收到的产物不同
源码审查
71/100 · 存在缺口

这个 Agent 能做什么，适合哪些场景？

Agent Toolkit 是面向 AI 辅助软件交付的可组合能力与运行时工具箱，并非绑定单一模型的独立聊天机器人。仓库以技能、代理角色、循环工作流、解决方案包、插件和 MCP 模板为主要组件，并用统一目录作为多客户端配置的来源。原生 V CLI 提供安装、环境诊断、清单查询、循环执行和多代理 swarm 编排；桌面应用则提供技能库、操作面板、终端和运行洞察。它可以把内容部署到 Claude Code、Cursor、OpenCode、GitHub Copilot、Windsurf、Pi Agent 和 Muse Code，并提供适用于 ChatGPT/Codex 等客户端的 Agent Plugins 1.0 包。其输出边界主要是本地文件、目标编辑器或助手的原生配置、循环状态与报告，以及由独立工作树和交接记录组成的 swarm 运行目录。

安装流程由 agent-toolkit install 自动检测受支持的编程助手，并把相应技能、角色和配置部署到目标位置；agent-toolkit doctor 检查部署结果。agent-toolkit inventory 从技能、代理和循环目录及目录文件中报告实时清单。技能通过 SKILL.md 定义，角色在 agents/ 中维护，再编译成各客户端的原生格式；插件产品则由 distributions/products.yaml 组合并输出到 plugins/。agent-toolkit loop run daily-triage 等命令执行定期工作流，在循环目录内写入 STATE.md 和 report.md，并按照 L1、L2、L3 阶段限制变更权限。agent-toolkit swarm start 会按配方分配角色和预算，为写入者建立 Git 工作树，以文件系统记录状态、交接、审计和审批，并可通过 watch 查看、通过 promote 进入集成与清理阶段。MCP 子系统提供 GitHub、Slack、Notion、Linear、Figma、ClickUp 和 Chrome DevTools 的注册表及 JSON 模板，但使用者需要自行替换凭据占位符。

  1. 同时使用 Claude Code、Cursor 和 Copilot 的开发团队，希望从同一套技能与角色定义生成各客户端所需配置。
  2. 开源维护者需要按日或每 15 分钟运行问题分类、CI 扫描、依赖更新或 PR 监控，并希望用明确的变更权限等级控制自动化。
  3. 工程负责人需要将规划、架构、实现、评审、测试、安全和平台工作分配给职责清晰的代理角色。
  4. 需要并行交付复杂改动的团队，可用 pair、team 或 full swarm 配方获得独立工作树、预算限制、交接审计和人工审批。
  5. 希望为新项目快速部署 GitHub、Slack、Notion、Linear、Figma、ClickUp 或 Chrome DevTools MCP 配置模板的开发者。
  6. 偏好图形界面的用户，可通过桌面应用管理技能与代理库、查看任务和循环、运行终端并检查活动与成本报告。

如何安装或部署这个 Agent？

推荐安装原生 V CLI。Homebrew 用户可运行：

brew tap ulises-jeremias/homebrew-tap && brew install agent-toolkit
agent-toolkit install
agent-toolkit doctor

Arch Linux 用户可安装发布版二进制包：

yay -S agent-toolkit-bin
agent-toolkit install
agent-toolkit doctor

也可通过 PyPI 的薄启动器安装；它最终执行捆绑的 V 二进制：

uv tool install 'agent-toolkit-cli>=1.30.1'
uvx --from 'agent-toolkit-cli>=1.30.1' agent-toolkit install
agent-toolkit doctor

npm 渠道为：

npm i -g agent-toolkit-cli
agent-toolkit install
agent-toolkit doctor

若使用桌面应用，可让 CLI 下载并启动对应二进制：

agent-toolkit gui --install
agent-toolkit gui

基本技能和本地工作流不要求 MCP 凭据；启用 MCP 模板时，必须在对应 JSON 文件中替换服务凭据占位符。

如何使用这个 Agent？

先确认已检测到的客户端和安装健康状态：

agent-toolkit install
agent-toolkit doctor
agent-toolkit inventory

运行仓库提供的日常分类循环：

agent-toolkit loop run daily-triage

在真正启动前预览双代理配方：

agent-toolkit swarm recipes
agent-toolkit swarm start --recipe pair --dry-run "Add a health check endpoint with tests"

使用 Herdr 后端启动团队配方，并在获得运行 ID 后观察与推进运行：

agent-toolkit swarm start --recipe team --backend herdr "Migrate the auth module"
agent-toolkit swarm watch <run-id>
agent-toolkit swarm promote <run-id>

如果只需要符合 Agent Skills 规范的技能，而不要代理和循环，可运行：

npx skills add ulises-jeremias/agent-toolkit -g

MCP 使用方式是从 mcp/templates/ 选择服务模板，将其中凭据占位符替换为真实值，再放入目标客户端的 MCP 配置位置。

这个 Agent 有哪些优点和局限？

优点
  • 以一套技能和角色目录服务多个编程助手，减少为 Claude Code、Cursor、Copilot 等客户端分别维护提示配置的重复工作。
  • 循环采用 L1 只读提议、L2 受控写入和 L3 高自治的变更安全阶段，并由门控机制限制合并、关闭等高风险动作。
  • swarm 内置角色配方、令牌/费用/时长预算、独立 Git 工作树、交接审计、阻塞反馈轮次和人工审批。
  • 同时提供原生 CLI、桌面 GUI、Agent Plugins 1.0 包、传统 Claude Code 插件以及多种系统安装渠道。
  • 技能、代理、循环和插件产品拥有明确的源目录、生成目录及验证命令，适合需要可审计配置供应链的团队。
局限
  • 产品范围较大，包含技能、角色、循环、插件、MCP、桌面端和 swarm；只需要少量提示模板的团队可能承担不必要的配置与治理成本。
  • 不同客户端接收的产物并不相同，例如 Cursor 使用插件或 .mdc 规则，Copilot 使用指令文件，OpenCode 使用提示覆盖和代理配置，因此跨客户端仍可能存在功能差异。
  • profiles/ 已被标记为弃用的安装覆盖层，正在采用旧配置路径的团队需要迁移到以 plugins/ 为规范输出的结构。
  • MCP 模板不会自动提供服务权限，使用 GitHub、Slack、Notion、Linear、Figma、ClickUp 等集成时仍需准备并保护相应凭据。
  • agent-toolkit-complete 被标为实验性且尚未进入市场，依赖完整目录分发的团队应评估其发布成熟度。

这个 Agent 与同类方案有什么区别？

与 classic tmux swarm 相比，agent-toolkit swarm 使用单个约 22 MB 的 V 二进制，内置 pair、team、full 配方、预算强制、JSON 接口和跨平台发布；tmux 方案依赖 bash、tmux、bb 和仪表盘，但同样具备按分支配置和交接审计。与仓库所称的旧版 Python swarm 相比，新实现补充了预算限制、正式交接审计、结构化可观测性和程序化 JSON 接口，同时避免 Python 环境依赖。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Agent Toolkit 当前 71 · 存在缺口 命令行工具免费 ★ 19 今天 V ChatGPT · Codex · Claude Code
Agentic Plugin Marketplace 70 · 存在缺口 Agent 插件 / 技能免费 + 模型费 ★ 42k 今天 Python Codex · Claude Code
Agor 68 · 存在缺口 命令行工具免费 + 模型费 ★ 1.5k 2 天前 TypeScript Codex · Claude Code
Agency Agents 中文专家库 48 · 缺口较多 命令行工具免费 + 模型费 ★ 22k 5 天前 Shell Codex · Claude Code

FollowAgents 如何评估这个 Agent？

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

材料展示了明确的权限边界：服务默认仅绑定 localhost，远程访问要求显式开关与令牌，破坏性路由要求确认；Swarm 文档也说明 worktree 和角色策略不是操作系统沙箱。安装提供 dry-run，卸载说明备份及清理步骤，MCP 模板要求环境变量占位符。不过桌面终端和 Swarm runner 可触及本机权限，材料未具体展示产品级确认如何覆盖所有外部副作用；publisher provenance 未验证，不能确认维护者身份。

可靠稳定6 / 14 · 2.1/5

仓库描述了校验流程、CI 与有界关闭行为，安全文档也明确测试覆盖范围有限。但 Swarm 安全文档内部对 Claude adapter 是否使用 --dangerously-skip-permissions 存在直接矛盾，且示例依赖多个外部工具和服务；所给材料不足以证明依赖可用性。失败路径和服务启动失败可见性有所说明，因此失败信息得分较高。

适用触发16 / 18 · 4.4/5

目标用户、支持场景和多种编码助手适配路径描述充分。材料明确区分 skills、agents、loops、products、packs 与 profile，并详述循环自主等级、MCP/工具边界及桌面/CLI用途。Skill 的触发词有具体例子，但样本覆盖有限，不能据此认定全目录触发都精准。

规范维护16 / 18 · 4.4/5

文档信息架构详尽，安装、卸载、迁移相关路径和示例充分，且明确列出限制、权限模型和清理风险；MIT 许可证清晰。包与插件版本有标记，但所给材料未提供发布历史或完整维护责任与更新承诺，维护者身份也未经验证。

有效结果10 / 13 · 3.8/5

工具提供跨助手复用技能、角色、循环和 MCP 模板，并以统一目录、原生 CLI、GUI 和 dry-run 等方式提升可用性。功能覆盖广且具有明显整合价值；但样本不足以静态判断普通用户实际产出质量，安装和配置 Swarm/MCP 等功能的成本也较高。

证据核验6 / 8 · 3.8/5

README 的核心产品说法可由安装指南、插件清单、技能样本、桌面代码和安全文档互相参照；安全材料区分声明、实现边界和未验证事项，技能也要求证据引用并标注置信度。证据仍是文件样本且没有运行验证，因此仅给中等来源追踪与交叉印证分。

风险与缓解建议
  • Swarm 安全文档对 Claude adapter 是否启用 --dangerously-skip-permissions 的描述互相矛盾；采用前应以当前实现和运行配置核实。
  • Swarm runner、集成终端及 MCP 可接触本机权限或外部服务；角色策略和 worktree 不构成沙箱，运行前应审查权限与凭据传递。
  • publisher 身份未经验证；材料是静态样本，不能据此确认运行行为、依赖状态或完整目录覆盖。
证据充分度：低 评估于 2026年11月8日 审查版本 3b945999d51d 评估后仓库已有新提交，评分可能未覆盖最新改动
评估证据 README.md.claude-plugin/marketplace.jsonAGENTS.mdreview/SKILL.mdmcp-audit/SKILL.mdowasp-agentic-review/SKILL.mdsupply-chain-audit/SKILL.mddocs/SWARM_SECURITY.mdadrs/ADR-028-server-security-defaults.mddocs/INSTALLATION.mddocs/UNINSTALL.mdadrs/0003-pack-semantics-products-own-installation.mdelectron/main.tsLICENSESECURITY.mdpackage.jsonworkflows/clean-machine-acceptance.ymlworkflows/codeql.ymltests/site.spec.ts
查看完整评分方法 →
你是这个项目的维护者？把 FARS 徽章加到 README

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

FARS

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

最近版本

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

  1. v1.48.0
    发布说明摘录
    What's Changed * feat(swarm): record bound People as canonical PersonSessions on real role starts by @ulises-jeremias in https://github.com/ulises-jeremias/agent-toolkit/pull/1609 * fix(swarm): reconcile orphaned PersonSessions on terminal run states by @ulises-jeremias in https://github.com/ulises-jeremias/agent-toolkit/pull/1611 * fix(desktop): send explicit JSON object body for bodyless mutations by @ulises-jeremias in https://github.com/ulises-jeremias/agent-toolkit/pull/1612 …
    在 GitHub 查看 ↗
  2. v1.47.6
    发布说明摘录
    What's Changed * docs(web): refresh site screenshots + demo from Desktop 1.47.4 by @ulises-jeremias in https://github.com/ulises-jeremias/agent-toolkit/pull/1586 * chore(deps): bump the codeql-action group with 2 updates by @dependabot[bot] in https://github.com/ulises-jeremias/agent-toolkit/pull/1578 * chore(release): prepare v1.47.5 by @ulises-jeremias in https://github.com/ulises-jeremias/agent-toolkit/pull/1587 * fix(people): import canonical Munder hire fields without silent loss by @ulises-jeremias in https://github.com/ulises-jeremias/agent-toolkit/pull/1589 …
    在 GitHub 查看 ↗
  3. v1.47.4
    发布说明摘录
    What's Changed * fix(world): neon place glow for Cyberpunk City by @ulises-jeremias in https://github.com/ulises-jeremias/agent-toolkit/pull/1584 * chore(release): prepare v1.47.4 by @ulises-jeremias in https://github.com/ulises-jeremias/agent-toolkit/pull/1585 Full Changelog: https://github.com/ulises-jeremias/agent-toolkit/compare/v1.47.3...v1.47.4
    在 GitHub 查看 ↗

常见问题

必须连接某个特定模型供应商吗？
不必。仓库把能力编译或部署到多个编程助手，并提供可移植的 Agent Plugins 1.0 包；但各客户端支持的原生产物与功能可能不同。
运行自动化循环会直接修改或合并代码吗？
取决于循环阶段。L1 仅观察或提出建议，L2 只允许标签、评论和有限维护等白名单写入，L3 只有在明确许可时才可包含合并或关闭操作。
使用 MCP 是否需要额外权限？
需要。模板带有明确的凭据占位符，连接 GitHub、Slack、Notion、Linear、Figma、ClickUp 或 Chrome DevTools 时必须配置对应服务访问权限。
能否只安装技能而不采用完整运行时？
可以。npx skills add ulises-jeremias/agent-toolkit -g 安装符合 Agent Skills 规范的技能，但不包含代理角色和循环。
如何发现安装或配置失败？
运行 agent-toolkit doctor 检查消费者环境；仓库贡献者还可运行 ./scripts/validate-skills.vsh 和 ./scripts/validate-loops.vsh，失败时会以非零状态退出并给出可读错误。
这页内容对你有帮助吗？
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

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

开源编程 Agent 横向对比

按 FARS 评审排序的开源编程 agent——分数、信任、许可证、语言与维护状态并排比较，并说明各自擅长与不擅长什么。

Claude Code Agent 横向对比

完整兼容 Claude Code 的 agent，按 FARS 评审排序——兼容性取自各 agent 自己的 AGENTS.md 与文档，不做推测。

MCP Agent 横向对比

提供或调用 Model Context Protocol 服务的 agent，按 FARS 评审排序，并列出许可证、维护状态与信任分。