Agency-Agents（52k+ Stars）：140+ 个角色模板，让 AI 编程助手变成一支专业团队

CoovallyAIHub
0 阅读5分钟

导读

没有模型，没有框架，核心内容是 Markdown 文件——一个 GitHub 仓库拿了 52k+ stars。Agency-Agents 的做法是给 AI 编程助手写"岗位说明书"：为 Claude Code、Cursor、Gemini CLI 等工具定义一套结构化的角色卡，前端工程师怎么做需求分析、安全工程师怎么做威胁建模、增长黑客怎么拆解指标——角色通常包含人格、工作流程、交付物模板和成功指标。目前已扩展到 14 个部门、140+ 个 Agent 角色。

本文将介绍 Agency-Agents 的设计思路、角色体系、集成方式和实际使用场景。

项目信息

一、不是框架，是"角色说明书"

Agency-Agents 不是一个 Agent 框架。它的核心产物是一组结构化的 Markdown 角色定义文件，辅以格式转换和安装的 shell 脚本。每个角色文件定义一个 AI Agent 的专业角色。

角色文件通常包含：

  • 身份定义：角色名称、专业领域、人格特征、沟通风格
  • 工作流程：该角色接到任务后的标准操作步骤
  • 交付物模板：该角色应该输出什么格式的成果
  • 成功指标：该角色的 KPI

当你在 Claude Code、Cursor 或其他 AI 编程工具中激活某个角色时，工具会按照该角色的定义来工作——不再是通用助手，而是一个有明确职责和流程的专业角色。

二、14 个部门、140+ 个角色

目前仓库按部门组织，覆盖了一个数字化团队的主要职能：

部门角色数代表角色
工程（Engineering）23前端开发、后端架构师、AI 工程师、DevOps、安全工程师、代码审查员、SRE
营销（Marketing）27增长黑客、内容创作者、SEO、小红书运营、B站内容策略、直播电商教练
设计（Design）8UI 设计师、UX 研究员、品牌守护者、图像 Prompt 工程师
销售（Sales）8外呼策略师、商机教练、方案策略师、销售工程师
付费媒体（Paid Media）7PPC 策略师、广告创意策略师、程序化购买、付费社交
产品（Product）5Sprint 优先级排序、趋势研究、反馈综合、产品经理
项目管理6制片人、项目牧羊人、Jira 工作流管家
测试（Testing）8证据收集者、现实检验员、性能基准测试、API 测试、无障碍审计
支持（Support）6客服响应、分析报告、财务追踪、法务合规
空间计算（Spatial Computing）6XR 界面架构师、visionOS 工程师
专项（Specialized）24+Agent 编排者、MCP 构建者、区块链安全审计、医疗营销合规
学术（academic）5人类学家、地理学家、历史学家、叙事学家、心理学家
游戏开发（game-development）20游戏设计师、Unity架构师、虚拟引擎工程师、脚本撰写
战略（strategy ）16新增部门，持续扩展中

值得注意的是营销部门包含了中国平台的专项角色：小红书运营、微信公众号管理、知乎策略、百度 SEO、B站内容策略、快手策略、抖音策略、微博策略、跨境电商、私域运营。这在英文开源项目中不常见。

三、集成方式

Claude Code（原生支持）

将角色文件复制到 ~/.claude/agents/ 目录，即可在 Claude Code 会话中激活：

# 方式一：手动复制
cp engineering/frontend-developer.md ~/.claude/agents/

# 方式二：自动安装
./scripts/install.sh

多工具集成

项目提供转换和安装脚本，支持自动检测已安装的工具并部署：

./scripts/convert.sh   # 转换格式
./scripts/install.sh   # 安装到各工具

支持的工具：Claude Code、Cursor、GitHub Copilot、Aider、Windsurf、Gemini CLI、OpenCode、Qwen Code 等。

参考使用

也可以不做集成，直接浏览角色文件，把需要的人格定义和工作流程复制到自己的 prompt 中使用。

四、一个角色文件长什么样

以"代码审查员"（Code Reviewer）为例，角色文件的典型结构：

  • 身份：资深代码审查专家，注重代码质量和可维护性
  • 沟通风格：直接但建设性，用具体代码示例说明问题
  • 工作流程：
    1. 理解 PR 的上下文和目标
    2. 检查架构设计是否合理
    3. 逐文件审查代码质量
    4. 检查测试覆盖率
    5. 输出结构化的审查报告
  • 交付物：审查报告（包含问题分类、严重程度、修改建议）
  • 成功指标：问题描述要有代码引用、建议要可操作、区分"必须修改"和"建议修改"

这种结构化定义比一句话的系统提示（"你是一个代码审查专家"）有效得多，因为它规定了做事的流程，不只是角色的身份。

五、总结

Agency-Agents 的走红反映了一个趋势：AI 编程工具的瓶颈不再是模型能力，而是如何引导模型按专业流程工作。一个好的角色定义文件，比一个更大的模型更能提升特定任务的输出质量。

适合关注的场景：

  • 使用 Claude Code / Cursor 等工具做开发，想让 AI 助手在特定任务上更专业
  • 团队想建立统一的 AI 辅助工作流程（如统一的代码审查标准、统一的 PR 模板）
  • 对 Agent prompt engineering 的最佳实践感兴趣

当前局限：

  • 角色质量参差不齐——140+ 个角色来自社区贡献，部分角色的流程和交付物定义不够细致
  • 已提供 Agent 编排角色（Agents Orchestrator）和协作模板（handoff templates、playbooks），但多 Agent 协作仍处于早期阶段

Coovally AI Hub 解读AI前沿——顶会论文解读、开源项目精选、企业落地案例，帮你技术进阶与商业破圈。如果您有技术交流或合作意向，欢迎联系我们和评论区留言讨论～

avatar
文章
阅读
粉丝