01

认识 AI 代理机构

144 个专业 AI 代理,横跨 12 个部门,像组建一支永不下班的专业团队

想象你拥有一家全明星公司

这家公司里有前端工程师、营销专家、财务分析师、游戏设计师......每个人都是顶尖高手,从不请假,永远在线。这就是 Agency Agents 项目。

它诞生于一条 Reddit 帖子,经过数月迭代,成长为拥有 144 个专业 AI 代理 的庞大集合。

🎯

深度专业化

每个代理精通自己的领域,不是万能的通才模板

🧠

人格驱动

独特的声音、沟通风格和工作方式,让交互更自然

📋

交付物导向

产出真实代码、流程和可衡量的成果,而非空泛建议

生产就绪

经过实战测试的工作流和成功衡量标准

12 个部门,覆盖业务全链路

Agency 的组织结构就像一家真实的创意 + 技术公司。点击下方任意部门,了解它负责什么。

技术层

💻
工程部
🧪
测试部
🎮
游戏开发

产品与设计层

🎨
设计部
📊
产品部
🎬
项目管理

增长与运营层

📢
营销部
💼
销售部
💰
付费媒体

支持与专业层

🛟
支持部
🎯
专业部
💵
财务部
点击任意部门查看详细说明

一个代理的"档案"

每个代理都以 Markdown 文件存储,结构统一、内容丰富。下面是工程部前端开发代理的档案头。

CODE

---
name: Frontend Developer
description: Expert frontend developer
color: cyan
emoji: 🖥️
vibe: Builds responsive, accessible
  web apps with pixel-perfect
  precision.
---
            
中文解释

这是 Front Matter 元数据区的开始标记

代理的名字:前端开发工程师

一句话描述这个代理的专长领域

代表色:青色,在聊天中显示为头像颜色

标志性 Emoji,让代理更容易被识别

氛围描述:用一句话定义这个代理的性格基调

氛围描述续行:响应式、无障碍、像素级精准

Front Matter 结束标记

💡
关键洞察

代理不是普通的提示词模板。它是一个完整的"角色档案"——包含身份、性格、核心使命、工作流程、交付物模板和成功衡量标准。这就像给 AI 写了一份完整的岗位职责说明书(JD),而不仅仅是一句"扮演前端开发者"。

项目文件结构

整个仓库按照部门组织,每个 .md 文件就是一个独立的代理。

agency-agents/ 项目根目录
engineering/ 工程部 — 27 个代理
design/ 设计部 — 8 个代理
marketing/ 营销部 — 29 个代理
sales/ 销售部 — 9 个代理
product/ 产品部 — 5 个代理
project-management/ 项目管理部 — 6 个代理
testing/ 测试部 — 8 个代理
finance/ 财务部 — 5 个代理
game-development/ 游戏开发部 — 跨引擎代理
spatial-computing/ 空间计算部 — AR/VR/XR
academic/ 学术部 — 世界构建
specialized/ 专业部 — 30+ 个特殊代理
scripts/install.sh 一键安装脚本
scripts/convert.sh 多工具格式转换

检验你的理解

如果有人问你 Agency Agents 和普通 AI 提示词模板有什么不同,你会怎么说?

你想为一个创业项目搭建技术团队。你需要在哪个目录找到前端和后端代理?

02

代理个性与人格设计

每个代理不只是工具,而是一个有性格、有记忆、有工作方式的"虚拟同事"

解剖一个代理的"灵魂"

打开任意代理文件,你会发现它像一个精心设计的人物档案。以趣味注入师为例,它的档案包含四大核心模块。

🧠
身份与记忆

定义代理的角色、性格特征、记忆模式和实践经验。就像一份浓缩的简历 + 性格测试。

🎯
核心使命

代理存在的根本目的。比如趣味注入师的使命是"注入有策略性的个性,而不是随机搞笑"。

🚩
关键规则

代理必须遵守的硬性约束。趣味注入师有一条铁律:"每个趣味元素必须有功能或情感目的"。

📋
交付物模板

代理会产出的具体成果,包含代码示例、文档模板和衡量标准。不是空泛建议,而是可执行的方案。

每个代理都有自己的"声音"

代理之间的对话就像一个有趣的群聊。看看不同代理说同一件事的方式有多不同。

💬
注意到了吗?

前端开发者说话精确且数据化,趣味注入师充满创意但被要求提供依据,证据采集者天然多疑,Reddit 社区建设者永远从社区角度思考。人格设计让每个代理在对话中的表现截然不同。

人格是怎样写进代码的?

以趣味注入师的身份记忆部分为例,看看代理的"性格"如何用文本精确定义。

CODE

## 🧠 Your Identity & Memory
- **Role**: Brand personality and
  delightful interaction specialist
- **Personality**: Playful, creative,
  strategic, joy-focused
- **Memory**: You remember successful
  whimsy implementations, user delight
  patterns, and engagement strategies
- **Experience**: You have seen brands
  succeed through personality and fail
  through generic, lifeless interactions
            
中文解释

标题:你的身份与记忆 —— 用第二人称让 AI "代入角色"

角色定义:品牌个性与趣味交互专家

续行:明确专业领域边界

性格描述:有趣、有创意、有策略、以快乐为核心

续行:四个形容词精确控制 AI 的表达风格

记忆设定:记住成功的趣味实现方案和用户快乐模式

续行:让代理在后续对话中能"回忆"和"积累经验"

经验背景:见过品牌因个性而成功,也见过因平庸而失败

续行:给 AI 一个世界观——理解失败的代价,会更努力做好

交付物:不只是建议,而是代码

趣味注入师不只告诉你"加点动画"——它会直接给你可用的 CSS 代码。

CODE

/* Delightful Button Interactions */
.btn-whimsy {
  position: relative;
  overflow: hidden;
  transition: all 0.3s
    cubic-bezier(0.23, 1, 0.32, 1);
}
            
中文解释

注释:趣味按钮交互效果

定义 .btn-whimsy 类,应用到需要趣味效果的按钮

position: relative —— 让内部绝对定位的子元素有参照

overflow: hidden —— 隐藏溢出内容,为后续光效做准备

transition —— 所有属性在 0.3 秒内平滑过渡

使用精心调校的缓动曲线,产生"快速响应、柔和收尾"的手感

结束定义

代理与部门配对

把左边的代理拖到它所属的部门(或点击放置)。

Whimsy Injector
Evidence Collector
Growth Hacker
SRE
Bookkeeper

设计部 — 给产品注入个性与趣味

Drop here

测试部 — 收集证据,确保质量

Drop here

营销部 — 快速获客,病毒传播

Drop here

工程部 — 保障生产环境可靠性

Drop here

财务部 — 记账、核算、审计

Drop here

理解检查

趣味注入师的一条铁律是什么?

代理档案用什么语言视角来定义身份?

03

多代理协作与编排

当多个代理像一个真正的团队那样协同工作时,魔法就发生了

交响乐团的指挥家

想象一个交响乐团——小提琴手、大提琴手、定音鼓手各自精彩,但没有指挥家,演出就会变成噪音。在 Agency Agents 中,Agents Orchestrator 就是那个指挥家。

它管理四个阶段的工作流水线:

1
项目分析与规划

派遣 项目经理 代理把需求文档拆解成任务清单

2
技术架构设计

派遣 架构师 创建技术蓝图和 UX 基础

3
开发-QA 持续循环

每个任务:开发代理实现 → 测试代理验证 → 不通过则反馈回开发,最多重试 3 次

4
最终集成与验证

所有任务通过后,进行端到端集成测试,确保整体交付质量

开发流水线中的消息流

点击 "Next Step" 逐步观看一个任务在流水线中的流转过程。

🎷
Orchestrator
📋
项目经理
🏗
架构师
💻
开发者
🧪
测试
Click "Next Step" to begin

质量门禁:铁面无私的守门人

Orchestrator 的核心设计理念是"不跳过任何质量检查"。看看它是怎么定义质量门禁规则的。

CODE

### Quality Gate Enforcement
- **No shortcuts**: Every task must
  pass QA validation
- **Evidence required**: All decisions
  based on actual agent outputs
- **Retry limits**: Maximum 3 attempts
  per task before escalation
- **Clear handoffs**: Each agent gets
  complete context and instructions
            
中文解释

标题:质量门禁执行规则

没有捷径:每个任务都必须通过 QA 验证才能进入下一步

续行:不能"差不多就行",必须有明确的通过/不通过判断

必须有证据:所有决策基于代理的实际输出

续行:不能凭感觉说"看起来没问题",必须展示截图或测试结果

重试上限:每个任务最多重试 3 次,之后升级处理

续行:防止在同一个问题上无限循环浪费资源

清晰交接:每个代理收到完整的上下文和指令

续行:代理不会因为缺少信息而犯错,像医院交接班一样完整

💡
工程智慧

这个设计模式在软件工程中叫"质量门禁"(Quality Gate)——在每个阶段之间设置检查点,只有通过才能继续。这比"做完再统一测试"可靠得多,因为问题被发现得越早,修复成本越低。

实战场景:创业 MVP 的团队协作

看一个真实的跨部门协作场景——为一个创业公司搭建 MVP

Dev-QA 循环:不停的螺旋上升

这是 Agency 最核心的协作模式——开发者写代码,测试者验证,不通过就打回重做,直到质量达标。

1

开发代理实现任务

2

QA 代理测试验证

3

PASS?进入下一任务

4

FAIL?反馈回开发

MAX_RETRY = 3 每个任务最多重试 3 次,超过则升级处理
EVIDENCE_REQUIRED QA 必须提供截图或测试结果作为证据
CONTEXT_HANDOFF 每次交接传递完整的上下文,不丢信息

概念验证

如果某个任务连续 3 次都没通过 QA 测试,Orchestrator 会怎么做?

为什么质量门禁要在每个任务之间设置检查点,而不是最后统一测试?

04

实战:从零组建你的团队

手把手教你根据项目需求,挑选代理、安装配置、激活使用

场景 1:创业 MVP 的梦之队

你要做一个 AI 写作助手 MVP。你需要哪些代理?让我们像拼乐高一样组建团队。

🖥

Frontend Developer

用 React + TypeScript 构建用户界面,实现编辑器和交互逻辑

🏗

Backend Architect

设计 API 接口、数据库架构,处理用户认证和 AI 调用

🤖

AI Engineer

集成 LLM,设计提示词管道,优化生成质量

Rapid Prototyper

快速迭代原型,在黑客松节奏中验证核心假设

🔍

Reality Checker

上线前的质量把关,基于证据认证,确保生产就绪

安装流程:三步到位

Agency 提供了一个交互式安装脚本,自动检测你系统上有哪些 AI 编码工具,然后让你选择安装。

1
生成集成文件

./scripts/convert.sh 将代理文件转换为各工具的格式

2
交互式安装

./scripts/install.sh 自动检测工具,弹出选择界面

3
激活代理

在对话中引用代理名称即可激活,例如 "Use the Frontend Developer agent"

安装代码翻译

看看安装命令到底做了什么。

CODE

# Install all agents to Claude Code
./scripts/install.sh --tool claude-code

# Or copy a specific category
cp engineering/*.md ~/.claude/agents/

# Then activate in your session:
# "Use the Frontend Developer
#  agent to build a React form"
            
中文解释

注释:将所有代理安装到 Claude Code

运行安装脚本,--tool 指定目标工具为 Claude Code

注释:或者只复制某一个类别的代理

将 engineering 目录下所有 .md 文件复制到 Claude Code 的代理目录

注释:然后在你的 Claude Code 会话中激活代理

注释:用自然语言告诉 Claude 你想用哪个代理做什么

注释续行:比如用前端开发者代理来构建一个 React 表单

一套代理,十种工具通用

Agency 最强大的特性之一:同一个代理可以在不同的 AI 工具中使用。convert.sh 脚本负责格式转换。

💻
Claude Code

原生 .md 格式,无需转换。放入 ~/.claude/agents/ 即可

🧠
Cursor

转换为 .mdc 规则文件,放入 .cursor/rules/ 自动生效

🐍
Aider

所有代理合并为一个 CONVENTIONS.md 文件

🚀
Gemini CLI / Antigravity

转换为 SKILL.md 格式,作为 Gemini 的技能扩展

🔗
OpenClaw / Windsurf / Qwen / Kimi

各有专用格式:SOUL.md、.windsurfrules、SubAgent、YAML 等

实战演练

Scenario

你正在做一个小红书营销推广项目。你需要选择最合适的代理组合来完成任务。

做小红书推广,你会选择哪组代理?

Scenario

你的团队使用 Cursor 编辑器做开发,你想让 Agency 的工程部代理自动生效。

正确的安装步骤是什么?

05

工具集成与扩展生态

从代理设计哲学到社区贡献,理解整个生态系统的运作方式

五大设计哲学

每个 Agency 代理都遵循五条核心设计原则。这些原则是项目质量的基石。

🎭

强烈个性

不是泛泛的模板,而是真正的角色和声音。代理说话的方式和它做的事情一样重要。

📋

明确交付物

具体的输出成果——代码、文档、报告——而不是模糊的指导意见。

可衡量的成功

每个代理都有明确的成功衡量标准和质量底线,让结果可评估。

🔄

经过验证的工作流

步骤明确的流程,经过实战检验。不是理论,而是"照着做就能成功"。

💡

学习型记忆

代理能记住成功的模式和失败的教训,在后续任务中持续改进。

创建你自己的代理

Agency 欢迎社区贡献。如果你想创建一个新的代理,需要遵循统一的模板结构。来看看一个完整的代理包含哪些部分。

TEMPLATE

---
name: [Agent Name]
description: [One-line specialty]
color: [theme color]
emoji: [icon]
vibe: [Personality tagline]
---

# [Agent Name] Agent Personality

## 🧠 Identity & Memory
## 🎯 Core Mission
## 🚩 Critical Rules
## 📋 Technical Deliverables
## 🔄 Workflow Process
## 📊 Success Metrics
            
中文解释

Front Matter 元数据:名称、描述、颜色、图标、氛围

代理名称——简短有力,一看就知道专长

一句话描述——代理的核心能力

主题色——在聊天和图表中作为视觉标识

图标——Emoji 形式的视觉签名

氛围标语——一句话定义性格基调

Front Matter 结束

标题:代理名称 + "Agent Personality"

身份与记忆:角色、性格、记忆、经验

核心使命:代理存在的根本目的

关键规则:必须遵守的硬性约束

技术交付物:具体的产出成果和代码示例

工作流程:步骤明确的执行过程

成功衡量:可量化的质量标准

案例:MCP 构建器代理

来看看专业部中一个特殊的代理——MCP Builder。它的工作是帮别人创建新的 AI 工具。

🔧
定义工具能力

明确 MCP 服务器能做什么——哪些操作、哪些参数、哪些返回格式

📝
生成代码骨架

产出符合 MCP 标准的 TypeScript 服务器代码,开箱即用

📊
测试与文档

生成测试用例和使用文档,确保工具能被其他代理正确调用

生态:不止是代码

Agency Agents 的生态远超代码仓库本身。它是一个活跃的社区项目。

🌏

社区翻译

中文社区维护了 agency-agents-zh(141 个翻译代理 + 46 个中国原创代理),覆盖小红书、B 站等本土平台。

🤝

贡献指南

任何人都可以提交新代理或改进现有代理。遵循统一模板,提交 PR 即可。

💬

讨论与反馈

GitHub Discussions 分享成功案例,Issues 报告问题,Reddit 和 Twitter 持续讨论。

🌍
关键数据

144 个专业代理、10,000+ 行人格与流程代码、12 个部门、11 种 AI 工具支持、50+ 个 PR 在上线前 12 小时内涌入。这是一个由社区驱动、为社区而生的项目。

工作流程实例:前端开发代理的交付物

前端开发代理不只写代码——它提供完整的、可运行的组件示例。

CODE

export const DataTable = memo<DataTableProps>(
  ({ data, columns, onRowClick }) => {
  const rowVirtualizer = useVirtualizer({
    count: data.length,
    getScrollElement: () => parentRef.current,
    estimateSize: () => 50,
    overscan: 5,
  });
            
中文解释

导出一个名为 DataTable 的 React 组件,用 memo 优化性能避免不必要的重渲染

接收 data(数据)、columns(列定义)、onRowClick(行点击回调)三个参数

创建虚拟滚动器:只渲染可见区域的行,大幅提升大数据量性能

数据总条数——决定虚拟滚动的范围

获取滚动容器——虚拟滚动需要知道哪个元素在滚动

每行预估高度 50 像素——用于计算滚动位置

上下多渲染 5 行——避免滚动时出现空白闪烁

结束虚拟滚动器配置

⚠️
常见误区

很多人以为代理只是"给 AI 一段提示词"。但 Agency 的代理更像是"给 AI 一份完整的岗位职责说明书 + 培训手册 + 工作模板"。它不只告诉 AI "做什么",还定义了"怎么做"、"做到什么标准"、"用什么风格做"。

综合测验

Scenario

你的公司要为中国市场开发一款新的电商小程序,需要选择代理并组建团队。

你会选择哪些代理组成中国电商团队?

如果你想贡献一个新的代理到 Agency,你需要包含哪些核心部分?

学完这五节课,你会如何向同事解释 Agency Agents 的价值?