Day 7｜进阶实战：Subagents + Plugins 完成复杂任务

🎯 目标：用多智能体协作完成真实复杂任务

一、理论部分

升华主题

"从'单兵作战'到'AI 团队协作'"

一个人能做到的事情有限，一个 AI 助手也一样。但当你有了一支 AI 团队——

• • 代码审查专家（只读权限）
• • 安全扫描专家（只读权限）
• • 测试工程师（只读权限）

三个专家同时工作，主 Agent 汇总结果，效率和质量都翻倍。

Subagents：专业化 AI 助手

Subagent 是拥有独立上下文的专用 AI 助手：

┌─────────────────────────────────────────────────────┐│              主 Agent（协调者）                        ││                                                      ││  接收任务 → 分发给 Subagent → 汇总结果                │└─────────────────────────────────────────────────────┘                         │       ┌─────────────────┼─────────────────┐       ▼                 ▼                 ▼┌─────────────┐   ┌─────────────┐   ┌─────────────┐│  代码审查   │   │  安全扫描   │   │  测试覆盖   ││  Agent      │   │  Agent      │   │  Agent      ││             │   │             │   │             ││  只读权限   │   │  只读权限   │   │  只读权限   │└─────────────┘   └─────────────┘   └─────────────┘

Subagent 特点：

• • 独立上下文，互不干扰
• • 专业化分工，各司其职
• • 可设置权限隔离（只读/可写）
• • 主 Agent 协调，统一输出

工具权限隔离

安全是第一要务。Subagent 可以精确控制权限：

code-reviewer:  permissions:    read: ["*.ts", "*.tsx"]  # 只读 TypeScript 文件    write: []                  # 禁止写入secure-reviewer:  permissions:    read: ["*.ts", "*.js", "*.py"]  # 只读代码文件    write: []                          # 禁止写入    network: false                     # 禁止网络请求

为什么权限隔离重要？

• • 代码审查只需读代码，不需要写
• • 安全扫描不需要修改文件
• • 测试 Agent 只需要读，不需要部署

Plugins：一键部署完整流水线

Plugin 是预配置的 Subagent 组合，开箱即用：

终极组合

Slash Commands + Memory + Subagents + Hooks + MCP     │           │        │          │      │     ▼           ▼        ▼          ▼      ▼   快捷指令    项目记忆   多Agent    自动化   外部连接     │           │        │          │      │     └───────────┴────────┴──────────┴──────┘                       │                       ▼              ┌────────────────┐              │   完整工作流    │              └────────────────┘

一个复杂任务的完整流程：

1. 1. 你输入 /review-pr（Slash Command）
2. 2. 加载项目记忆（Memory）
3. 3. 主 Agent 分发任务给 3 个 Subagent
4. 4. Subagent 通过 MCP 读取 GitHub 数据
5. 5. Hooks 自动执行格式化检查
6. 6. 主 Agent 汇总三份报告
7. 7. 输出完整审查结论

二、实操部分

场景：需要对 PR 进行多维度审查（质量 + 安全 + 测试覆盖）

Step 1：安装 Subagent 定义

# 创建 agents 目录mkdir -p ~/.claude/agents# 安装代码审查 Agentcp claude-howto/04-subagents/code-reviewer.md ~/.claude/agents/# 安装安全审查 Agentcp claude-howto/04-subagents/secure-reviewer.md ~/.claude/agents/# 安装测试工程师 Agentcp claude-howto/04-subagents/test-engineer.md ~/.claude/agents/

Subagent 定义示例（code-reviewer.md）：

# Code Reviewer Agent## 角色你是专业的代码审查专家，只读代码，不修改。## 职责- 检查代码可读性- 评估代码质量- 提出改进建议## 权限- read: ["*.ts", "*.tsx", "*.js"]- write: []## 输出格式生成结构化审查报告：- 总体评分- 优点清单- 问题清单- 改进建议

Step 2：安装 PR 审查 Plugin（完整流水线）

# 启动 Claude Codeclaude# 安装 PR 审查 Plugin/plugin install pr-review

Step 3：多 Agent 协作审查

# 启动 Claude Codeclaude# 输入多维度审查请求"审查这个 PR，运行完整的质量+安全+测试三维度审查"

观察 Claude 的工作流程：

┌─────────────────────────────────────────────────────┐│                                                      ││  主 Agent 接收任务                                    ││         │                                             ││         ▼                                             ││  ┌─────────────────────────────────────────────┐     ││  │  分发给 Subagent                            │     ││  └─────────────────────────────────────────────┘     ││         │                                             ││    ┌────┴────┬────────────┐                          ││    ▼         ▼            ▼                          ││ ┌──────┐ ┌──────┐   ┌──────┐                       ││ │代码  │ │安全  │   │测试  │                       ││ │审查  │ │扫描  │   │覆盖  │                       ││ │Agent │ │Agent │   │Agent │                       ││ │      │ │      │   │      │                       ││ │只读  │ │只读  │   │只读  │                       ││ └──┬───┘ └──┬───┘   └──┬───┘                       ││    │        │          │                            ││    └────────┴──────────┘                            ││              │                                      ││              ▼                                      ││  ┌─────────────────────────────────────────────┐     ││  │  主 Agent 汇总结果                          │     ││  └─────────────────────────────────────────────┘     ││              │                                      ││              ▼                                      ││  ┌─────────────────────────────────────────────┐     ││  │  生成完整审查报告                           │     ││  └─────────────────────────────────────────────┘     ││                                                      │└─────────────────────────────────────────────────────┘

Step 4：安装文档生成 Plugin

# 安装文档生成 Plugin/plugin install documentation# 使用"为这个项目生成完整的 API 文档"

三、完整审查报告示例

当多个 Subagent 协作完成审查后，你会得到这样一份报告：

# PR #123 完整审查报告## 📊 审查概览- PR 标题：feature/user-authentication- 变更规模：+300/-80 行- 审查时间：2 分钟- 审查模式：多 Agent 协作（质量 + 安全 + 测试）---## 🔍 代码质量审查（code-reviewer）**总体评分：** 8.5/10**优点：**- ✅ 类型定义完整，TypeScript 使用规范- ✅ 组件结构清晰，职责单一- ✅ 错误处理完善**问题：**- ⚠️ useAuth hook 过长（120行），建议拆分- ⚠️ 部分函数缺少 JSDoc 注释**建议：** 可合并，小问题可选修复---## 🔒 安全扫描（secure-reviewer）**总体评分：** 9/10**优点：**- ✅ 使用参数化查询，无 SQL 注入风险- ✅ 敏感信息未硬编码**问题：**- ⚠️ users.ts:45 存在敏感信息泄露风险- ⚠️ 建议添加速率限制防止暴力破解**建议：** 修复安全警告后合并---## 🧪 测试覆盖（test-engineer）**覆盖率：** 75%**优点：**- ✅ 核心逻辑测试覆盖完整**问题：**- ⚠️ useAuth 缺少边界情况测试- ⚠️ 缺少集成测试**建议：** 覆盖率达标，建议补充边界测试---## ✅ 最终结论| 维度 | 评分 | 状态 ||------|------|------|| 代码质量 | 8.5/10 | ✅ 通过 || 安全 | 9/10 | ⚠️ 需修复 || 测试 | 75% | ✅ 通过 |**建议：** 修复安全问题后合并---*审查完成，耗时 2 分钟 | 传统方式预计 30 分钟*

四、学员带走

3 个预置 Subagent

2 个官方 Plugin

多 Agent 协作 SOP

# 1. 安装 Subagentcp claude-howto/04-subagents/*.md ~/.claude/agents/# 2. 安装 Pluginclaude/plugin install pr-review# 3. 启动协作claude"审查这个 PR，运行完整的质量+安全+测试三维度审查"# 4. 查看结果# 主 Agent 输出汇总报告

五、公众号内容要点

升华主题

"从'单兵作战'到'AI 团队协作'"

以前一个人做 PR 审查：

• • 30 分钟审代码质量
• • 20 分钟查安全漏洞
• • 15 分钟看测试覆盖
• • 总计 65 分钟

现在 AI 团队协作：

• • 3 个 Agent 同时工作
• • 2 分钟完成
• • 效率提升 32 倍

协作关系图

        ┌─────────────┐        │  你是产品   │        │   经理     │        └──────┬──────┘               │ 提需求               ▼        ┌─────────────┐        │  主 Agent   │        │  (协调者)   │        └──────┬──────┘               │ 分发任务       ┌───────┼───────┐       ▼       ▼       ▼   ┌─────┐ ┌─────┐ ┌─────┐   │质量 │ │安全 │ │测试 │   │Agent│ │Agent│ │Agent│   └──┬──┘ └──┬──┘ └──┬──┘      │       │       │      └───────┴───────┘              │ 汇总报告              ▼        ┌─────────────┐        │  你收到     │        │ 完整报告    │        └─────────────┘

效率对比

📚 相关资源

• • claude-howto Subagents：https://github.com/anthropics/claude-code-howto
• • Claude Code Plugins：https://docs.anthropic.com
• • AI Agent 设计模式：https://anthropic.com/research