⚡

智能体开发Skill AgentDevelopment

该技能专注于为Claude Code插件创建和管理智能体，涵盖智能体结构设计、触发条件定义、系统提示编写、最佳实践应用和自主功能开发。关键词：智能体开发，Claude Code插件，AI智能体，系统提示，触发条件，前端元数据，插件开发，自主工作。

AI智能体 0 次安装 0 次浏览 更新于 3/21/2026

name: 智能体开发 description: 当用户询问“创建智能体”、“添加智能体”、“编写子智能体”、“智能体前端元数据”、“何时使用描述”、“智能体示例”、“智能体工具”、“智能体颜色”、“自主智能体”，或需要关于Claude Code插件的智能体结构、系统提示、触发条件或智能体开发最佳实践的指导时，应使用此技能。 version: 0.1.0

Claude Code插件智能体开发

概述

智能体是自主处理复杂多步骤任务的独立子进程。理解智能体结构、触发条件和系统提示设计，能创建强大的自主功能。

关键概念：

  • 智能体用于自主工作，命令用于用户启动的操作
  • Markdown文件格式，包含YAML前端元数据
  • 通过描述字段触发，包含示例
  • 系统提示定义智能体行为
  • 模型和颜色自定义

智能体文件结构

完整格式

---
name: 智能体标识符
description: 当[触发条件]时使用此智能体。示例：

<example>
上下文：[情境描述]
用户：“[用户请求]”
助手：“[助手应如何响应并使用此智能体]”
<commentary>
[为何触发此智能体]
</commentary>
</example>

<example>
[更多示例...]
</example>

model: inherit
color: blue
tools: ["读取", "写入", "Grep"]
---

您是[智能体角色描述]...

**您的核心职责：**
1. [职责1]
2. [职责2]

**分析过程：**
[分步工作流程]

**输出格式：**
[返回内容]

前端元数据字段

name（必需）

智能体标识符，用于命名空间和调用。

格式： 仅小写字母、数字、连字符 长度： 3-50个字符 模式： 必须以字母数字开头和结尾

好示例：

  • code-reviewer
  • test-generator
  • api-docs-writer
  • security-analyzer

坏示例：

  • helper（太通用）
  • -agent-（以连字符开头/结尾）
  • my_agent（不允许下划线）
  • ag（太短，<3个字符）

description（必需）

定义Claude何时应触发此智能体。这是最关键的字段。

必须包含：

  1. 触发条件（“当…时使用此智能体”）
  2. 多个<example>块显示用法
  3. 每个示例中的上下文、用户请求和助手响应
  4. <commentary>解释为何触发智能体

格式：

当[条件]时使用此智能体。示例：

<example>
上下文：[情境描述]
用户：“[用户所说]”
助手：“[Claude应如何响应]”
<commentary>
[为何此智能体适用]
</commentary>
</example>

[更多示例...]

最佳实践：

  • 包含2-4个具体示例
  • 展示主动和被动触发
  • 覆盖相同意图的不同表达方式
  • 在评论中解释推理
  • 具体说明何时不使用智能体

model（必需）

智能体应使用的模型。

选项：

  • inherit - 使用与父模型相同的模型（推荐）
  • sonnet - Claude Sonnet（平衡）
  • opus - Claude Opus（能力最强，昂贵）
  • haiku - Claude Haiku（快速，廉价）

推荐： 除非智能体需要特定模型能力，否则使用inherit。

color（必需）

UI中的视觉标识符。

选项： blue, cyan, green, yellow, magenta, red

指导原则：

  • 同一插件中不同智能体选择不同颜色
  • 类似类型智能体使用一致颜色
  • 蓝色/青色：分析、审查
  • 绿色：成功导向任务
  • 黄色：警告、验证
  • 红色：关键、安全
  • 品红色：创意、生成

tools（可选）

限制智能体使用特定工具。

格式： 工具名称数组

tools: ["读取", "写入", "Grep", "Bash"]

默认： 如果省略，智能体有权访问所有工具

最佳实践： 限制工具到最小所需（最小权限原则）

常见工具集：

  • 只读分析：["读取", "Grep", "Glob"]
  • 代码生成：["读取", "写入", "Grep"]
  • 测试：["读取", "Bash", "Grep"]
  • 完全访问：省略字段或使用["*"]

系统提示设计

Markdown正文成为智能体的系统提示。以第二人称撰写，直接对智能体说话。

结构

标准模板：

您是[角色]，专门从事[领域]。

**您的核心职责：**
1. [主要职责]
2. [次要职责]
3. [额外职责...]

**分析过程：**
1. [第一步]
2. [第二步]
3. [第三步]
[...]

**质量标准：**
- [标准1]
- [标准2]

**输出格式：**
以此格式提供结果：
- [包含内容]
- [如何结构化]

**边缘情况：**
处理以下情况：
- [边缘情况1]：[如何处理]
- [边缘情况2]：[如何处理]

最佳实践

✅ 应该：

  • 以第二人称撰写（“您是…”、“您将…”）
  • 明确职责
  • 提供分步过程
  • 定义输出格式
  • 包含质量标准
  • 处理边缘情况
  • 保持在10,000字符以下

❌ 不应该：

  • 以第一人称撰写（“我是…”、“我将…”）
  • 模糊或通用
  • 省略过程步骤
  • 未定义输出格式
  • 跳过质量指导
  • 忽略错误情况

创建智能体

方法1：AI辅助生成

使用此提示模式（从Claude Code提取）：

基于此请求创建智能体配置：“[您的描述]”

要求：
1. 提取核心意图和职责
2. 为领域设计专家角色
3. 创建全面系统提示，包括：
   - 清晰行为边界
   - 特定方法学
   - 边缘情况处理
   - 输出格式
4. 创建标识符（小写、连字符、3-50字符）
5. 编写带有触发条件的描述
6. 包含2-3个<example>块显示何时使用

返回JSON：
{
  "identifier": "agent-name",
  "whenToUse": "当...时使用此智能体。示例：<example>...</example>",
  "systemPrompt": "您是..."
}

然后转换为带前端元数据的智能体文件格式。

参见examples/agent-creation-prompt.md获取完整模板。

方法2：手动创建

  1. 选择智能体标识符（3-50字符，小写，连字符）
  2. 编写带示例的描述
  3. 选择模型（通常inherit）
  4. 选择颜色用于视觉标识
  5. 定义工具（如果限制访问）
  6. 按上述结构编写系统提示
  7. 保存为agents/agent-name.md

验证规则

标识符验证

✅ 有效：code-reviewer, test-gen, api-analyzer-v2
❌ 无效：ag（太短），-start（以连字符开头），my_agent（下划线）

规则：

  • 3-50个字符
  • 仅小写字母、数字、连字符
  • 必须以字母数字开头和结尾
  • 无下划线、空格或特殊字符

描述验证

长度： 10-5,000字符 必须包含： 触发条件和示例 最佳： 200-1,000字符，包含2-4个示例

系统提示验证

长度： 20-10,000字符 最佳： 500-3,000字符 结构： 清晰职责、过程、输出格式

智能体组织

插件智能体目录

plugin-name/
└── agents/
    ├── analyzer.md
    ├── reviewer.md
    └── generator.md

agents/中的所有.md文件自动发现。

命名空间

智能体自动命名空间：

  • 单个插件：agent-name
  • 带子目录：plugin:subdir:agent-name

测试智能体

测试触发

创建测试场景验证智能体正确触发：

  1. 编写智能体，带特定触发示例
  2. 使用类似示例中的表达方式测试
  3. 检查Claude加载智能体
  4. 验证智能体提供预期功能

测试系统提示

确保系统提示完整：

  1. 给智能体典型任务
  2. 检查其遵循过程步骤
  3. 验证输出格式正确
  4. 测试提示中提到的边缘情况
  5. 确认满足质量标准

快速参考

最小智能体

---
name: simple-agent
description: 当...时使用此智能体。示例：<example>...</example>
model: inherit
color: blue
---

您是执行[X]的智能体。

过程：
1. [步骤1]
2. [步骤2]

输出：[提供内容]

前端元数据字段摘要

字段 必需 格式 示例
name 是 小写-连字符 code-reviewer
description 是 文本 + 示例 当…时使用 <example>…
model 是 inherit/sonnet/opus/haiku inherit
color 是 颜色名称 blue
tools 否 工具名称数组 [“读取”, “Grep”]

最佳实践

应该：

  • ✅ 包含2-4个具体示例在描述中
  • ✅ 编写具体触发条件
  • ✅ 除非特定需要，否则使用inherit模型
  • ✅ 选择适当工具（最小权限）
  • ✅ 编写清晰、结构化系统提示
  • ✅ 彻底测试智能体触发

不应该：

  • ❌ 使用无示例的通用描述
  • ❌ 省略触发条件
  • ❌ 所有智能体使用相同颜色
  • ❌ 授予不必要工具访问
  • ❌ 编写模糊系统提示
  • ❌ 跳过测试

额外资源

参考文件

详细指导，参考：

  • references/system-prompt-design.md - 完整系统提示模式
  • references/triggering-examples.md - 示例格式和最佳实践
  • references/agent-creation-system-prompt.md - Claude Code中的确切提示

示例文件

工作示例在examples/中：

  • agent-creation-prompt.md - AI辅助智能体生成模板
  • complete-agent-examples.md - 不同用例的完整智能体示例

实用脚本

scripts/中的开发工具：

  • validate-agent.sh - 验证智能体文件结构
  • test-agent-trigger.sh - 测试智能体是否正确触发

实施工作流程

为插件创建智能体：

  1. 定义智能体目的和触发条件
  2. 选择创建方法（AI辅助或手动）
  3. 创建agents/agent-name.md文件
  4. 编写前端元数据，包含所有必需字段
  5. 按最佳实践编写系统提示
  6. 包含2-4个触发示例在描述中
  7. 用scripts/validate-agent.sh验证
  8. 用真实场景测试触发
  9. 在插件README中记录智能体

专注于清晰触发条件和全面系统提示以实现自主操作。