211 个 AI 专家角色，一键安装到你的 AI 工具：agency-agents-zh 完全使用教程

不是又一套提示词模板。这是 211 个有人设、有流程、有交付物的 AI 专家，覆盖工程、设计、营销、产品等 18 个部门，支持 Claude Code / Cursor / Copilot 等 16 种 AI 工具。无论你是开发者还是运营/营销人员，都能用得上。

一、这个项目是什么？为什么值得关注？

agency-agents-zh 是一个开源的 AI 智能体角色库（GitHub: jnMetaCode/agency-agents-zh），基于英文上游项目 agency-agents  81.6 K star的中文社区版。

先说说什么是”AI 编程/AI 工具”： Claude Code、Cursor、GitHub Copilot 这些工具，本质上是集成了 AI 大模型的编程助手。你在编辑器里用自然语言描述需求，它们就能帮你写代码、做分析、生成方案。但它们不仅能写代码——配合合适的角色定义，它们可以变身营销策划师、产品经理、财务分析师等各种专家。这正是 agency-agents-zh 做的事。

和普通提示词的本质区别：

普通提示词告诉 AI “你是一个前端专家”，然后期待它自己发挥。而 agency-agents 的每个智能体都定义了：

• 身份人设
  
  ：角色定位、性格特征、专业经验
• 核心使命
  
  ：具体负责什么、交付什么
• 关键规则
  
  ：工作原则、红线、合规要求
• 技术交付物
  
  ：代码模板、配置示例、架构规范
• 工作流程
  
  ：分步操作、决策框架、质量门禁
• 沟通风格
  
  ：怎么说话、什么语气、输出什么格式
• 成功指标
  
  ：可度量的结果、质量标准、KPI

举个例子：

以”小红书运营专家”为例，它不是简单的一句”你是小红书专家”，而是定义了：

• 精通平台算法逻辑、用户行为特征的完整人设
• 爆款笔记模板（标题 18-20 字含关键词 + 情绪触发词）
• KOL/KOC 筛选标准（匹配度 > 粉丝量，看互动率而非曝光量）
• 投放节奏管理（预热期 → 集中种草期 → 长尾维护期）
• ROI 追踪方法（CPE、搜索指数变化、电商引流效果）
• 平台合规红线（违禁词库、蒲公英平台报备、禁止刷量）

项目规模一览

二、18 个部门全景地图

在深入使用之前，先了解这个”虚拟公司”有哪些部门和专家。

核心技术部门

工程部（33 个智能体） —— 从前端到后端，从嵌入式到区块链：

• 前端开发者、后端架构师、AI 工程师、DevOps 自动化师
• 安全工程师、数据工程师、移动应用开发者
• 嵌入式固件工程师、FPGA 数字设计工程师、IoT 方案架构师
• 微信小程序开发者、飞书/钉钉集成开发工程师
• Solidity 智能合约工程师、SRE 站点可靠性工程师
• 代码审查员、数据库优化师、Git 工作流大师、软件架构师

测试部（9 个智能体） —— 质量保障全覆盖：

• 证据收集者、现实检验者、API 测试员、性能基准师、无障碍审核员
• 测试结果分析师、工具评估师、工作流优化师、嵌入式测试工程师

设计部（8 个智能体） —— 从 UI 到品牌：

• UI 设计师、UX 研究员、UX 架构师、品牌守护者、图像提示词工程师、视觉叙事师

业务增长部门

营销部（35 个智能体） —— 最大的部门，国内外平台全覆盖：

国内平台专家（原创）：

• 小红书运营专家、抖音策略师、微信公众号运营
• B站内容策略师、快手策略师、微博运营策略师
• 知乎策略师、播客内容策略师、微信视频号运营策略师
• 私域流量运营师、直播电商主播教练、短视频剪辑指导师
• 跨境电商运营专家、中国电商运营专家、百度 SEO 专家

出海营销：

• TikTok 策略师、Twitter 互动官、Instagram 策展师、Reddit 社区运营

通用：

• 增长黑客、内容创作者、社交媒体策略师、SEO 专家、LinkedIn 内容创作专家

销售部（8 个智能体） —— 从线索到成交：

• 客户拓展策略师、赢单策略师、销售教练、Discovery 教练
• 售前工程师、Outbound 策略师、Pipeline 分析师、投标策略师

付费媒体部（7 个智能体） —— 精准投放：

• 付费媒体审计师、广告创意策略师、PPC 竞价策略师、程序化广告采买专家

战略支撑部门

产品部（5 个）：产品经理、Sprint 排序师、趋势研究员、反馈分析师、行为助推引擎

项目管理部（6 个）：高级项目经理、项目牧羊人、实验追踪员、工作室制片人、工作室运营、Jira 工作流管家

财务部（8 个）：簿记与财务总监、财务分析师、财务预测分析师、FP&A 分析师、金融风控分析师、投资研究员、发票管理专家、税务策略师

支持部（8 个）：客服响应者、数据分析师、法务合规员、高管摘要师、财务追踪员、基础设施运维师、招聘运营专家、供应链采购策略师

法务部（2 个）：合同审查专家、制度文件撰写专家

人力资源部（2 个）：招聘专家、绩效管理专家

供应链部（3 个）：库存预测专家、供应商评估专家、物流路线优化师

特色部门

学术部（6 个）：人类学家、地理学家、历史学家、叙事学家、心理学家、学习规划师

游戏开发部（20 个）：覆盖 Unity、Unreal、Godot、Blender、Roblox 五大引擎

空间计算部（6 个）：visionOS 空间工程师、macOS Metal 空间工程师、XR 界面架构师、XR 沉浸式开发者、XR 座舱交互专家、终端集成专家

专项部（45 个）：智能体编排者、提示词工程师、合规审计师、MCP 构建器、区块链安全审计师、高考志愿填报顾问、政务数字化售前顾问、医疗健康营销合规师、留学规划顾问、动态定价策略师等

第 18 个”部门”：NEXUS 策略框架

NEXUS 不是一个包含独立智能体的部门，而是协调所有 211 个智能体的运营框架。它定义了 7 个项目阶段、质量门禁、交接模板和三种运作模式（详见第七章）。

三、安装教程：三种方式任选

前提条件

• 一台装有 AI 工具的电脑（支持 macOS / Linux / Windows）
• Git（用于克隆项目）
• Bash 4.0+（macOS/Linux）或 PowerShell 5.0+（Windows）
• 至少安装了一种支持的 AI 工具（如 Claude Code、Cursor、GitHub Copilot 等）

第一步：克隆项目

git clone https://github.com/jnMetaCode/agency-agents-zh.gitcd agency-agents-zh

方式一：一键安装（推荐）

自动检测你已安装的 AI 工具并安装所有智能体：

# 自动检测并安装（默认安装所有检测到的工具）./scripts/install.sh# 或指定安装到特定工具./scripts/install.sh --tool claude-code    # Claude Code./scripts/install.sh --tool cursor         # Cursor./scripts/install.sh --tool copilot        # GitHub Copilot./scripts/install.sh --tool openclaw       # OpenClaw（社区推荐）./scripts/install.sh --tool kiro           # Kiro（Amazon）./scripts/install.sh --tool trae           # Trae./scripts/install.sh --tool windsurf       # Windsurf./scripts/install.sh --tool aider          # Aider./scripts/install.sh --tool gemini-cli     # Gemini CLI./scripts/install.sh --tool codex          # Codex CLI./scripts/install.sh --tool deerflow       # DeerFlow 2.0（字节跳动）./scripts/install.sh --tool workbuddy      # WorkBuddy（腾讯）./scripts/install.sh --tool hermes         # Hermes Agent

重要提示： Claude Code 和 GitHub Copilot 可直接安装（原生 .md 格式）。其他工具需要先运行格式转换：

# 先转换格式./scripts/convert.sh --tool cursor# 再安装./scripts/install.sh --tool cursor

Windows 用户 使用 PowerShell 版本：

.\scripts\install.ps1 --tool claude-code.\scripts\convert.ps1 --tool cursor    # 格式转换

方式二：手动复制

如果你只需要部分智能体，可以手动复制：

# Claude Code：复制到全局目录cp -r marketing/*.md ~/.claude/agents/cp -r engineering/*.md ~/.claude/agents/# GitHub Copilot：复制到全局目录cp -r marketing/*.md ~/.github/agents/# Cursor：复制到项目目录（需要先转换格式）./scripts/convert.sh --tool cursorcp -r integrations/cursor/.cursor/rules/* .cursor/rules/

方式三：作为提示词参考

不想安装？也可以直接浏览使用：

1. 打开项目的 CATALOG.md（精简目录）或 AGENT-LIST.md（完整列表）
2. 用 Ctrl+F 搜索关键词找到你需要的智能体
3. 打开对应的 .md 文件，复制内容粘贴到你的 AI 工具对话框中

各工具安装位置参考

全局 vs 项目级： 全局安装后所有项目都能用；项目级安装只在当前项目目录下生效，需要在每个项目中单独安装。

OpenClaw 三文件架构： OpenClaw 是社区用户最多的集成方式。每个智能体会拆分为三个文件：SOUL.md（身份人设）+ AGENTS.md（业务能力）+ IDENTITY.md（简介）。这种拆分天然支持多智能体协作编排，因为系统可以按需加载不同部分。

安装后验证

安装完成后，在你的 AI 工具中测试一下：

Claude Code 验证：

# 检查文件是否安装成功ls ~/.claude/agents/ | head -10# 在 Claude Code 中输入# "激活前端开发者，帮我写一个 Hello World 的 React 组件"

Cursor 验证：

# 检查规则文件ls .cursor/rules/ | head -10# 重启 Cursor，在对话中输入 "激活后端架构师"

如果 AI 工具能够识别角色并以该角色的专业视角回应你，说明安装成功。

四、基础使用：激活你的第一个智能体

安装完成后，在你的 AI 工具中用自然语言激活智能体。

有两种激活方式：

方式 A：直接说”激活 + 角色名”

激活前端开发者模式，帮我构建一个 React 登录组件。

方式 B：指定文件路径激活（更精确）

请使用 engineering/engineering-frontend-developer.md 这个角色来构建一个 React 登录组件。

方式 B 在 CATALOG.md 中有完整的文件路径索引，适合需要精确指定角色的场景。

示例 1：激活前端开发者

激活前端开发者模式，帮我构建一个 React 登录组件，要求：支持手机号+验证码登录，使用 Ant Design 组件库，包含表单验证和错误处理。

激活后，AI 不再是泛泛而谈的助手，而是一个有前端开发经验的专家角色，会按照组件最佳实践给你写代码，考虑性能优化、无障碍设计、响应式布局等。

示例 2：激活安全工程师做代码审查

激活安全工程师，审查 src/auth/ 目录下的认证模块代码。重点关注：SQL 注入、XSS、CSRF 防护、密码存储、会话管理。输出安全审计报告。

示例 3：激活小红书运营专家

激活小红书运营专家。我的品牌是一个新锐护肤品牌，主打成分党，目标用户 20-35 岁女性。预算 5 万/月。请制定完整的小红书运营方案，包括：1. 内容策略和选题方向2. 达人合作方案（KOL/KOC 分层）3. 投放节奏和预算分配4. ROI 跟踪指标

示例 4：激活后端架构师设计 API

激活后端架构师。项目：在线教育平台。技术栈：Node.js + PostgreSQL。需要设计课程管理模块的 API 和数据模型，包括：- 课程 CRUD- 章节管理- 用户订阅/购买- 学习进度追踪输出 RESTful API 设计文档和数据库 Schema。

激活效果对比

同样的问题 “帮我写一个用户认证系统”：

五、进阶使用：多智能体协作

单个智能体已经很强，但 agency-agents 真正的威力在于多智能体协作。通过让不同专家接力或并行工作，你可以模拟一个完整团队。

协作模式 1：串行接力

上一个智能体的输出作为下一个智能体的输入：

第 1 步：激活 UX 研究员→ 输出用户调研报告第 2 步：激活产品经理（输入调研报告）→ 输出产品需求文档第 3 步：激活后端架构师（输入需求文档）→ 输出 API 设计和数据库 Schema第 4 步：激活前端开发者（输入 API 设计）→ 输出前端代码

协作模式 2：并行工作

多个智能体同时处理不同任务：

并行激活：- 后端架构师：设计 API- UI 设计师：设计界面原型- 安全工程师：制定安全规范汇总后激活前端开发者，综合所有输出开始开发。

协作模式 3：审查验证

一个智能体做事，另一个智能体审查：

1. 激活前端开发者，写登录模块代码2. 激活代码审查员，审查登录模块代码3. 激活安全工程师，做安全审计4. 前端开发者根据审查意见修改

多智能体协作的核心挑战：上下文传递

手动协作时，你需要在智能体之间复制粘贴输出。这在小项目中可行，但当项目变大时：

• 会话超时导致输出丢失
• 多个智能体需要相同的上下文
• QA 失败时需要回退到之前的状态
• 项目跨越数天甚至数周

解决方案：MCP 记忆服务器

项目提供了一个基于 MCP（Model Context Protocol）记忆服务器的方案（见 examples/workflow-with-memory.md）。安装 MCP 记忆服务器后，智能体可以自动存储和检索上下文：

# 传统方式（手动复制粘贴）：激活后端架构师。这是我们的 Sprint 计划：[粘贴 Sprint 排序师的输出]这是调研报告：[粘贴 UX 研究员的输出]设计 API 和数据库。# MCP 记忆方式（自动检索上下文）：激活后端架构师。项目：RetroBoard。回忆该项目之前的上下文，设计 API 和数据库。

智能体会自动搜索记忆中的 RetroBoard 上下文，找到之前智能体存储的 Sprint 计划和调研报告，然后继续工作。

标准化交接模板

项目还提供了 NEXUS 标准交接模板（strategy/coordination/handoff-templates.md），确保智能体之间不丢失上下文。每次交接包含：

# NEXUS 交接文档## 元数据| 字段 | 值 ||------|-----|| 发送方 | [智能体名称]（[部门]） || 接收方 | [智能体名称]（[部门]） || 阶段 | 第 [N] 阶段 || 优先级 | [紧急/高/中/低] |## 上下文当前状态、相关文件、依赖、约束## 交付要求具体交付物、验收标准、参考材料

这套模板解决了多智能体协作中”上下文丢失”的头号问题。

六、项目自带的实战工作流示例

项目在 examples/ 目录下提供了 6 个完整的多智能体工作流示例，可以直接参考或复制使用：

示例 1：4 周 MVP 开发（workflow-startup-mvp.md）

场景： 独立开发者用 4 周从零开发一个 SaaS 团队复盘工具。

智能体团队（7 人）： Sprint 排序师、UX 研究员、后端架构师、前端开发者、快速原型师、增长黑客、现实检验者

流程：

• 第 1 周：Sprint 排序师拆分任务 + UX 研究员做竞品分析 + 后端架构师设计 API
• 第 2 周：前端开发者 + 快速原型师开发核心功能
• 第 3 周：现实检验者做上线前质量验证
• 第 4 周：增长黑客制定发布策略

示例 2：小红书品牌推广（workflow-xiaohongshu-launch.md）

场景： 新消费品牌 2 周内完成小红书种草推广全流程。

智能体团队（5 人）： 小红书运营、品牌守护者、内容创作者、数据分析师、增长黑客

流程：

• 第 1-2 天：小红书运营制定策略 + 品牌守护者输出内容审核清单
• 第 3-7 天：内容创作者批量产出种草笔记
• 第 8-12 天：投放执行 + 增长黑客设计裂变路径
• 第 13-14 天：数据分析师出复盘报告

示例 3：一天做完 Landing Page（workflow-landing-page.md）

场景： 新产品上线，一天内做出转化优化的着陆页。

智能体团队（4 人）： 内容创作者、UI 设计师、前端开发者、增长黑客

流程： 上午文案+设计并行 → 下午开发 → 傍晚增长黑客优化转化

示例 4：图书章节写作（workflow-book-chapter.md）

场景： 作者有语音备忘录和零散笔记，需要转化为结构化的图书章节。

智能体： 图书联合作者（单智能体深度工作流）

示例 5：MCP 记忆增强版 MVP（workflow-with-memory.md）

示例 1 的升级版，通过 MCP 记忆服务器实现智能体间的自动上下文传递，无需手动复制粘贴。

示例 6：空间计算产品发现（nexus-spatial-discovery.md）

场景： 8 个智能体并行评估一个软件市场机会。

涵盖： 市场验证、技术架构（8 服务系统设计）、品牌策略、GTM 计划、支持运营蓝图、UX 用户旅程、35 周项目计划

七、中国市场原创智能体详解

这是 agency-agents-zh 相比英文上游版本最大的差异化价值：46 个专为中国市场设计的智能体。

社交平台运营

电商与变现

平台开发

垂直行业

八、配合 Agency Orchestrator 实现全自动编排

一句话，让多个 AI 专家自动协作，几分钟交付完整方案。

手动激活智能体虽然灵活，但如果你想让多个专家全自动协作，可以搭配项目团队开发的 Agency Orchestrator——角色库提供专家，Orchestrator 让专家们像真实团队一样协作。

安装

npm install -g agency-orchestrator

一句话自动编排

# 描述你的需求，Orchestrator 自动选角、编排、执行ao compose "帮我写一篇关于 AI Agent 的深度分析文章" --run

执行过程：

自动选角 → 叙事学家 + 心理学家 + 内容创作者 + 叙事设计师自动编排 → DAG 工作流，检测依赖，并行执行自动交付 → 几分钟后拿到完整成果

核心能力

十、常见使用场景速查

场景 1：我是独立开发者，想快速做一个 MVP

推荐智能体组合：Sprint 排序师 + 后端架构师 + 前端开发者 + 快速原型师激活方式："激活智能体编排者，NEXUS-Sprint 模式。我要做一个 [产品描述]，时间线 4 周。从架构设计开始。"参考示例：examples/workflow-startup-mvp.md

场景 2：我是营销人员，需要制定全渠道推广方案

推荐智能体组合：小红书运营专家 + 抖音策略师 + 微信公众号运营 + 私域流量运营师激活方式："激活小红书运营专家。品牌：[品牌名]，预算：[金额]，目标：[具体目标]。制定完整运营方案。"参考示例：examples/workflow-xiaohongshu-launch.md

场景 3：我是技术负责人，需要做安全审计

推荐智能体组合：安全工程师 + 代码审查员 + 威胁检测工程师激活方式："激活安全工程师，对 [仓库/模块] 进行 OWASP Top 10 安全审查。重点关注认证、授权、数据加密模块。"

场景 4：我要做游戏开发

推荐智能体组合（以 Unity 为例）：Unity 架构师 + 游戏设计师 + 关卡设计师 + 叙事设计师 + 技术美术激活方式："激活 Unity 架构师。游戏类型：[类型]，目标平台：[平台]。设计核心系统架构。"

场景 5：我需要做财务分析

推荐智能体组合：财务预测分析师 + 金融风控分析师 + 数据分析师激活方式："激活财务预测分析师。公司：[公司信息]，需要做 [季度/年度] 财务预测，包含收入预测、成本分析、现金流预测。"

场景 6：我想写一本书

推荐智能体：图书联合作者激活方式："激活图书联合作者。书的目标：[主题和定位]。目标读者：[读者画像]。章节主题：[本章要写什么]。原始素材：[语音备忘录/笔记/故事片段]"参考示例：examples/workflow-book-chapter.md

场景 7：我需要快速做一个着陆页

推荐智能体组合：内容创作者 + UI 设计师 + 前端开发者 + 增长黑客激活方式：一天内完成，上午文案+设计并行，下午开发，傍晚优化转化。参考示例：examples/workflow-landing-page.md

十一、实用技巧

1. 查找智能体

项目提供了两个索引文件：

• CATALOG.md
  
  ：精简速查表（303 行），含中文名和文件路径，推荐日常使用
• AGENT-LIST.md
  
  ：完整列表（475 行），按部门分类，含适用场景描述

在编辑器中打开这两个文件，用 Ctrl+F 搜索关键词即可找到你需要的智能体。

2. 自定义智能体

每个智能体都是一个 Markdown 文件，你可以自由修改或创建新的：

---name: 智能体名称description: 一句话描述这个智能体干什么color: blue---# 智能体名称你是**智能体名称**，[一句话定位]。## 你的身份与记忆- **角色**：具体角色- **个性**：性格特点- **记忆**：记住什么- **经验**：擅长什么## 核心使命具体职责和工作内容。## 关键规则做事的原则和红线。## 技术交付物代码示例、模板、框架等具体产出。## 工作流程分步骤的工作流。## 沟通风格说话的方式和语气示例。## 成功指标可量化的衡量标准。

3. 组合使用的原则

• 明确上下文传递
  
  ：激活下一个智能体时，把上一个的输出粘贴进去（或使用 MCP 记忆服务器自动传递）
• 先规划后执行
  
  ：先用 Sprint 排序师/产品经理规划，再用工程智能体执行
• 审查验证闭环
  
  ：每个阶段结束后用审查类智能体（代码审查员、现实检验者）验证
• 使用交接模板
  
  ：跨智能体协作时，使用 NEXUS 交接模板保持上下文完整

4. 跨工具迁移

如果你从 Cursor 切换到 Claude Code，只需要重新运行安装脚本：

./scripts/install.sh --tool claude-code

项目的格式转换脚本会自动处理不同工具之间的格式差异。

5. 按需安装

如果 211 个智能体太多，你可以只安装需要的部门：

# 只安装营销部的智能体cp marketing/*.md ~/.claude/agents/# 只安装工程部的智能体cp engineering/*.md ~/.claude/agents/

十二、常见问题

Q：安装后激活智能体没有效果怎么办？

A：确认文件已正确复制到目标目录。部分工具（如 Cursor）需要重启后才能加载新规则。另外，确保你的 AI 工具支持自定义角色/规则功能。

Q：我不是程序员，也能用吗？

A：完全可以。211 个智能体中有大量非技术角色：营销策划、内容运营、财务分析、产品管理、销售策略等。你只需要安装工具（推荐 Claude Code 或 Cursor），然后用中文激活对应角色即可。

Q：同时激活多个智能体会冲突吗？

A：在同一个对话中，建议一次只激活一个智能体角色。需要多角色协作时，按顺序在不同对话轮次中切换角色，或使用 Agency Orchestrator 自动编排。

Q：Hermes 在 Discord 中使用报错怎么办？

A：Discord 的斜杠命令 JSON 有 8000 字符限制。如果智能体太多会超限，建议用 --category 参数分批安装：

./scripts/install.sh --tool hermes --category marketing./scripts/install.sh --tool hermes --category engineering

Q：智能体是中文还是英文？

A：所有 211 个智能体的内容都是中文，包括从英文翻译过来的 165 个和 46 个中国市场原创的。代码示例中的注释也翻译成了中文。

Q：可以商用吗？

A：可以。项目采用 MIT 开源协议，允许自由使用、修改和商业用途。

如何贡献

1. Fork 项目
2. 翻译上游英文智能体，或创建新的中国市场智能体
3. 遵循智能体文件格式（参考 CONTRIBUTING.md）
4. 一个 PR 做一件事，commit message 用中文
5. 文件使用 LF 换行（不要 CRLF）

总结

agency-agents-zh 不只是一个提示词库，而是一个完整的”AI 虚拟公司”基础设施：

• 211 个专业角色
  
  ，覆盖软件开发全生命周期和业务增长全链路
• 46 个中国市场原创智能体
  
  ，真正懂国内平台生态（小红书、抖音、微信、B站、飞书、钉钉）
• NEXUS 策略框架
  
  ，7 个阶段 + 质量门禁 + 标准交接模板，让多智能体协作有章可循
• 6 个实战工作流示例
  
  ，从 MVP 开发到小红书推广，直接复制使用
• MCP 记忆服务器支持
  
  ，解决多智能体协作中的上下文传递问题
• 16 种工具支持
  
  ，一键安装开箱即用
• MIT 开源
  
  ，可自由商用和定制

无论你是独立开发者、创业团队、营销运营人员，还是企业技术团队，都可以从这个项目中找到适合你的”AI 专家团队”，大幅提升工作效率。

三步开始使用：

git clone https://github.com/jnMetaCode/agency-agents-zh.gitcd agency-agents-zh./scripts/install.sh

然后在你的 AI 工具中说一句”激活小红书运营专家”或”激活后端架构师”，感受和普通提示词的区别。

本文介绍的 agency-agents-zh 项目基于 MIT 开源协议，GitHub 仓库：github.com/jnMetaCode/agency-agents-zh

———————————————————

有问题欢迎留言交流！或提问