## 项目概述

agency-agents-zh 是 [agency-agents](https://github.com/msitarzewski/agency-agents) 的中文社区版，提供 268 个即插即用的 AI 专家角色，覆盖工程、设计、营销、金融等 20 个部门。项目在完整翻译上游的基础上，新增了 53 个中国市场原创智能体（如小红书运营、抖音策略、飞书集成等），并支持 18 种主流 AI 编程工具（如 Claude Code、Cursor、Copilot 等）。项目采用 MIT 许可证，主要语言为 Shell。

## 核心功能

- **专家角色库**：268 个 AI 智能体，每个都有独立的人设、专业流程和可交付成果。
- **多工具支持**：支持 18 种 AI 编程工具，通过脚本一键安装或转换格式。
- **中国市场原创**：包含 53 个针对中国平台（小红书、抖音、微信、飞书等）和垂直领域（政务、医疗、工业等）的智能体。
- **编排器集成**：搭配 agency-orchestrator，可通过自然语言让多个专家按 DAG 自动协作。
- **在线浏览**：提供在线专家库，可搜索、筛选并复制每位专家的完整提示词。

## 适用与不适用场景

**适用场景**：
- 需要快速为 AI 编程工具配置专业角色（如代码审查、安全审计、UI 设计）。
- 中国市场运营（小红书、抖音、微信公众号等）和垂直领域（政务、医疗、工业）的 AI 辅助。
- 多智能体协作项目，需要编排多个专家角色。

**不适用场景**：
- 需要深度定制或训练自有模型的场景（本项目仅提供提示词角色）。
- 对工具兼容性有特殊要求（仅支持列出的 18 种工具）。
- 需要离线或私有化部署的完整解决方案（本项目为角色库，不包含运行时）。

## 技术架构与依赖

- **语言**：Shell（脚本）、Markdown（智能体定义）。
- **依赖**：Node.js（用于 npm 包和编排器）、各 AI 编程工具（如 Claude Code、Cursor 等）。
- **架构**：智能体以 Markdown 文件存储，通过 scripts/ 目录下的 convert.sh 和 install.sh 脚本转换为各工具格式并安装。
- **编排器**：agency-orchestrator（npm 包），支持 DAG 并行、断点续跑。

## 安装与快速开始

### 方式一：一键安装

```bash
# 自动检测已安装的工具，一键安装
./scripts/install.sh

# 或指定安装到特定工具
./scripts/install.sh --tool claude-code
./scripts/install.sh --tool cursor
```

### 方式二：手动复制

```bash
# Claude Code / GitHub Copilot（直接复制即可）
cp -r marketing/*.md ~/.claude/agents/
```

### 方式三：作为提示词参考

浏览智能体列表，复制或改编所需内容。

## 典型使用方法

### 激活智能体

在支持的 AI 编程工具中，用自然语言激活，例如：

```
激活前端开发者模式，帮我构建一个 React 组件。
```

### 使用编排器

```bash
npm install -g agency-orchestrator
ao compose "帮我写一篇关于 AI Agent 的深度分析文章" --run
```

### 转换和安装到特定工具

```bash
./scripts/convert.sh --tool cursor
./scripts/install.sh --tool cursor
```

## 配置与部署要点

- **转换格式**：除 Claude Code 和 GitHub Copilot 外，其他工具需先运行 `./scripts/convert.sh` 转换格式。
- **精选安装**：对于 Cursor、Trae 等工具，建议只安装 10-20 个常用智能体，避免规则过多影响匹配准确度。
- **Hermes Discord 限制**：Discord 模式下不要一次性全量安装，需按分类分批安装，避免超过 API 限制。
- **环境变量**：DeerFlow 可通过 `DEERFLOW_SKILLS_DIR` 自定义安装路径。

## 限制、风险与许可证

- **限制**：智能体为提示词角色，不包含模型或运行时；工具支持有限（18 种）。
- **风险**：部分智能体可能涉及特定平台规则（如小红书、抖音），使用时需遵守平台政策；项目包含赞助商广告，请注意甄别。
- **许可证**：MIT License，自由使用，商业或个人均可。

## 官方链接

- GitHub 仓库：https://github.com/jnMetaCode/agency-agents-zh
- 上游项目：https://github.com/msitarzewski/agency-agents
- 编排器：https://github.com/jnMetaCode/agency-orchestrator
- 在线专家库：https://ao.aiolaola.com/experts
- npm 包：https://www.npmjs.com/package/agency-agents-zh

## 信息来源和分析时间

- 信息来源：GitHub 仓库 README、CONTRIBUTING.md、最新发布信息（v1.2.6，2026-06-16）。
- 分析时间：2026-06-16（基于最新发布信息）。