---
name: sub-agent-design
description: |
  当用户任务复杂、想让"一个专职角色"只干一件事（如挑计划漏洞/做研究/审稿），或问"怎么建 sub-agent"时调用。
  提供子 Agent 设计模板：角色定义 + 单一职责 + 边界 + 与主 Agent 的交接。
  不适用于：单一线性任务（一个 Agent 够）；或角色职责模糊。
  触发信号: "建个子 agent" "sub-agent" "让一个 AI 专门挑错" "Plan Roaster" "拆分任务给多个 AI"。
source_book: 《Claude Code for Non-Coders (6 Hour Course)》
source_chapter: "140:23 Sub-Agents Explained; 151:41 Building a Sub-Agent: The Plan Roaster; 163:46 When to Use"
tags: [claude-code, sub-agent, delegation, non-coder]
related_skills: [skill-authoring-sop, context-engineering-checklist]
version: 1.0.0
author: sunusun-me
license: MIT
platforms: [linux, macos, windows]
metadata:
  hermes:
    category: sop

---

# Sub-Agent 设计

## R — 原文 (Reading)

> "A sub-agent is a specialist you spin up for one job. Like the Plan Roaster — you give it your plan, it only does one thing: tears it apart and finds what's weak. Then hands back."
>
> — Course author, 151:41 Building a Sub-Agent

---

## I — 方法论骨架 (Interpretation)

主 Agent 不必包揽一切。把"单一专职"拆给子 Agent：
- **角色**：只干一件定义清楚的事（如挑计划漏洞、查资料、审代码）。
- **边界**：输入是什么、输出是什么、不许越界。
- **交接**：主 Agent 派活、收结果，自己综合。

价值：专职角色比"全能聊天窗"更可靠、更不易跑题。非程序员能用"派一个挑刺的"来补自己的盲区。

---

## A1 — 书中的应用 (Past Application)

### 案例 1: Plan Roaster 子 Agent
- **问题**: 自己的计划有盲点但自己看不出。
- **方法论的使用**: 建专职子 Agent，唯一职责=挑计划漏洞，返回弱点清单。
- **结论**: 主 Agent 拿到弱点后改计划，质量提升。
- **结果**: 演示"专职红队"的价值。

---

## A2 — 触发场景 (Future Trigger) ★

### 用户会在什么情境下需要这个 skill?
1. 任务有清晰可隔离的"子职责"。
2. 想给自己的产出加一道专职审查。
3. 主 Agent 在一个环节反复出错。

### 语言信号
- "建个子 agent 专门做 X"
- "让 AI 挑我计划的错"
- "sub-agent 怎么用"

### 与相邻 skill 的区分
- 与 `skill-authoring-sop` 区别：sub-agent 是"角色"，skill 是"流程"。

---

## E — 可执行步骤 (Execution)

1. **定单一职责**
   - 一句话说清这个子 Agent 只做什么（如"只挑计划漏洞"）。
   - 完成标准：职责不可再分、可验证。
2. **写角色 + 边界**
   - 角色描述、输入格式、输出格式、禁止项。
   - 完成标准：边界清晰，不会越权跑题。
3. **接交接协议**
   - 主 Agent 如何派活、如何收结果、如何综合。
   - 完成标准：一次端到端跑通。

---

## B — 边界 (Boundary) ★

### 不要在以下情况使用此 skill
- 线性单任务（一个 Agent 足够）。
- 职责含糊（"帮我处理一下"）难成 sub-agent。

### 作者在书中警告的失败模式
- 子 Agent 职责太宽 → 又变回全能窗，失去专职价值。

### 作者的盲点 / 时代局限
- 多子 Agent 协调成本/上下文传递损耗未深谈。

### 容易混淆的邻近方法论
- sub-agent ≠ skill；一个角色、一个流程。

---

## 相关 skills
- depends-on: skill-authoring-sop
- contrasts-with: context-engineering-checklist
- composes-with: second-brain-setup

---

## 审计信息
- **验证通过**: V1 ✓ / V2 ✓ / V3 ✓
- **测试通过率**: 待阶段4
- **蒸馏时间**: 2026-07-16