创建技能

通过专业知识、工作流程和工具集成来扩展智能体能力的有效技能创建指南。

关于技能

技能是模块化的、自包含的包，通过提供专业知识、工作流程和工具来扩展智能体能力。可以将它们视为特定领域或任务的“入门指南”。

技能提供的内容

专业工作流程 - 特定领域的多步骤程序
工具集成 - 处理特定文件格式或API的说明
领域专业知识 - 公司特定知识、模式、业务逻辑
捆绑资源 - 用于复杂和重复性任务的脚本、参考资料和资产

渐进式披露原则

200行规则至关重要。 SKILL.md必须少于200行。如果需要更多内容，请将内容拆分到 references/ 文件中。

三级加载系统

元数据（名称 + 描述） - 始终在上下文中（约100词）
SKILL.md 正文 - 当技能触发时（<200行，为获得最佳性能，理想情况下<500行）
捆绑资源 - 按智能体需要加载（无限制）

为什么渐进式披露很重要

初始上下文负载减少85%
激活时间从500ms以上降至100ms以下
智能体仅在需要时加载所需内容
技能保持可维护性和专注性

技能结构

skill-name/
├── SKILL.md（必需，<200行）
│   ├── YAML 前置元数据（必需）
│   │   ├── name:（必需）
│   │   └── description:（必需）
│   └── Markdown 指令（必需）
└── 捆绑资源（可选）
    ├── scripts/          - 可执行代码
    ├── references/       - 按需加载的文档
    └── assets/           - 输出中使用的文件

核心原则

简洁是关键

上下文窗口是共享资源。你的技能与智能体需要的其他所有内容共享它。要简洁，并质疑每条信息：

智能体真的需要这个解释吗？
我能假设智能体知道这个吗？
这段文字值得它的token成本吗？

设置适当的自由度

高自由度：针对多种有效方法的文本指令
中等自由度：带有参数的伪代码或脚本
低自由度：针对脆弱操作的特定脚本，参数很少或没有参数

使用所有模型进行测试

技能作为模型的补充，因此有效性取决于底层模型。使用你计划使用的所有模型测试你的技能。

参考资料

有关详细指导，请参阅：

references/progressive-disclosure.md - 200行规则和参考资料模式
references/skill-structure.md - SKILL.md格式和前置元数据详情
references/examples.md - 优秀技能示例
references/best-practices.md - 全面的最佳实践指南

create-skill

相关 Skills