# The Agency 使用指南

> **144 个 AI 专家代理，11 款工具即装即用**

---

## 目录

1. [工具支持一览](#工具支持一览)
2. [快速安装](#快速安装)
3. [激活方式对照表](#激活方式对照表)
4. [实战示例](#实战示例)
5. [部门速查](#部门速查)

---

## 工具支持一览

| 工具 | 安装路径 | 激活方式 |
|------|---------|---------|
| Claude Code | `~/.claude/agents/` | `激活前端开发者模式` |
| GitHub Copilot | `~/.github/agents/` + `~/.copilot/agents/` | `Use Frontend Developer agent` |
| Antigravity (Gemini) | `~/.gemini/antigravity/skills/` | `@agency-frontend-developer` |
| Gemini CLI | `~/.gemini/extensions/agency-agents/` | `@agency-frontend-developer` |
| OpenCode | `.opencode/agents/` | `@backend-architect` |
| Cursor | `.cursor/rules/` | `@security-engineer` |
| Aider | `CONVENTIONS.md` | `Use the Frontend Developer agent` |
| Windsurf | `.windsurfrules` | `Use Reality Checker agent` |
| OpenClaw | `~/.openclaw/agency-agents/` | `openclaw gateway restart` |
| Qwen Code | `~/.qwen/agents/` | `Use frontend-developer agent` |
| Kimi Code | `~/.config/kimi/agents/` | `kimi --agent-file <path>` |

---

## 快速安装

### 方式一：自动检测安装（推荐）

```bash
git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents

# 生成所有工具的集成文件
./scripts/convert.sh --parallel

# 交互式安装（自动检测已安装的工具）
./scripts/install.sh
```

### 方式二：指定工具安装

```bash
# 只安装 Claude Code
./scripts/install.sh --tool claude-code

# 只安装 Cursor
./scripts/install.sh --tool cursor

# 只安装 OpenClaw
./scripts/install.sh --tool openclaw
```

### 方式三：非交互式（CI/脚本用）

```bash
./scripts/install.sh --no-interactive --tool all
./scripts/install.sh --no-interactive --parallel --tool all
```

---

## 激活方式对照表

### Claude Code

```bash
# 直接对话激活
激活前端开发者模式，帮我审查这段 React 代码

# 更具体的要求
使用前端开发者模式重构这个登录组件，要 Type Safety

# 多个代理协作
激活后端架构师 + 前端开发者模式，设计一个电商 API
```

### Cursor

```bash
# 在 Composer 或 Chat 中直接 @ 代理名
@frontend-developer 审查这段代码

@backend-architect 设计这个微服务架构

@security-engineer 检查这个登录流程的安全问题
```

### Windsurf (Cascade)

```
Use the Frontend Developer agent to build a dashboard
Use the Reality Checker agent before shipping
```

### OpenClaw

```bash
# 安装后重启网关
openclaw gateway restart

# 在 OpenClaw 对话中引用代理
@frontend-developer 构建用户设置页面
```

### Antigravity (Google Gemini)

```
@agency-frontend-developer 帮我写一个 React 表单组件
@agency-growth-hacker 设计一个增长策略
```

### Aider

```bash
# 在项目中创建 CONVENTIONS.md
./scripts/install.sh --tool aider

# 然后在 Aider 对话中
Use the Frontend Developer agent to refactor the auth module
```

---

## 实战示例

### 示例 1：构建 React 应用

```
激活前端开发者模式

请帮我：
1. 创建一个 React + TypeScript 项目结构
2. 用 Vite 作为构建工具
3. 包含路由、状态管理（Zustand）
4. 响应式设计，适配移动端
```

### 示例 2：代码安全审查

```
@security-engineer 审查这段用户认证代码

// 检查以下内容：
// 1. SQL 注入
// 2. XSS 攻击
// 3. CSRF
// 4. 密码存储安全
```

### 示例 3：增长策略规划

```
@agency-growth-hacker 设计一个 B2B SaaS 的增长策略

背景：
- 目标用户：中小企业管理层
- 产品：项目管理工具
- 预算：每月 5000 美元
- 当前月活：500 用户
```

### 示例 4：多代理协作

```
团队组成：
1. @agency-backend-architect - 设计 API 架构
2. @agency-frontend-developer - 前端实现
3. @agency-growth-hacker - 用户获取策略
4. @agency-security-engineer - 安全审查

任务：设计并实现一个订阅制 API 服务
```

---

## 部门速查

| 部门 | 代表代理 | 使用场景 |
|------|---------|---------|
| 💻 工程部 | `frontend-developer` | 代码开发、架构设计 |
| 🎨 设计部 | `ui-designer` | 界面设计、品牌风格 |
| 💰 付费媒体 | `ppc-strategist` | Google/Meta 广告投放 |
| 💼 销售部 | `outbound-strategist` | B2B 外呼、提案撰写 |
| 📢 市场部 | `content-creator` | 内容营销、社交媒体 |
| 📊 产品部 | `product-manager` | 需求分析、路线图 |
| 🎬 项目管理 | `project-shepherd` | 进度跟踪、风险管理 |
| 🧪 测试部 | `qa-engineer` | 测试计划、自动化 |
| 📞 客服部 | `support-representative` | 客户支持、问题解决 |
| 🔍 核查质量 | `fact-checker` | 信息核实、质量把控 |
| 🔧 专业化 | `document-generator` | PDF/PPT 生成、法律顾问 |
| 💵 财务部 | `financial-analyst` | 财务建模、投资分析 |
| 🎮 游戏开发 | `game-designer` | Unity/Unreal/Godot 开发 |
| 📚 学术部 | `anthropologist` | 世界观构建、叙事设计 |

---

## 常见问题

### Q: 需要 API Key 吗？
**A:** The Agency 本身不需要，但各工具（Claude Code、Gemini CLI 等）可能需要各自平台的 API Key。

### Q: 可以自定义代理吗？
**A:** 可以！每个代理都是 `.md` 文件，直接编辑即可定制人格、工作流程和交付标准。

### Q: 支持中文吗？
**A:** 代理人格是英文的，但输出内容可以用中文描述需求，代理会用英文思维处理后输出。

### Q: 代理会记忆对话历史吗？
**A:** 取决于工具本身的能力，代理定义的是人格和工作流程，不是记忆系统。

### Q: 可以同时用多个代理吗？
**A:** 可以！一个任务可以分配多个代理协作，各司其职。

---

## 资源链接

- 🌐 官方仓库：https://github.com/msitarzewski/agency-agents
- 📖 中文翻译：https://github.com/jnMetaCode/agency-agents-zh
- 💬 社区讨论：https://github.com/msitarzewski/agency-agents/discussions

---

<div align="center">

**🎭 你的 AI 梦之队，静候召唤**

</div>