Skills 开发

技能结构、规范、激活机制、最佳实践。

Skill 结构

一个标准的 Skill 目录结构：

skill-name/
├── SKILL.md           # 技能主文件（必需）
├── README.md          # 说明文档
├── INSTALL.md         # 安装指南
├── CHEATSHEET.md      # 速查表
├── references/        # 参考文档
│   ├── doc1.md
│   └── doc2.md
└── scripts/           # 辅助脚本
    ├── setup.sh
    └── helper.py

SKILL.md 规范

# Skill 名称

简短描述（一句话）

## 触发条件

描述何时激活此技能

## 核心功能

1. 功能一
2. 功能二
3. 功能三

## 使用指南

步骤说明...

## 注意事项

⚠️ 重要提醒...

技能激活机制

Agent 通过以下方式激活技能：

1. 显式调用 - 用户直接提到技能名称
2. 关键词匹配 - 消息包含技能关键词
3. 上下文推断 - Agent 根据对话上下文判断

开发最佳实践

✅ DO

• 保持 SKILL.md 简洁明了
• 使用清晰的章节标题
• 提供具体示例
• 包含错误处理说明

❌ DON'T

• 不要在 SKILL.md 中包含大量代码
• 不要使用模糊的描述
• 不要假设用户有背景知识

---

← 上一节：Agent 深入 | 下一节：工具系统 →