name: subagent-factory description: 按需创建专门的Claude代码智能体。指导创建具有正确前置元数据、有效提示词和工具范围的智能体定义文件。当用户说“创建智能体”、“新建子智能体”、“为…制作智能体”、“构建智能体”、“生成智能体”或想要为特定任务定义自定义智能体时使用。

子智能体工厂

用于创建专门Claude代码智能体的工厂。生成具有适当配置、有效系统提示词和适当工具访问权限的智能体定义文件。

何时激活此技能

用户说：“创建智能体”、“新建子智能体”、“构建智能体”
用户想要：用于特定任务的自定义智能体
用户需要：智能体定义文件、系统提示词、工具配置
用户询问：如何制作专门智能体、如何委派工作

两种创建模式

快速模式（直接创建）

为有经验的用户提供的快速路径。最少的问题，直接文件生成。

使用时机：您确切知道需要什么智能体。

参见：workflows/quick-create.md

访谈模式（引导创建）

交互式工作流程，每个步骤都有问题和自定义选项。

使用时机：探索智能体设计、学习流程或创建复杂智能体。

参见：workflows/interview-create.md

快速参考：智能体架构

必需的前置元数据字段

---
name: agent-name                    # 必需：kebab-case标识符
description: 何时使用此智能体 # 必需：自然语言触发词
---

可选的前置元数据字段

tools: Read, Write, Bash           # 逗号分隔，省略则继承所有
model: sonnet                      # sonnet|opus|haiku|inherit
permissionMode: default            # 权限处理模式
skills: skill-name                 # 自动加载技能

系统提示词（Markdown正文）

前置元数据之后的Markdown内容是智能体的系统提示词。

关键要素：

身份/角色定义
明确职责
分步工作流程
具体检查清单
输出格式规范
边界（做/不做）

核心原则

1. 单一职责

每个智能体应有一个明确的目的，而不是多个松散相关的任务。

2. 适当高度

不要过于规定性（脆弱的if-else逻辑），也不要太模糊（无用的陈词滥调）。提供清晰的指导，让智能体思考。

3. 显式工具范围

授予最低必要的工具。只读智能体不需要Write。审查者不需要Bash。

4. 渐进式示例

包含3-5个展示期望行为模式的具体示例。

5. 可操作指令

使用命令式形式：“运行测试”、“分析代码”、“生成报告”（而不是“测试被运行”）。

按工具访问划分的智能体类型

只读智能体（审查者、审计员）

tools: Read, Grep, Glob

用于：代码审查、安全审计、合规检查

研究智能体（分析师）

tools: Read, Grep, Glob, WebFetch, WebSearch, Write（如果需要保存研究）

用于：技术研究、文档查找、最佳实践

代码编写者（实现者）

tools: Read, Write, Edit, Bash, Grep, Glob

用于：功能实现、错误修复、重构

全栈智能体（端到端）

tools: Read, Write, Edit, Bash, Grep, Glob, WebFetch
# 根据需要加上MCP工具

用于：完整功能交付、集成工作

常见智能体模式

安全审查员

目的：分析代码中的漏洞工具：Read, Grep, Glob 关键检查清单：输入验证、身份验证、密钥、SQL注入、XSS、CSRF

测试运行器

目的：执行测试、诊断故障、提出修复方案工具：Read, Edit, Write, Bash, Grep, Glob 关键工作流程：运行测试 → 诊断故障 → 提出修复方案 → 验证

技术研究员

目的：调查技术、API、最佳实践工具：Read, Grep, Glob, WebFetch, WebSearch 关键输出：比较矩阵、带理由的建议、后续步骤

代码实现者

目的：按照规范构建功能工具：Read, Write, Edit, Bash, Grep, Glob 关键工作流程：理解需求 → 设计 → 实现 → 测试 → 文档

文件位置

智能体定义位于：

项目级别：.claude/agents/（版本控制，团队共享）
用户级别：~/.claude/agents/（个人智能体）

优先级：项目智能体覆盖同名用户智能体。

任务工具集成

智能体通过任务工具调用：

使用security-reviewer智能体分析身份验证模块的漏洞。

内置智能体类型：

general-purpose - 完整工具，Sonnet模型
explore - 只读，Haiku模型（快速搜索）
plan - 规划期间的研究和分析

自定义智能体：从.claude/agents/按名称引用

并行执行：最多10个并发智能体（超过则自动排队）

关键见解

系统提示词是Markdown正文，不是前置元数据 - 常见错误
工具继承 - 省略tools字段以继承所有；指定以限制
模型选择 - 快速搜索用haiku，平衡工作用sonnet，复杂推理用opus
令牌开销 - 每个智能体生成成本约20k令牌；平衡并行化
上下文隔离 - 每个智能体有独立的上下文窗口（防止交叉污染）

快速开始

简单示例：

# .claude/agents/test-runner.md
---
name: test-runner
description: 运行测试、诊断故障、提出修复方案。代码更改后使用。
tools: Read, Edit, Bash, Grep
model: sonnet
---

您是一个测试自动化专家。

## 工作流程
1. 使用项目测试命令运行测试套件
2. 如果失败：捕获输出，读取测试文件，诊断根本原因
3. 提出最小修复方案并附理由
4. 重新运行以验证

## 输出格式
- 测试结果摘要
- 故障分析（如有）
- 带证据的修复建议

有关详细示例和模式，请参阅参考文档。

后续步骤

选择创建模式（快速或访谈）
定义智能体目的和职责
选择适当的工具
编写有效的系统提示词
用真实场景测试
基于失败迭代

从workflows/quick-create.md开始直接创建，或从workflows/interview-create.md开始引导流程。

子智能体工厂Skill subagent-factory