首页 Agency Agents 速查
2.3.4 2026-06-30 msitarzewski/agency-agents
打开 Zread CodeWiki
340px

快速定位

目标最短入口适合你在干什么
直接装好并保持更新Agency Agents app不想 clone，不想手动复制文件，只想点几下就装到本地工具里
只给 Claude Code 装一批角色./scripts/install.sh --tool claude-code你已经在用 Claude Code，想把整套 team 直接装进 ~/.claude/agents/
只装某几个 division./scripts/install.sh --tool claude-code --division engineering,security想让不同业务线分开投放，不想把所有角色都塞进去
只装少数几个 agent./scripts/install.sh --tool cursor --agent frontend-developer,ui-designer你知道自己要哪几个专家，想做最小集成
先生成所有转换产物./scripts/convert.sh你要先把 source .md 转成各工具目标格式

一句话判断

  • 想要“直接用”：选 app。
  • 想要“可控地安装”：选脚本。
  • convert.sh + install.sh：选 。

这个仓库到底是什么

  • 这是一个 角色库：每个 agent 都是领域专家，不是通用 prompt 模板。
  • 这是一个 分队系统：按 division 管理不同能力线。
  • 这是一个 安装系统：可以把角色复制到 Claude Code、Cursor、Codex、Gemini CLI、OpenCode、Qwen、Osaurus、Hermes 等环境。
  • 这是一个 桌面产品：app 可以浏览全 roster，并把角色自动安装到对应工具里。

关键事实

  • 118,899
  • 19,471
  • 许可证：MIT
  • 16
  • 14
  • main

最短工作流

1) 推荐路径：先看 app

如果你希望“浏览 roster + 一键安装 + 自动更新”，先从 app 走。
# 去官网或 GitHub release 下载
open https://agencyagents.app
# 或直接打开 latest release
open https://github.com/msitarzewski/agency-agents-app/releases/latest

2) 只装 Claude Code

cd /path/to/agency-agents
./scripts/install.sh --tool claude-code

3) 只装部分 division

./scripts/install.sh --tool claude-code --division engineering,security

4) 只装单个 agent

./scripts/install.sh --tool cursor --agent frontend-developer

5) 先转换，再安装

./scripts/convert.sh
./scripts/install.sh --tool opencode --division engineering

角色库怎么分

你可以把它理解成“按业务线分队”

Division典型用途适合放进队伍里的角色类型
engineering产品开发主战场前端、后端、移动端、AI 工程
design设计与交互UI、视觉、信息架构
product产品定义与推进需求、PRD、路线图、优先级
project-management任务推进与协作计划、拆解、节奏、风险控制
security安全审查与防护安全分析、红队、审计
testing质量验证QA、回归、测试策略
support用户支持FAQ、工单、答疑、排障
marketing内容与传播叙事、活动、内容分发
paid-media投放增长广告、归因、转化优化
sales销售支持线索、话术、成交辅助
finance财务与分析预算、分析、报表
game-development游戏制作游戏设计、实现、测试
gis地理信息空间数据、地图、路线
spatial-computing空间计算XR、3D、沉浸式交互
academic学术研究文献、综述、实验设计
specialized其它垂直专家细分场景的特殊角色

engineering 里最容易先用上的角色

README 里直接点名了这些角色类型：
  • Frontend Developer
  • Backend Architect
  • Mobile App Builder
  • AI Engineer
如果你只想先把生产力拉起来，通常先装 engineering，再按需叠加 security / testing / product。

工具选择矩阵

哪个工具装什么

工具安装形态典型去处备注
Claude Codeper-agent~/.claude/agents/最直接的 agent 投放目标之一
Codexper-agent~/.codex/agents/*.toml走 TOML 代理文件
Gemini CLIper-agent~/.gemini/agents/直接是 .md 角色文件
Copilotper-agent~/.github/agents/ / ~/.copilot/agents/兼容 GitHub Copilot 生态
Qwenper-agent~/.qwen/agents/user-wide 或 project 皆可
Cursorper-agent.cursor/rules/*.mdcproject-only
OpenCodeper-agent.opencode/agents/注意数量上限
Osaurusper-agent~/.osaurus/skills/以 Skill 目录形式安装
AiderrosterCONVENTIONS.md不是单个 agent，而是一份整体现约
Windsurfroster.windsurfrules也是整份规则文件
Antigravityper-agent~/.gemini/antigravity/skills/技能形式
OpenClawper-agent~/.openclaw/agency-agents/workspace 形态
Hermesplugin~/.hermes/plugins/不是 agent 文件，而是插件
Kimiper-agent~/.config/kimi/agents/目录化 agent 文件

快速选择原则

  • install.sh：先看 的工具名。
  • 想保留项目级规则：选 Cursor / OpenCode / Windsurf 这类 project 目标。
  • 想做用户级长驻安装：选 Claude Code / Codex / Gemini / Qwen / Osaurus / Hermes。
  • 想做插件而不是 agent：选 Hermes。

高频 recipes

Recipe 1：把整套工程队塞进 Claude Code

./scripts/install.sh --tool claude-code --division engineering
适合：前端、后端、移动端、AI 工程的统一投放。

Recipe 2：工程 + 安全双队列

./scripts/install.sh --tool claude-code --division engineering,security
适合：你要一边开发一边做安全审查，不想把测试、市场、销售也混进来。

Recipe 3：只给 Cursor 装少量角色

./scripts/install.sh --tool cursor --agent frontend-developer,backend-architect
适合：项目里只需要几个明确的 rule 文件。

Recipe 4：OpenCode 先控制规模

./scripts/install.sh --tool opencode --division engineering
适合：你知道 OpenCode 对可注册 agent 数量有上限，不想一把装满。

Recipe 5：先转换，再精挑工具

./scripts/convert.sh
./scripts/install.sh --tool codex --division product,project-management
适合：你先把所有格式化产物准备好，再针对特定工具下发。

Recipe 6：Hermes 插件投放

./scripts/install.sh --tool hermes --division engineering
适合：你不是在装“文件”，而是在给 Hermes 装 lazy-router 插件。

你最该记住的坑

1) OpenCode 有数量上限

README 明确提示：OpenCode 当前大约只能稳定注册 ~119 个 agents，过多会被静默丢掉。结论：装 OpenCode 时，优先选分组子集，不要全量铺开。

2) 不同工具的“安装形态”不一样

有些是 per-agent，有些是 roster，有些是 plugin。结论：不要把所有目标都当成“复制一堆 md 文件”这么简单。

3) convert.sh 和 install.sh 分工不同

  • convert.sh：生成各工具需要的中间产物
  • install.sh：把产物放到真正的目标目录
结论：如果你缺的是目标格式，先 convert；如果你缺的是最终落地，跑 install。

4) app 和脚本不是互斥

app 适合浏览和一键安装，脚本适合精确控制。结论：先 app 认路，再脚本精装，通常是最省时间的路。

极简决策树

要看 roster / 一键装 / 自动更新？ → app
要自己控制安装目标？ → scripts/install.sh
要先生成所有工具格式？ → scripts/convert.sh
只想给 Claude Code 用？ → --tool claude-code
只想给某几个队伍用？ → --division
只想要几个 agent？ → --agent

什么时候最适合这个仓库

  • 你在做 AI coding agents 的分工协作
  • 你要把 角色库投喂给不同编辑器 / CLI
  • 你想把一个“大角色仓库”缩成 可安装、可筛选、可更新 的系统
  • 你不是要一个 prompt，而是要一整套可复用的 agent roster

相关路径

  • README.md：项目总说明、app、快速上手
  • scripts/install.sh --tool / --division / --agent：安装入口，支持
  • scripts/convert.sh：转换入口
  • divisions.json：division 结构与安装规则来源
  • tools.json：支持工具的来源真值表
  • engineering/：工程角色目录
  • security/：安全角色目录
  • product/：产品角色目录
  • project-management/：项目推进角色目录

一句话总结

Agency Agents = 一个可浏览、可筛选、可安装的 AI 专家团队仓库。它的核心不是“有很多 agent”，而是“能把合适的 agent 装到合适的工具里”。