agency-agents 中文版

agency-agents 中文版（副标题「AI 智能体专家团队」）是 upstream 项目 agency-agents 的简体中文社区版：把 261 个上游角色翻译成中文，并新增 67 个面向中国市场的原创角色，合计 328 个可即插即用的 AI 专家。每个角色都有独立人设、工作流程与交付标准，装进 Claude Code、Cursor、OpenCode 等宿主后，用自然语言或 @ 就能唤起。它的价值在于「中文语境 + 本地平台经验」：小红书、抖音、微信、飞书、钉钉等平台运营角色，以及跨境电商、政务 ToG、医疗合规等垂类，是上游英文版没有的。

宿主适配

仓库自带转换与安装脚本，官方 README 列出 20 种 AI 编程工具的支持情况；其中 Claude Code 与 GitHub Copilot 可直接安装，其余工具需要先运行 ./scripts/convert.sh 转成对应格式。

工具	安装参数	说明
Claude Code	--tool claude-code	原生 .md 角色，直接安装
GitHub Copilot	--tool copilot	原生 .md，直接安装
OpenClaw	--tool openclaw	官方标注为推荐方式，拆成 SOUL.md + AGENTS.md + IDENTITY.md
OpenCode	--tool opencode	需先转换
Cursor	--tool cursor	规则文件形态，写入项目内
Aider	--tool aider	生成角色索引而非全文
Windsurf	--tool windsurf	需先转换
Antigravity / Gemini CLI	--tool antigravity / --tool gemini-cli	需先转换
Qwen Code / Qoder	--tool qwen / --tool qoder	需先转换
Codex CLI	--tool codex	需先转换
其他	kiro、trae、zcode、qwenpaw、deerflow、workbuddy、codewhale、hermes	同属官方支持的 20 种工具之列

核心能力

角色按「部门」组织，覆盖从公司经营到工程、营销、产品、游戏、安全、GIS、金融等 22 个部门。

• 中文角色库：328 个角色 = 261 个上游翻译 + 67 个中国市域原创，官方强调不是通用提示词模板，而是「怎么思考、怎么做、交付什么」都写清了的人设。
• 带方法论的角色：例如安全工程师会按 OWASP Top 10 逐项审查代码，小红书运营专家会输出种草笔记策略与达人合作方案。
• 高管与团队视角：公司经营部下设 CEO、CTO、CPO、CMO、COO、CFO 与幕僚长，可用于模拟「高管例会」式的多视角评估。
• 在线专家库：不用安装也能在 ao.aiolaola.com/experts 搜索、按部门筛选并复制每位专家的完整提示词。
• 配套编排工具：同作者的 Agency Orchestrator 可让多个角色自动组队，用 DAG 并行跑任务（npm install -g agency-orchestrator，或使用桌面客户端）。

安装与调用

前置条件是一台装有 git 与 bash 的机器，以及已经安装好的目标宿主；脚本只在本机读写角色目录，不需要 API Key。若不想碰命令行，可直接用在线专家库复制提示词。

1. 克隆中文版仓库，进入仓库根目录。
2. 如果目标不是 Claude Code 或 Copilot，先运行 ./scripts/convert.sh 生成对应格式；可加 --tool <工具> 只转换单一宿主。
3. 运行 ./scripts/install.sh 打开交互式安装（会自动检测本机已装工具），或直接指定 --tool。
4. 安装完成后重启宿主或新建会话，让角色目录被重新扫描。
5. 在会话里用自然语言点名角色（如「激活前端开发者模式，帮我改这个 React 组件」），或按宿主语法用 @角色 引用。

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

# 交互式安装（自动检测本机工具）
./scripts/install.sh

# 指定宿主
./scripts/install.sh --tool claude-code
./scripts/convert.sh --tool opencode && ./scripts/install.sh --tool opencode

# 手动复制某个部门（Claude Code）
cp -r marketing/*.md ~/.claude/agents/

验证结果

安装是否生效可以分两步确认：先检查目标目录（如 ~/.claude/agents/ 或项目内 .opencode/agents/）是否出现角色文件；再在新会话里点名一个角色提出具体请求，看回答是否体现该角色设定中的流程与交付物结构。若点了名但没有生效，通常是宿主未重启、目录层级不对，或该工具需要先跑 convert.sh 而没有跑。

亮点与差异

相比直接用英文原版，中文版解决的是「语言 + 平台」双重适配问题，而不是简单翻译。

67 个原创角色聚焦小红书、抖音、微信、B站、飞书、钉钉等平台运营，以及跨境电商、政务 ToG、医疗合规、Qt 工业上位机等垂类场景，这些内容在上游仓库里是没有的。

它也保留了上游的工程化安装方式：同一份角色文件能落到不同宿主的目录与格式，配合 install.sh 的自动检测，多人协作时能快速拉齐角色口径。

适合谁

• 偏好中文提示词与中文交付物，希望角色「说人话」的开发者与运营。
• 做国内平台运营（小红书、抖音、公众号、B 站）或跨境电商，需要现成垂类角色的团队。
• 已经在用 Claude Code、Cursor、Copilot、OpenCode 等宿主，想把专家角色沉淀成可复用资产的人。

局限与注意

• 社区版而非官方：这是 upstream agency-agents 的中文社区版本，角色质量与同步节奏由该仓库维护者决定，与上游不保证逐条一致。
• 安装脚本会写配置目录：安装器直接向 ~/.claude、.cursor 等路径写入文件，建议先在测试项目里试一次，并确认脚本内容。
• 多数工具要先转换：只有 Claude Code 与 Copilot 可直接安装，其余工具漏跑 convert.sh 会装不上。
• 角色数量与上下文成本：角色库体量大，全量装进宿主既占目录也占上下文，日常建议按部门或按项目选择性安装。
• 项目级文件要纳入版本管理：Cursor、OpenCode 等装到项目目录内，属于团队共享产物，需要进代码评审。
• README 含推广内容：仓库首页含较多赞助商与配套课程链接，阅读时注意区分官方功能与商业推广。

常见问题

以下内容均来自官方 README。

• 必须安装吗？ 不必，可在线浏览 ao.aiolaola.com/experts，搜索筛选后直接复制专家提示词使用。
• 支持哪些工具？ 官方标注 20 种，含 Claude Code、Copilot、Cursor、OpenCode、Aider、Windsurf、Antigravity、Gemini CLI、Qwen、Codex、OpenClaw、Kiro、Trae、Qoder 等。
• 和上游 agency-agents 什么关系？ 中文社区版，在上游翻译基础上新增 67 个中国市域原创角色。
• 怎么让多个角色协作？ 使用同作者的 Agency Orchestrator，ao compose "任务" --run 自动拆解任务并按 DAG 并行执行。
• OpenClaw 用户怎么装？ 先 convert.sh --tool openclaw 再 install.sh --tool openclaw，安装后重启网关生效。

相关链接

• 中文版仓库（角色库与安装脚本）
• 在线专家库（免安装浏览与复制）
• 上游 agency-agents 仓库
• Agency Orchestrator（多角色编排）