技能开发最佳实践

创建有效的代理技能需要仔细考虑结构、清晰度和可复用性。本指南涵盖了从社区和官方指南中收集的最佳实践。

清晰地构建技能结构

结构良好的技能更容易让代理遵循，也更便于人类维护。

使用清晰的章节

用明确的章节组织您的技能：

• 概述 - 技能的功能
• 前提条件 - 使用技能前需要准备什么
• 指令 - 逐步指导
• 示例 - 具体的输入/输出对
• 故障排除 - 常见问题和解决方案

保持指令原子化

将复杂任务分解为简单的顺序步骤：

## 指令

1. 分析输入文档
2. 识别关键章节
3. 提取相关信息
4. 按照模板格式化输出
5. 验证结果

为清晰度而写作

请记住，AI 代理会按字面意思理解您的指令。

具体明确

避免模糊的语言：

• ❌ "适当处理文件"
• ✅ "解析 JSON 文件并提取所有 'status' 字段设置为 'active' 的对象"

定义术语

如果使用特定领域的术语，请定义它：

## 定义

- **Widget**: 显示用户数据的 UI 组件
- **Gadget**: 处理请求的后端服务

包含示例

示例帮助代理理解预期行为。

展示输入和输出

## 示例

### 输入
用户："创建这份会议记录的摘要"
[记录内容]

### 预期输出
## 会议摘要

**日期**：2025年1月10日
**参与者**：Alice、Bob、Carol

### 要点
1. 讨论第一季度目标
2. 预算审核已通过
3. 下次会议安排在1月17日

处理边界情况

考虑可能出错的情况并提供指导：

## 边界情况

- 如果输入为空，回复"没有内容可处理"
- 如果格式无法识别，请求澄清
- 如果存在多种解释，列出它们并请用户选择

全面测试

在分享技能之前：

1. 使用各种输入进行测试
2. 测试边界情况
3. 让其他人在没有解释的情况下尝试
4. 根据反馈进行迭代

记录依赖项

列出所需的任何工具、API 或其他技能：

## 依赖项

- 文件系统访问权限
- Python 3.9+
- 用于 PDF 输入的 `pdf-parser` 技能

版本管理您的技能

跟踪变更：

## 更新日志

### v1.1.0 (2025-01-10)
- 添加 PDF 输入支持
- 改进错误处理

### v1.0.0 (2025-01-01)
- 初始版本

分享与协作

当我们分享时，社区会变得更强大：

1. 向 Awesome Skills 目录 贡献
2. 在 GitHub 上开源您的技能
3. 记录您的学习历程
4. 帮助他人解决问题

资源

• 官方技能快速入门
• Claude 技能最佳实践
• 技能手册

祝您开发愉快！