导读
没有模型，没有框架，核心内容是 Markdown 文件------一个 GitHub 仓库拿了 52k+ stars。Agency-Agents 的做法是给 AI 编程助手写"岗位说明书"：为 Claude Code、Cursor、Gemini CLI 等工具定义一套结构化的角色卡，前端工程师怎么做需求分析、安全工程师怎么做威胁建模、增长黑客怎么拆解指标------角色通常包含人格、工作流程、交付物模板和成功指标。目前已扩展到 14 个部门、140+ 个 Agent 角色。
本文将介绍 Agency-Agents 的设计思路、角色体系、集成方式和实际使用场景。
项目信息
- GitHub ：github.com/msitarzewsk...
- Stars：52k+
- 协议：MIT
一、不是框架，是"角色说明书"
Agency-Agents 不是一个 Agent 框架。它的核心产物是一组结构化的 Markdown 角色定义文件，辅以格式转换和安装的 shell 脚本。每个角色文件定义一个 AI Agent 的专业角色。
角色文件通常包含：
- 身份定义：角色名称、专业领域、人格特征、沟通风格
- 工作流程：该角色接到任务后的标准操作步骤
- 交付物模板：该角色应该输出什么格式的成果
- 成功指标：该角色的 KPI
当你在 Claude Code、Cursor 或其他 AI 编程工具中激活某个角色时，工具会按照该角色的定义来工作------不再是通用助手，而是一个有明确职责和流程的专业角色。
二、14 个部门、140+ 个角色
目前仓库按部门组织，覆盖了一个数字化团队的主要职能：
| 部门 | 角色数 | 代表角色 |
|---|---|---|
| 工程（Engineering） | 23 | 前端开发、后端架构师、AI 工程师、DevOps、安全工程师、代码审查员、SRE |
| 营销（Marketing） | 27 | 增长黑客、内容创作者、SEO、小红书运营、B站内容策略、直播电商教练 |
| 设计（Design） | 8 | UI 设计师、UX 研究员、品牌守护者、图像 Prompt 工程师 |
| 销售（Sales） | 8 | 外呼策略师、商机教练、方案策略师、销售工程师 |
| 付费媒体（Paid Media） | 7 | PPC 策略师、广告创意策略师、程序化购买、付费社交 |
| 产品（Product） | 5 | Sprint 优先级排序、趋势研究、反馈综合、产品经理 |
| 项目管理 | 6 | 制片人、项目牧羊人、Jira 工作流管家 |
| 测试（Testing） | 8 | 证据收集者、现实检验员、性能基准测试、API 测试、无障碍审计 |
| 支持（Support） | 6 | 客服响应、分析报告、财务追踪、法务合规 |
| 空间计算（Spatial Computing） | 6 | XR 界面架构师、visionOS 工程师 |
| 专项（Specialized） | 24+ | Agent 编排者、MCP 构建者、区块链安全审计、医疗营销合规 |
| 学术（academic） | 5 | 人类学家、地理学家、历史学家、叙事学家、心理学家 |
| 游戏开发（game-development） | 20 | 游戏设计师、Unity架构师、虚拟引擎工程师、脚本撰写 |
| 战略（strategy ） | 16 | 新增部门，持续扩展中 |
值得注意的是营销部门包含了中国平台的专项角色：小红书运营、微信公众号管理、知乎策略、百度 SEO、B站内容策略、快手策略、抖音策略、微博策略、跨境电商、私域运营。这在英文开源项目中不常见。
三、集成方式
Claude Code（原生支持）
将角色文件复制到 ~/.claude/agents/ 目录，即可在 Claude Code 会话中激活：
bash
# 方式一：手动复制
cp engineering/frontend-developer.md ~/.claude/agents/
# 方式二：自动安装
./scripts/install.sh多工具集成
项目提供转换和安装脚本，支持自动检测已安装的工具并部署：
bash
./scripts/convert.sh # 转换格式
./scripts/install.sh # 安装到各工具支持的工具：Claude Code、Cursor、GitHub Copilot、Aider、Windsurf、Gemini CLI、OpenCode、Qwen Code 等。
参考使用
也可以不做集成，直接浏览角色文件，把需要的人格定义和工作流程复制到自己的 prompt 中使用。
四、一个角色文件长什么样
以"代码审查员"（Code Reviewer）为例，角色文件的典型结构：
- 身份：资深代码审查专家，注重代码质量和可维护性
- 沟通风格：直接但建设性，用具体代码示例说明问题
- 工作流程：
-
- 理解 PR 的上下文和目标
- 检查架构设计是否合理
- 逐文件审查代码质量
- 检查测试覆盖率
- 输出结构化的审查报告
- 交付物：审查报告（包含问题分类、严重程度、修改建议）
- 成功指标：问题描述要有代码引用、建议要可操作、区分"必须修改"和"建议修改"
这种结构化定义比一句话的系统提示（"你是一个代码审查专家"）有效得多，因为它规定了做事的流程，不只是角色的身份。
五、总结
Agency-Agents 的走红反映了一个趋势：AI 编程工具的瓶颈不再是模型能力，而是如何引导模型按专业流程工作。一个好的角色定义文件，比一个更大的模型更能提升特定任务的输出质量。
适合关注的场景：
- 使用 Claude Code / Cursor 等工具做开发，想让 AI 助手在特定任务上更专业
- 团队想建立统一的 AI 辅助工作流程（如统一的代码审查标准、统一的 PR 模板）
- 对 Agent prompt engineering 的最佳实践感兴趣
当前局限：
- 角色质量参差不齐------140+ 个角色来自社区贡献，部分角色的流程和交付物定义不够细致
- 已提供 Agent 编排角色（Agents Orchestrator）和协作模板（handoff templates、playbooks），但多 Agent 协作仍处于早期阶段
Coovally AI Hub 解读AI前沿------顶会论文解读、开源项目精选、企业落地案例，帮你技术进阶与商业破圈。如果您有技术交流或合作意向，欢迎联系我们和评论区留言讨论～