我最近发现一个开源项目，装完之后Claude Code直接从"通用助手"变成了"专家团队"。
不是那种"你是XX专家"的一句话提示词，是每个角色都有完整的工作流程、交付标准和专业约束的那种。
今天写个教程，从安装到实际使用，5分钟搞定。
这东西解决什么问题？
你跟Claude Code说"帮我审查一下这段代码的安全问题"，它会给你几条泛泛的建议——"注意SQL注入"、"做好输入校验"。
但你的项目用的是ORM，根本没有原生SQL。它给的建议听着都对，但没一条能直接用。
问题出在哪？AI没有专业视角。同一段代码，安全工程师看到的是漏洞，DBA看到的是慢查询，架构师看到的是耦合。通用模式下AI什么都能说两句，但什么都不深入。
agency-agents中文版就是解决这个问题的——193个专业角色，18个部门，装上之后用自然语言切换身份。
第一步：安装
整个过程就三条命令：
# 1. 克隆项目（任意位置都行）
git clone https://github.com/jnMetaCode/agency-agents-zh.git
cd agency-agents-zh
# 2. 安装到你的AI工具（自动检测已安装的工具）
./scripts/install.sh
如果你只用Claude Code，可以指定工具：
./scripts/install.sh --tool claude-code
安装脚本会把角色文件复制到~/.claude/agents/目录。不影响你现有的任何配置，不想用了删掉这个目录就行。
支持14种AI工具：Claude Code、Cursor、GitHub Copilot、OpenClaw、Kiro、Trae、Gemini CLI、Aider、Windsurf、Qwen Code、Codex CLI、DeerFlow、OpenCode、Antigravity。
Cursor和OpenClaw等工具需要先跑一步格式转换：
./scripts/convert.sh --tool cursor # 转成.mdc格式
./scripts/install.sh --tool cursor # 再安装
验证安装成功
ls ~/.claude/agents/ | head -10
看到一堆engineering-security-engineer.md、marketing-xiaohongshu-operator.md这样的文件就对了。
第二步：激活角色
装好之后，直接在对话里用自然语言激活：
你：用安全工程师审查 src/api/auth.py
你：切换到DBA模式，帮我优化这个慢查询
你：用小红书运营专家帮我写一篇种草笔记
不需要记住精确的角色名。你说"安全专家"、"安全工程师"、"搞安全的"，AI都能匹配到对应的角色。
实际效果演示
光说没用，看几个真实场景。
场景一：安全审查
没装角色的时候：
你：帮我看看这段认证代码有没有安全问题
AI：建议使用参数化查询防止SQL注入，建议对用户输入进行校验，
建议使用HTTPS传输，建议加上CSRF防护……
——一堆正确的废话，像背教科书。
装了安全工程师角色之后：
你：用安全工程师审查 src/api/auth.py
AI：按STRIDE模型逐项分析：
🔴 身份伪造：第42行JWT验证缺少签名算法白名单，
可被alg=none攻击绕过
🔴 信息泄露：第78行错误响应返回了完整的堆栈跟踪
🟡 权限提升：refreshToken没有和用户绑定，
被盗后可用于任意账户
→ 建议修复顺序：JWT签名 > 错误处理 > Token绑定
区别在哪？角色文件里定义了安全工程师的工作流程：按STRIDE模型（Spoofing→Tampering→Repudiation→Information Disclosure→DoS→Elevation of Privilege）逐项检查，输出可直接提Issue的结构化报告。不是AI变聪明了，是上下文对了。
场景二：数据库优化
你：用DBA帮我优化这个查询，跑了3秒多
AI：分析执行计划：
当前：全表扫描 orders（120万行），耗时3.2s
根因：WHERE user_id=? AND created_at>? 缺少联合索引
建议：
ALTER TABLE orders ADD INDEX idx_user_created (user_id, created_at);
预估优化后：0.05s（索引覆盖查询）
额外发现：
- SELECT * 拉了28个字段，实际只用了5个，建议改成明确字段
- created_at 没有时区信息，混用UTC和本地时间会出问题
场景三：小红书种草笔记
这是46个中国原创角色之一，不是翻译的。
你：用小红书运营专家帮我给一款蓝牙耳机写种草笔记
AI：先确认几个关键信息——
1. 价位段？（决定种草角度：性价比 or 品质感）
2. 核心卖点？（音质/降噪/颜值/续航）
3. 目标人群？（学生党/通勤族/运动达人）
→ 确认后输出：
标题：「戴了一周真心话｜这个价位的降噪居然能打AirPods？？」
封面：建议1:1比例，产品+使用场景，不要纯白底产品图
正文结构：痛点场景 → 开箱初印象 → 3天使用体验 → 和竞品对比 → 总结推不推荐
标签：#蓝牙耳机推荐 #平价降噪 #学生党好物
这个角色知道小红书的爆款公式、封面规范、标题字数限制、违禁词规则、蒲公英报备流程。这些不是通用AI能聊出来的。
角色全览：18个部门，193个角色
不用全记住，用到什么搜什么就行。列个表给你参考：
| 部门 | 数量 | 举几个例子 |
|---|---|---|
| 工程 | 30 | 后端架构师、前端开发、安全工程师、DevOps、嵌入式固件、微信小程序 |
| 营销 | 34 | 小红书运营、抖音策略师、B站内容策略、微信公众号运营、跨境电商 |
| 专业 | 34 | AI治理专家、动态定价、高考志愿顾问、医疗合规、直播电商教练 |
| 测试 | 9 | QA工程师、性能基准、无障碍测试、嵌入式测试 |
| 设计 | 8 | UI设计师、UX研究员、品牌视觉、无障碍设计 |
| 销售 | 8 | 客户发现、销售教练、提案撰写、管道管理 |
| 产品 | 5 | 产品经理、Sprint排序、趋势分析、用户反馈 |
| 其他 | 65 | 金融、法务、HR、供应链、游戏开发、学术、空间计算…… |
其中46个是中文原创角色（带⭐标记），专门为中国市场设计。比如动态定价策略师懂淘宝满减叠加规则、千川投放逻辑；合同审查专家引用的是《民法典》不是Common Law。
进阶用法
1. 在CLAUDE.md里配置常用角色
如果你经常用某几个角色，可以在项目的CLAUDE.md里写上：
当我说"安全审查"时，按安全工程师角色工作
当我说"优化查询"时，按DBA角色工作
代码审查时默认使用高级开发者角色
这样不用每次都说"用XX角色"。
2. 只安装需要的角色
193个角色太多了？手动复制你需要的就行：
# 只要工程相关的
cp engineering/*.md ~/.claude/agents/
# 只要营销相关的
cp marketing/*.md ~/.claude/agents/
# 只要特定几个
cp engineering/engineering-security-engineer.md ~/.claude/agents/
cp marketing/marketing-xiaohongshu-operator.md ~/.claude/agents/
3. 多角色协作
一个复杂需求可以按顺序切换角色：
第1轮：用产品经理分析需求，输出PRD
第2轮：用架构师基于PRD设计技术方案
第3轮：用安全工程师审查方案的安全风险
第4轮：用前端开发者开始实现
每个角色基于上一个角色的输出继续工作，比一个通用AI从头做到尾效果好得多。
如果嫌手动切换麻烦，可以搭配agency-orchestrator用YAML定义工作流自动编排，这个以后单独写教程。
卸载
不想用了？
# Claude Code
rm -rf ~/.claude/agents/
# Cursor
rm -rf .cursor/rules/
删目录就完事，没有任何残留。
写在最后
这个项目的核心思路其实很简单：不是让AI变聪明，而是给AI正确的上下文。
同一个模型，你告诉它"你是通用助手"和"你是有10年经验的安全工程师，按STRIDE模型工作，输出结构化威胁报告"，输出质量天差地别。
193个角色就是193套经过打磨的上下文。开源免费，MIT协议，装上试试就知道了。
GitHub搜索：jnMetaCode/agency-agents-zh
