这份详细的部署教程将指引您安装和使用 Agency Agents——一个包含数百个专业AI助手（Agent）的开源项目。每个Agent都拥有独特的个性、专业领域知识、标准化工作流程和可验证的交付成果，就像一个触手可及的“AI专家团队”。

🎯 核心概念与适用工具

在开始前，需要明确Agency Agents的定位：它是一个AI角色和提示词模板库，而非独立应用。它的作用是为你已有的AI编程工具（如Claude Code、Cursor等）注入专业领域知识。

工具名称 安装方式简述
Claude Code 直接复制Agent文件到 ~/.claude/agents/ 目录。
Cursor 通过脚本安装，Agent会转换为 .cursor/rules 目录下的规则文件。
GitHub Copilot Agent文件被复制到 ~/.github/agents/ 和 ~/.copilot/agents/ 目录。
其他工具 支持Gemini CLI、OpenCode、Aider、Windsurf、Qwen Code、Kimi Code等，可通过统一脚本安装。

⚙️ 部署与安装步骤

你可以根据自己的技术偏好选择以下安装方式。

方式一：使用官方桌面应用（最推荐）

这是官方推荐的最快捷方式，无需使用命令行即可浏览、安装和更新所有Agent。

  1. 下载应用：访问 Agency Agents 官方应用发布页，下载适用于macOS、Linux或Windows的安装包。
  2. 安装与运行：在macOS上，你也可以使用Homebrew安装：brew install --cask msitarzewski/agency-agents/agency-agents。启动应用后，你将看到完整的Agent列表。
  3. 一键安装：在应用界面中，选择你想要安装的AI工具（如Claude Code、Cursor），然后点击安装。应用会自动将Agent部署到对应工具的正确目录中。之后，该应用还能帮你保持Agent的持续更新。

方式二：使用命令行脚本（进阶用户）

如果你偏好终端操作，或需要更精细的控制，可以使用项目提供的脚本。

  1. 克隆项目仓库

    1
    2
    git clone https://github.com/msitarzewski/agency-agents.git
    cd agency-agents

  2. （可选）转换Agent格式
    某些工具可能需要特定格式。运行转换脚本，为所有支持的工具生成集成文件。

    1
    ./scripts/convert.sh

    如果你只想为某个工具生成，可以加上 --tool 参数，例如 ./scripts/convert.sh --tool gemini-cli。

  3. 运行安装脚本
    这是安装的核心步骤。脚本会自动检测你电脑上已安装的AI工具。

    1
    2
    # 交互式安装（推荐）。会提示你选择要安装到哪些工具，以及安装哪些部门/团队的Agent。
    ./scripts/install.sh --interactive
    1
    2
    3
    4
    5
    # 直接为特定工具安装所有Agent
    ./scripts/install.sh --tool claude-code
    ./scripts/install.sh --tool cursor
    ./scripts/install.sh --tool copilot
    # ... 更多工具请参考官方文档
    1
    2
    3
    4
    # 更精细的控制：只为某个工具的特定部门（如 engineering 和 security）安装Agent
    ./scripts/install.sh --tool claude-code --division engineering,security
    # 或安装指定的单个Agent
    ./scripts/install.sh --tool cursor --agent frontend-developer,ui-designer

    注意：如果使用OpenCode，需要注意其运行时存在约119个Agent的上限，安装全部可能会导致部分Agent被静默丢弃。因此，建议通过 --division 参数安装子集，以避免该问题。

🚀 开始使用

安装完成后，你就可以在你熟悉的AI编程工具中直接调用这些专家了。

在Claude Code中：
在对话中直接使用自然语言激活Agent。

1
Activate Frontend Developer. 帮我用React和TypeScript写一个移动端优先的登录页面。

Agent被激活后，会遵循其预设的工作流程（如规划、执行、审查）来处理你的请求。

在Cursor中：
Agent会以规则文件形式生效。你可以在对话中引用它：

1
Use the @security-engineer rules to review this code.

核心思路：你不再需要自己编写复杂的提示词，而是像指派真正的专家一样，直接“激活”一个拥有特定技能、知识和工作流程的Agent来为你完成任务。你也可以同时激活多个Agent，让他们协作完成一个复杂的项目，例如“启动创业公司MVP”或“发布一次营销活动”。

💡 重要提醒

  • 中文社区版：上游项目主要为英文。如果你需要更适合中文场景的Agent（如小红书运营、抖音策略、微信小程序开发等），可以关注社区维护的中文版项目：agency-agents-zh。
  • 独立部署：部分第三方教程提到了在云服务器（如阿里云）上独立部署Agency Agents的Web服务环境。这是一种更进阶的用法，旨在将整套Agent环境部署为在线服务，供团队使用。如需了解，可参考相关云平台的部署方案。
  • 风险提示：AI生成的建议不应完全等同于专业意见。在涉及法律、医疗、财务等重要事项时，请务必自行核实。