## 项目概述

**agency-agents**（The Agency）是一个开源的 AI 智能体（Agent）集合，旨在为用户提供一套完整的、可直接使用的 AI 专家团队。该项目由 Reddit 社区讨论催生，经过数月迭代，目前包含 230+ 个高度专业化的 AI 智能体，覆盖工程、设计、营销、销售、产品、项目管理、测试、安全、支持、空间计算、GIS、医疗、金融、游戏开发、学术等多个领域。每个智能体都拥有独特的个性、工作流程和可交付成果，而非简单的提示词模板。项目支持将智能体安装到多种 AI 编程工具中，如 Claude Code、Cursor、Codex、Gemini CLI 等，并提供配套的桌面应用（Agency Agents）以简化安装和管理。

## 核心功能

- **丰富的智能体库**：提供 230+ 个专业智能体，每个智能体包含身份、个性、核心任务、技术交付物、工作流程、成功指标等结构化内容。
- **多工具集成**：支持将智能体安装到 Claude Code、GitHub Copilot、Antigravity、Gemini CLI、OpenCode、Cursor、Aider、Windsurf、OpenClaw、Qwen Code、Kimi Code、Codex、Osaurus、Hermes 等主流 AI 编程工具。
- **一键安装脚本**：提供 `convert.sh` 和 `install.sh` 脚本，可自动生成各工具所需的格式文件，并交互式选择安装目标工具和智能体团队。
- **桌面应用**：提供原生桌面应用（macOS、Linux、Windows），可浏览智能体列表并一键安装到支持的 AI 工具中，支持自动更新。
- **社区驱动**：鼓励用户贡献新智能体、改进现有智能体、分享使用案例，并提供详细的贡献指南。
- **多语言本地化**：社区维护了多种语言的翻译版本，包括简体中文、葡萄牙语、俄语、印尼语、阿拉伯语、韩语、日语、越南语等。

## 适用与不适用场景

**适用场景：**

- 希望快速为 AI 编程助手（如 Claude Code、Cursor）配置专业领域专家角色的开发者。
- 需要跨职能 AI 团队支持的项目，如 MVP 开发、营销活动、企业功能开发、付费媒体账户接管等。
- 希望借鉴成熟 AI 智能体设计模式，构建自定义智能体的团队。
- 需要将 AI 智能体集成到多种工具链中的用户。

**不适用场景：**

- 需要完全自主运行、无需人工干预的自动化系统（智能体仍需用户激活和引导）。
- 对智能体输出有严格合规要求的生产环境（智能体内容仅供参考，需人工审核）。
- 希望获得开箱即用、无需配置的完整解决方案的用户（需要一定的安装和配置步骤）。

## 技术架构与依赖

- **语言**：Shell（主要脚本语言），智能体文件为 Markdown 格式。
- **依赖**：需要 Bash 环境（Linux/macOS），Windows 用户建议使用 WSL 或桌面应用。
- **架构**：项目采用目录结构组织智能体，按部门（division）分类，如 `engineering/`、`design/`、`marketing/` 等。`divisions.json` 和 `tools.json` 分别定义部门和工具集，作为配置的单一事实来源。`convert.sh` 负责将 Markdown 智能体转换为各工具所需的格式，`install.sh` 负责安装到目标工具目录。
- **外部服务**：部分智能体可能依赖外部服务（如 API、SaaS 工具），在智能体文件的 frontmatter 中通过 `services` 字段声明。

## 安装与快速开始

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

1. 访问 [agencyagents.app](https://agencyagents.app) 下载适用于 macOS、Linux 或 Windows 的桌面应用。
2. 安装并打开应用，浏览智能体列表，选择目标 AI 工具，一键安装。

**方式二：使用命令行脚本**

1. 克隆仓库：`git clone https://github.com/msitarzewski/agency-agents.git`
2. 进入目录：`cd agency-agents`
3. 生成集成文件：`./scripts/convert.sh`
4. 交互式安装：`./scripts/install.sh`（自动检测已安装的工具，并显示选择界面）
5. 或指定工具安装：`./scripts/install.sh --tool claude-code`

**方式三：手动复制**

将智能体文件复制到对应工具的目录，例如：

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

## 典型使用方法

**在 Claude Code 中激活智能体**：

安装后，在 Claude Code 会话中直接引用智能体名称，例如：

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

**在 Cursor 中使用规则**：

安装后，Cursor 会自动应用 `.cursor/rules/` 中的规则，可显式引用：

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

**在 OpenCode 中使用**：

安装后，在 OpenCode 中通过 `@agent-name` 引用，例如：

```
@backend-architect design this API.
```

**自定义安装**：

只安装特定团队或智能体：

```bash
./scripts/install.sh --tool claude-code --division engineering,security
./scripts/install.sh --tool cursor --agent frontend-developer,ui-designer
```

## 配置与部署要点

- **配置文件**：`divisions.json` 定义部门列表，`tools.json` 定义工具集，修改后需运行 `scripts/check-divisions.sh` 和 `scripts/check-tools.sh` 验证。
- **生成集成文件**：每次新增或修改智能体后，需重新运行 `./scripts/convert.sh` 以生成各工具的集成文件。
- **安装目录**：不同工具的安装目录不同，例如 Claude Code 为 `~/.claude/agents/`，Cursor 为 `.cursor/rules/`，OpenCode 为 `.opencode/agents/`。
- **OpenCode 限制**：OpenCode 运行时仅注册约 119 个智能体，超出部分会被静默丢弃，建议使用 `--division` 参数安装子集。
- **并行安装**：可使用 `--parallel` 参数加速安装，但输出顺序不确定。
- **许可证**：MIT 许可证，可自由使用、修改和分发。

## 限制、风险与许可证

- **限制**：智能体内容为 Markdown 提示词，实际效果取决于底层 AI 模型的能力；部分智能体可能依赖外部服务，需自行配置 API 密钥。
- **风险**：智能体输出可能包含错误或不准确信息，需人工审核；安装脚本可能修改系统文件，建议先备份。
- **许可证**：MIT License，允许商业和个人使用，无需署名（但建议注明来源）。

## 官方链接

- GitHub 仓库：https://github.com/msitarzewski/agency-agents
- 桌面应用下载：https://github.com/msitarzewski/agency-agents-app/releases/latest
- 桌面应用官网：https://agencyagents.app
- GitHub Discussions：https://github.com/msitarzewski/agency-agents/discussions
- GitHub Issues：https://github.com/msitarzewski/agency-agents/issues

## 信息来源和分析时间

- 信息来源：GitHub 仓库 README、CONTRIBUTING.md 文档。
- 分析时间：2025年4月（基于当前仓库内容）。