
你用过AI办公时,大概率试过在聊天窗口里打"你现在是一个资深前端工程师"这类话。这叫角色扮演提示词(Role Prompting)——给 AI 一个身份,让它按这个身份的输出方式工作。效果不错,但问题是:每次都要写,而且写出来的效果取决于你提示词的水平。
agency-agents-zh 做的事情就是把这件事标准化了。
它本身不写代码、不调用模型、不是又一个 AI 框架。它是一个AI 专家角色库——266 个预定义的角色定义,覆盖 20 个部门。每个角色不是一句简单的"你是前端工程师",而是一整套身份定义、工作流程、专业知识和可交付成果的完整文档。
一个"角色"到底意味着什么
普通的提示词(Prompt)大概是这样的:
"你是一个资深后端工程师,请帮我 review 以下代码……"
agency-agents-zh 里的角色定义是这种:
安全工程师(应用安全架构师)
身份:负责整体应用安全架构设计,遵循 OWASP Top 10、PCI DSS 等标准
工作流程:威胁建模 → 安全需求分析 → 安全架构设计 → 安全审查 → 渗透测试
知识域:认证与授权、输入验证、加密与密钥管理、日志与监控、容器安全
可交付成果:安全架构文档、威胁模型、安全审查报告、渗透测试报告
区别很清晰:提示词告诉你"扮演什么",角色定义告诉你"怎么思考、怎么工作、交付什么"。
每个角色都是独立的 .md 文件,包含了:
身份与定位——这个专家是什么领域的、擅长什么
关键规则——这个角色在工作时必须遵循的原则
核心工作流——它处理任务的标准流程
交付物标准——它输出的东西应该长什么样
266 个文件,分布在 20 个部门目录下:工程、设计、营销、产品、金融、法务、供应链、游戏开发、空间计算、安全、销售、项目管理、人力资源等等。
中文社区版的价值增量
上游项目 agency-agents 是英文原版。agency-agents-zh 不只是翻译——它做了三件事:
翻译了 215 个英文角色。 专业术语做了本地化适配,比如 OWASP Top 10、PCI DSS 这类安全标准保留了英文原文但加了中文说明。
新增了 50 个中国原创角色。 这是最核心的价值。包括:
小红书运营专家
抖音策略师
微信小程序开发者
跨境电商运营专家
国内网络工程师
服装工厂规划工程师
更多面向国内工具链和业务场景的角色

支持了 18 种 AI 编程工具的自动安装。 脚本自动检测已安装的 AI 工具,把角色文件部署到对应工具的配置目录。支持的列表包括:Claude Code、Cursor、GitHub Copilot、Windsurf、Codex CLI、Gemini CLI、Qwen Code、OpenClaw、DeerFlow 等。几乎覆盖了 2026 年主流的所有 AI 编码助手。

使用体验:装完就能用
安装方式做得足够简单:
./scripts/install.sh脚本自动检测你机器上装了哪个 AI 编码工具,把对应的角色文件部署进去。部署完成后,在工具里直接输入"找一个安全工程师帮我 review 这段代码",对应的角色定义就会被加载,AI 用安全工程师的身份和工作流来处理你的请求。
对于不想运行脚本的用户,也可以手动把 .md 文件复制到工具的 agents 目录,或者直接在 AI 对话里把角色文件的内容粘贴进去当提示词用。
还有一个配套的编排工具 agency-orchestrator,支持用一句话让多个专家按 DAG 图自动协作:
ao compose "帮我写一篇关于 AI Agent 的深度分析文章" --run理论上可以让市场专家出选题、内容专家写初稿、SEO 专家优化、编辑专家审校——全自动串联。不过编排器是独立工具,需要额外安装,我没实测过效果。
这个项目的定位
agency-agents-zh 不是一个"产品",它是一个知识资产。
它的价值不体现在代码质量(全是 Markdown 文件),而是在于:把"如何跟 AI 协作"这件事的经验和最佳实践,固化成了可复用、可安装、可共享的角色定义。
这 266 个角色是社区积累的结果——每个角色的工作流程和知识域都是基于真实业务场景提炼出来的。一个安全工程师角色包含的 OWASP 审查流程、一个产品经理角色包含的 Sprint 规划方法、一个小红书运营角色包含的平台算法理解——这些都是需要实际业务经验才能写出来的东西。
值得注意的问题
对于经常使用 AI 编码工具、又不想每次重复写角色提示词的开发者来说,agency-agents-zh 是一个实用价值很高的社区项目。50 个中国市场原创角色是国内用户的增量价值所在,工程和产品部门的角色覆盖尤其全面。
如果你只用英文工具、不做国内市场,直接去上游 agency-agents 项目就行。如果你需要面向国内业务场景,agency-agents-zh 是更好的起点。
GitHub: https://github.com/jnMetaCode/agency-agents-zh在线浏览全部角色: https://ao.aiolaola.com/experts
夜雨聆风