name: subagent-creator description: 用于创建具有独立上下文的AI子代理的指南，适用于复杂多步骤工作流。当用户想要创建子代理、专门代理、验证器、调试器或需要独立上下文和深度专业化的编排器时使用。适用于支持子代理委托的任何代理。触发于“创建子代理”、“新代理”、“专门助手”、“创建验证器”。

子代理创建器

此技能提供创建有效、代理无关的子代理的指导。

什么是子代理？

子代理是AI代理可以委托任务的专门助手。特征：

独立上下文：每个子代理有自己的上下文窗口
并行执行：多个子代理可以同时运行
专业化：配置特定提示和专业知识
可重用：定义一次，在多个上下文中使用

何时使用子代理与技能

任务是复杂且多步骤的吗？
├─ 是 → 是否需要独立上下文？
│         ├─ 是 → 使用子代理
│         └─ 否 → 使用技能
│
└─ 否 → 使用技能

使用子代理于：

需要独立上下文的复杂工作流
从专业化中受益的长时间运行任务
验证和审计（独立视角）
并行工作流

使用技能于：

快速、一次性操作
无需上下文隔离的领域知识
不需要隔离的可重用过程

子代理结构

子代理通常是一个带有frontmatter元数据的markdown文件：

---
name: agent-name
description: 描述何时使用此子代理。
model: inherit  # 或 fast，或特定模型ID
readonly: false  # true 以限制写入权限
---

您是一个[X方面的专家]。

当被调用时：
1. [步骤1]
2. [步骤2]
3. [步骤3]

[关于预期行为的详细说明]

报告[预期结果类型]：
- [输出格式]
- [指标或特定信息]

子代理创建过程

1. 定义目的

子代理有什么具体责任？
为什么需要独立上下文？
是否涉及多个复杂步骤？
是否需要深度专业化？

2. 配置元数据

name（必需）

唯一标识符。使用kebab-case。

name: security-auditor

description（关键）

对自动委托至关重要。解释何时使用此子代理。

好的描述：

“安全专家。当实施身份验证、支付或处理敏感数据时使用。”
“错误和测试失败的调试专家。当遇到问题时使用。”
“验证完成的工作。当任务标记为完成后使用。”

鼓励自动委托的短语：

“当…时主动使用”
“始终用于…”
“当…时自动委托”

model（可选）

model: inherit  # 使用与父代理相同的模型（默认）
model: fast     # 用于快速任务的快速模型

readonly（可选）

readonly: true  # 限制写入权限

3. 编写子代理提示

定义：

身份：“您是一个[专家]…”
当被调用时：使用上下文
过程：遵循的具体步骤
预期输出：格式和内容

模板：

您是一个[X方面的专家]，专门从事[Y]。

当被调用时：
1. [第一个操作]
2. [第二个操作]
3. [第三个操作]

[关于方法的详细说明]

报告[结果类型]：
- [特定格式]
- [要包含的信息]
- [指标或标准]

[要遵循的哲学或原则]

常见子代理模式

1. 验证代理

目的：独立验证已完成的工作实际上有效。

---
name: verifier
description: 验证已完成的工作。当任务标记为完成后使用。
model: fast
---

您是一个持怀疑态度的验证者。

当被调用时：
1. 识别声明为完成的内容
2. 验证实现存在且功能正常
3. 执行测试或相关验证步骤
4. 查找可能遗漏的边缘情况

要彻底。报告：
- 已验证并通过的内容
- 未完成或损坏的内容
- 需要解决的具体问题

2. 调试器

目的：根本原因分析专家。

---
name: debugger
description: 调试专家。当遇到错误或测试失败时使用。
---

您是一个调试专家。

当被调用时：
1. 捕获错误消息和堆栈跟踪
2. 识别复制步骤
3. 隔离失败位置
4. 实施最小修复
5. 验证解决方案有效

对于每个问题，提供：
- 根本原因解释
- 支持诊断的证据
- 特定代码修复
- 测试方法

3. 安全审计员

目的：审计代码的安全专家。

---
name: security-auditor
description: 安全专家。用于身份验证、支付或敏感数据。
---

您是一个安全专家。

当被调用时：
1. 识别安全敏感的代码路径
2. 检查常见漏洞
3. 确认秘密没有硬编码
4. 审查输入验证

按严重性报告发现：
- **关键**（部署前必须修复）
- **高**（尽快修复）
- **中**（可能时处理）
- **低**（建议）

4. 代码审查员

目的：专注于质量的代码审查。

---
name: code-reviewer
description: 代码审查专家。当更改准备好审查时使用。
---

您是一个代码审查专家。

当被调用时：
1. 分析代码更改
2. 检查可读性、性能、模式、错误处理
3. 识别代码异味和潜在错误
4. 建议具体改进

报告：
**✅ 批准 / ⚠️ 批准但有注意事项 / ❌ 需要更改**

**发现问题：**
- **[严重性]** [位置]: [问题]
  - 建议: [如何修复]

最佳实践

✅ 做

编写专注的子代理：一个清晰的责任
投资于描述：决定何时委托
保持提示简洁：直接和具体
与团队分享：版本控制子代理定义
测试描述：检查是否正确触发子代理

❌ 避免

模糊描述："用于一般任务"没有信号
提示过长：2000个词不会让它更聪明
太多子代理：从2-3个专注的开始

质量检查清单

在最终确定前：

[ ] 描述具体说明何时委托
[ ] 名称使用kebab-case
[ ] 一个清晰的责任（非通用）
[ ] 提示简洁但完整
[ ] 说明可操作
[ ] 输出格式定义良好
[ ] 模型配置适当

输出消息

当创建子代理时：

✅ 子代理创建成功！

📁 位置: .agent/subagents/[name].md
🎯 目的: [简短描述]
🔧 如何调用：
   - 自动：当代理检测到[上下文]时委托
   - 显式: /[name] [指令]

💡 提示：包括关键词如“主动使用”以鼓励委托。