name: 元代理创建 description: 创建元提示、元代理和元技能,这些组件用于构建其他代理组件。适用于扩展代理层开发、创建生成器/模板或实施“构建系统的系统”模式。 allowed-tools: 读取、查找、全局、写入
元代理创建
创建生成其他组件的元级代理组件的指南。
核心哲学
“构建构建系统的系统。不要工作在应用层。”
元代理提供乘数杠杆:
- 元提示:1个提示创建N个提示
- 元代理:1个代理创建N个代理
- 元技能:1个技能创建N个技能
元代理层次结构
┌─────────────────────────────────────────────────────┐
│ 级别3:元元(很少需要) │
│ • 创建生成器的生成器 │
└──────────────────────┬──────────────────────────────┘
│
┌──────────────────────▼──────────────────────────────┐
│ 级别2:元组件 │
│ • 元提示(提示生成器) │
│ • 元代理(代理构建器) │
│ • 元技能(技能脚手架) │
└──────────────────────┬──────────────────────────────┘
│
┌──────────────────────▼──────────────────────────────┐
│ 级别1:标准组件 │
│ • 领域提示 │
│ • 专业化代理 │
│ • 任务特定技能 │
└──────────────────────┬──────────────────────────────┘
│
┌──────────────────────▼──────────────────────────────┐
│ 级别0:应用层 │
│ • 最终用户功能 │
│ • 业务逻辑 │
└─────────────────────────────────────────────────────┘
何时使用
- 扩展代理层开发(需要4个以上类似组件)
- 为提示/代理/技能创建生成器或模板
- 实施“构建系统的系统”模式
- 为团队/组织建立一致模式
- 使他人能够创建代理组件
- 通过乘数回报最大化杠杆
元提示模板
元提示是生成其他提示的提示。
---
description: 为{目的}生成一个{类型}提示
argument-hint: <名称> [选项...]
---
# 元提示:{类型}生成器
生成遵循已建立模式的、结构良好的{类型}提示。
## 参数
- `$1`:生成提示的名称(必需)
- `$2`:主要目的/领域(可选)
- `$ARGUMENTS`:附加上下文
## 模板结构
生成的提示将遵循此结构:
### YAML前导
```yaml
---
description: {基于目的生成}
argument-hint: {适合提示类型}
---
```
### 包含部分
1. **目的**:明确说明提示的作用
2. **参数**:输入参数及默认值
3. **工作流程**:逐步说明
4. **输出格式**:预期交付结构
5. **注意事项**:重要考虑因素
## 生成规则
1. 使用祈使语气(“执行X”,而不是“您应该执行X”)
2. 包含具体示例
3. 明确指定输出格式
4. 添加验证/核实步骤
5. 保持在{行数限制}行以内
## 输出
将生成的提示写入:`.claude/commands/{名称}.md`
报告:
- 生成的提示名称
- 位置
- 包含的关键部分
元代理模板
元代理创建其他代理。
---
name: 元代理
description: 遵循已建立模式和最佳实践创建新的专业化代理。
tools: 读取、写入、全局、查找
model: opus
---
# 元代理:代理构建器
创建遵循Claude Code模式的结构良好的代理。
## 输入要求
调用时,预期:
- 代理名称(短横线连接)
- 代理目的(1-2句话)
- 必需工具(列表)
- 模型偏好(opus|sonnet|haiku)
- 领域上下文
## 代理模板
```yaml
---
name: {代理名称}
description: {目的描述,不超过200字符}
tools: {工具1, 工具2, ...}
model: {opus|sonnet|haiku}
---
# {代理名称}
{详细目的及何时使用此代理}
## 能力
- 能力1
- 能力2
## 工作流程
### 步骤1:{第一步}
{说明}
### 步骤2:{第二步}
{说明}
## 输出格式
{预期输出结构}
## 约束
- 约束1
- 约束2
```
## 生成工作流程
1. **分析请求**:理解代理目的
2. **选择工具**:选择最小必需工具
3. **选择模型**:
- haiku:简单、快速任务
- sonnet:平衡推理
- opus:复杂、关键任务
4. **设计工作流程**:创建逐步过程
5. **编写代理**:生成代理文件
6. **注册**:如果需要,更新plugin.json
## 验证
完成前:
- [ ] 描述不超过200字符
- [ ] 工具最小且适当
- [ ] 模型匹配任务复杂性
- [ ] 工作流程完整且可操作
元技能模板
元技能创建其他技能。
---
name: 元技能
description: 创建遵循Claude Code模式的新技能,包含适当的YAML前导、结构和文档。
version: 1.0.0
allowed-tools: 读取、写入、全局、查找
tags: [meta, skill, generator, scaffolder]
---
# 元技能:技能生成器
创建遵循已建立模式的结构良好的技能。
## 技能模板
```yaml
---
name: {技能名称}
description: {清晰描述技能作用及何时使用}
version: 1.0.0
allowed-tools: {工具1, 工具2, ...}
tags: [{标签1}, {标签2}, ...]
---
# {技能名称}
{介绍和目的}
## 何时使用
- 用例1
- 用例2
## 关键概念
### 概念1
{解释}
### 概念2
{解释}
## 模式
### 模式名称
{描述和示例}
## 反模式
| 反模式 | 问题 | 解决方案 |
| --- | --- | --- |
| ... | ... | ... |
## 相关技能
- `skill-1`:关系
- `skill-2`:关系
```
## 技能生成规则
1. **命名**:使用名词短语(短横线连接)
2. **描述**:不超过200字符,以动作动词开头
3. **标签**:4-8个相关关键词
4. **工具**:最小必需集
5. **结构**:一致部分
## 目录结构
```text
skills/{技能名称}/
SKILL.md # 主要技能文件
references/ # 可选支持文档
scripts/ # 可选自动化
```
创建元组件
步骤1:识别模式
创建元组件前,识别:
- 它将生成什么组件?
- 共同结构是什么?
- 实例间什么变化?
- 需要什么验证?
步骤2:设计模板
模板应:
- 捕获不变结构
- 清晰标记变量部分
- 包含验证规则
- 提供示例
步骤3:构建生成器
生成器应:
- 解析输入参数
- 应用带有变量的模板
- 验证输出
- 写入正确位置
步骤4:测试生成
通过以下方式验证:
- 生成一个简单组件
- 生成一个复杂组件
- 测试边缘情况
- 验证所有输出有效
何时创建元组件
| 情况 | 创建元组件? | 原因 |
|---|---|---|
| 需要1个组件 | 否 | 直接创建更快 |
| 需要2-3个类似组件 | 可能 | 取决于复杂性 |
| 需要4个以上类似组件 | 是 | 元组件划算 |
| 建立模式 | 是 | 编码最佳实践 |
| 使他人能够创建 | 是 | 确保一致性 |
反模式
| 反模式 | 问题 | 解决方案 |
|---|---|---|
| 过度抽象 | 元元元 | 停在2个级别 |
| 僵化模板 | 无法处理变化 | 构建灵活性 |
| 无示例 | 用户不理解 | 包含具体示例 |
| 无验证 | 生成不良输出 | 始终验证结果 |
真实世界元组件
来自agent-experts仓库
.claude/commands/meta_prompt.md # 创建新提示
.claude/agents/meta-agent.md # 创建新代理
.claude/skills/meta-skill/SKILL.md # 创建新技能
TAC插件示例
tac/agents/prompt-generator.md # 生成提示
tac/agents/agent-builder.md # 构建代理
tac/skills/tool-design/SKILL.md # 设计工具
杠杆计算
元组件提供乘数回报:
无元组件:
10个代理 × 每个30分钟 = 300分钟
有元组件:
1个元代理 × 60分钟 + 10个生成 × 每个5分钟 = 110分钟
节省:63%
所需组件越多,元组件越划算。
相关技能
agent-expert-creation:自改进专家template-meta-prompt-creation:级别6提示prompt-level-selection:选择提示复杂性
最后更新: 2025-12-15
版本历史
- v1.0.0 (2025-12-26):初始发布