agency-agents：把 AI 助手变成有分工的团队，而不是一堆提示词

它解决的是提示词碎片化的问题

大多数 AI 编程工具的默认行为是：你给一句指令，它尽力猜你要什么。agency-agents 换了一种思路，它把每个任务域拆成独立的代理文件，每个文件里写明了身份、性格、工作流程、交付物和成功指标。比如前端开发代理专门处理 React/Vue/Angular 和 Core Web Vitals，网络工程师代理只认 Cisco IOS、Juniper Junos 和 Palo Alto PAN-OS。这不是给你一段通用的“你是一个资深工程师”的提示词，而是一整套可复用的角色规范。它的目标用户很明确：那些已经在用 Claude Code、Cursor、Codex 等工具，但觉得默认行为不够专业、需要固定角色来约束输出的人。

代理文件里到底写了什么

每个代理文件是一个 Markdown 文档，结构大致包括身份与性格特质、核心使命与工作流程、带代码示例的技术交付物、成功指标和沟通风格。以工程部门的文件为例，前端开发者代理的职责范围写得很具体，从 UI 实现到性能优化都有覆盖。这种设计有一个实际好处：你可以直接阅读文件内容，判断它是否符合你的工作方式，而不必先安装再试错。另一个好处是，这些文件不绑定某个特定工具，它们只是文本，任何能读取 Markdown 的 AI 工具都可以把它们当作上下文。缺点是，文件的质量完全依赖作者的写作功力，如果某个代理的指令写得含糊，效果就会打折扣。

安装机制：一条命令，多个目标

项目提供了两个脚本。convert.sh 用于生成各种工具的集成文件，install.sh 负责把代理安装到指定工具。安装命令支持 --tool 参数，可以指定 claude-code、cursor、codex、gemini-cli、opencode、copilot、aider、windsurf、kimi 等。你也可以用 --division 或 --agent 参数只安装部分团队或单个代理，比如 ./scripts/install.sh --tool claude-code --division engineering,security 只装工程和安全两个部门。install.sh 还支持交互式向导，会自动检测你机器上装了哪些工具。对于只想手动操作的人，README 给出了最直接的路径：把 engineering/*.md 复制到 ~/.claude/agents/ 即可。这个设计让项目既适合命令行用户，也适合不想碰脚本的人。

OpenCode 的 119 个代理上限是个现实约束

README 里明确提到一个上游 bug：OpenCode 的运行时目前只注册约 119 个代理，超出部分会被静默丢弃。这意味着如果你用 opencode，并且不假思索地安装全部代理，你可能会发现某些代理根本没生效，而且没有任何报错。项目给出的应对办法是使用 --division 参数安装子集，让选择保持在限制以内。安装器会在选择超过上限时发出警告，但警告不等于阻止，最终责任还是在用户身上。这个例子说明，代理文件再多，目标工具的承载能力才是真正的天花板。其他工具虽然没有明确提到类似限制，但你最好在安装前查看目标工具的文档，确认它支持的自定义代理数量。

桌面应用是另一条路，但需要单独评估

除了命令行脚本，项目还维护了一个名为 Agency Agents 的桌面应用，支持 macOS、Linux 和 Windows。它的作用是让你浏览整个代理列表，然后一键安装到 Claude Code、Cursor、Codex、Gemini、Osaurus 等工具，并且会自动更新。macOS 用户可以用 brew install --cask msitarzewski/agency-agents/agency-agents 安装。这个应用和脚本安装的是同一批代理，所以不存在内容差异。但要注意，这个应用是独立仓库（agency-agents-app），它的维护状态、更新频率和代码质量并不包含在本仓库的 README 里。如果你倾向于用 GUI 而不是命令行，建议先查看那个仓库的 release 页面和源码再决定。

和通用提示词库相比，它的差异在流程而非内容

市面上有不少收集 AI 提示词的仓库，但 agency-agents 的侧重点不同。它不只是给你一段话，而是把代理定义、安装脚本、工具适配和团队分类打包在一起。你得到的不是一个孤立的提示词，而是一个可以反复安装、更新、按需筛选的代理集合。这种做法的代价是，你需要接受作者的分类方式。比如前端开发代理和快速原型代理之间可能有重叠，网络工程师代理可能只覆盖 Cisco、Juniper、Palo Alto 三家厂商，如果你用华为或 H3C 设备，这个代理就帮不上忙。另一个替代方案是自己写代理文件，但那就需要你自行研究每种工具的代理格式，维护成本会高很多。

维护与许可证：MIT 之下，你可以随意改造

项目采用 MIT 许可证，这意味着你可以自由使用、修改、分发这些代理文件，甚至把它们集成到自己的商业产品里。但许可证没有给你任何保证，代理文件的质量和维护责任完全在作者和社区身上。仓库没有显示最近的推送时间，也没有发布任何 release，所以你不能假设它处于活跃开发状态。如果你依赖它，最好 fork 一份到自己的账号下，这样即使原仓库停止更新，你也能继续使用。脚本本身是 Shell 写的，如果你需要修改安装逻辑，比如添加对新工具的支持，你得懂一点 bash。对于只想用现成代理的人来说，这些细节可以忽略，但如果你打算长期依赖，这些就是你需要承担的维护成本。

编辑结论

如果你在用 Claude Code、Cursor 或 Codex 这类支持自定义代理的编程工具，并且觉得通用提示词不够用，agency-agents 值得一试。它把角色定义和安装脚本打包在一起，省去了自己整理提示词的功夫。但你要先确认两件事：一是你的工具是否在官方支持列表里，二是你需要的代理数量是否超过目标工具的上限，比如 OpenCode 目前只注册约 119 个代理。安装前先用 ./scripts/install.sh --list teams 查看完整清单，再用 --dry-run 模拟安装，避免把不需要的代理塞进工作目录。对于只需要一两个固定角色的用户，直接复制对应的 Markdown 文件到 ~/.claude/agents/ 更轻量，不必跑整套脚本。这个项目的边界很清楚：它是角色定义的集合和安装器，不是代理运行时，也不保证每个工具都能完整加载。

官方来源

1. Official README
2. Project repository