一、速览：它是一个“AI 专家团队”文件夹

入门

这个项目本身不是一个网站或独立软件，而是一堆 Markdown 文件（一种纯文本格式，用来写文档），每个文件都描述了一位 AI 专家的性格、专长和工作流程。你可以把这些文件安装到 Claude Code、Cursor 等 AI 编程工具里，让原本只会泛泛回答的 AI 变成一位“有脾气、有方法”的专业人士。

它解决的痛点是：很多人知道 AI 能帮忙，却不知道怎么让 AI 按专业标准干活。这里提供现成的角色设定，你只需要“激活”某位专家，AI 就会按照那个角色的口吻和步骤来交付结果。

可以把它类比成游戏角色卡包：每张卡牌就是一位专家，装进 AI 工具后，AI 就自动扮演那个角色。你不需要自己写复杂的提示词，也不用研究该领域的工作流程，因为每个角色文件里已经写好了。

二、快速部署：两种方式把专家装进你的工具

入门

开始安装前，你需要一台能联网的电脑，以及已经安装好的 AI 编程工具之一（例如 Claude Code、Cursor、Codex、Gemini）。如果你还不熟悉这些工具，可以先把本教程收藏起来，等装好工具再回来操作。

最省事的方式是使用官方桌面应用 Agency Agents。它支持 macOS、Linux 和 Windows，打开后能看到完整的专家名单，用鼠标点一下就能把选中的角色安装到 Claude Code、Cursor 等工具里，不需要手动输入命令，而且会自动更新。你可以到项目的 release 页面下载最新版本。

如果你更喜欢命令行操作，也可以用脚本安装。先打开终端（macOS/Linux 自带，Windows 可用 Git Bash 或 WSL），执行下面三行命令：

git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents
./scripts/install.sh --tool claude-code

第一行 git clone 是把整个项目下载到本地，第二行 cd 进入项目文件夹，第三行运行安装脚本。其中 --tool 用来指定要安装到哪个 AI 工具，示例里写的是 claude-code。如果你用的是其他工具，可以先运行 ./scripts/install.sh --help 查看脚本支持的选项。

如果你只想装某一个部门的专家，也可以手动复制文件。比如把工程类（engineering）的所有角色复制到 Claude Code 的 agents 目录：

cp engineering/*.md ~/.claude/agents/

提示：如果你不熟悉命令行，建议直接下载官方桌面应用，图形界面更直观，不容易出错。

三、配置详解：角色文件装到哪里、怎么选择部门

进阶 · 推荐细读

这个仓库按“部门”来组织角色文件，例如 engineering 是工程类，academic 是学术类，marketing 是营销类，还有社区、创意等部门。每个 .md 文件就是一位独立专家，文件名通常描述它的角色，比如 engineering-frontend-developer.md 对应前端开发专家。

安装脚本会把这些 .md 文件复制到目标工具指定的目录。以 Claude Code 为例，角色文件通常放在用户主目录下的 .claude/agents/ 文件夹里。不同工具的路径不一样，但脚本会自动处理；手动复制时你需要注意目标工具的官方文档给出的目录位置。

脚本还支持 --division 参数，用来只安装某个部门。比如你只想要工程类角色，可以执行：

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

这么做的另一个原因是：部分 AI 工具对可加载的角色数量有上限。比如 OpenCode 的运行时目前大约只能注册 119 个角色，超出的部分会被静默丢弃。如果你安装全部角色后发现缺失，可以先按部门装一部分，避开这个限制。

数据持久化方面无需担心，因为这些角色文件就放在本地目录里，不涉及云端同步或数据库。你直接备份、删除、移动这些 .md 文件即可。

四、功能导览：如何激活一个专家角色

入门

安装完成后，激活角色不需要任何特殊命令，只要在 AI 工具的对话里说明你要启用谁。例如在 Claude Code 会话中输入：

Hey Claude, activate Frontend Developer mode and help me build a React component

翻译过来就是：让 Claude 激活“前端开发者”模式，然后帮你写一个 React 组件。AI 会自动加载对应的角色设定，并用该专家的口吻和流程来完成你的需求。

仓库里角色数量多，覆盖领域广。举几个容易理解的例子：

• Frontend Developer：前端开发专家，擅长界面组件和交互逻辑。
• Technical Writer：技术写作专家，能把复杂概念写成清晰文档。
• RAG Pipeline Engineer：RAG 管道工程师，RAG 是“检索增强生成”的缩写，一种让 AI 先查资料再回答的技术。
• Knowledge Graph Engineer：知识图谱工程师，知识图谱就是把信息组织成关系网，方便机器理解。
• Narratologist：叙事学专家，适合写故事、分析剧情结构。
• Psychologist：心理学专家，能为角色塑造提供心理依据。

每位专家都带着自己的语气、工作方法和交付标准，不是简单一句“你是一名前端开发”就能代替的。你可以在不同任务之间切换角色，让 AI 用不同的专业视角帮你解决问题。

五、常见问题：路径、权限、角色不显示

入门

安装后 Claude Code 里看不到新角色？
先确认 .md 文件是否真的在 ~/.claude/agents/ 目录下。如果不在，重新运行安装脚本或手动复制。确认文件存在后，重启 Claude Code 会话再试。

运行脚本时提示权限不足？
这通常发生在 Linux 或 macOS 上，脚本没有执行权限。可以用下面两种方式之一解决：先给脚本加执行权限 chmod +x scripts/install.sh，或者直接用 bash scripts/install.sh 来运行。

手动复制时目标目录不存在？
先创建目录再复制，例如：

mkdir -p ~/.claude/agents

想卸载某个角色？
直接删除目标目录里对应的 .md 文件即可，不会影响其他角色文件，也不需要运行卸载脚本。

安装全部角色后发现有些缺失？
可能是你使用的 AI 工具对角色数量有限制。建议改用 --division 按部门安装，分批次加载需要的角色。

六、运维进阶：更新、备份与自定义角色

深入 · 老手可选

如果你用官方桌面应用，更新是自动完成的。手动安装的用户想获取最新角色，可以回到项目目录执行 git pull 拉取最新文件，然后重新运行安装脚本覆盖旧文件：

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

角色文件都是纯文本 Markdown，备份非常简单。你可以直接复制整个 agents 目录，存到 U 盘、网盘或另一台电脑。需要恢复时粘贴回原路径即可。

如果你想自己写一位专家角色，可以打开任意一个现有 .md 文件，参考它的结构和格式，新建一个文件并保存到对应工具目录。等熟悉格式后，你还可以向本项目提交 Pull Request（GitHub 上的合并请求），把你的角色分享给更多人。

现在你已经可以把这些 AI 专家装进自己的工具里了。遇到重复性高的任务时，不妨试试让合适的角色来接手。

项目信息

参考链接

• GitHub 仓库

延伸阅读

想继续探索？这些同领域的教程可能也适合你：

• 「script」中文使用教程
• 「Smart-Contract-Audits」中文使用教程
• 「docker-roonserver」中文使用教程