create-skill

创建技能

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

关于技能

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

技能提供的内容

1. 专业工作流——针对特定领域的多步骤流程
2. 工具集成——使用特定文件格式或 API 的说明
3. 领域专业知识——公司专属知识、架构和业务逻辑
4. 捆绑资源——用于复杂且重复任务的脚本、参考资料和资源

渐进式披露原则

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

三级加载系统

1. 元数据（名称 + 描述）——始终在上下文中（约 100 个词）
2. SKILL.md 正文——技能触发时加载（少于 200 行；为获得最佳性能，最好少于 500 行）
3. 捆绑资源——Agent 按需加载（不限量）

渐进式披露的重要性

• 初始上下文加载量减少 85%
• 激活时间从 500ms 以上降至 100ms 以下
• Agent 只加载所需内容，在需要时加载
• 技能保持易于维护且重点明确

技能结构

skill-name/
├── SKILL.md (required, <200 lines)
│   ├── YAML frontmatter metadata (required)
│   │   ├── name: (required)
│   │   └── description: (required)
│   └── Markdown instructions (required)
└── Bundled Resources (optional)
    ├── scripts/          - Executable code
    ├── references/       - Documentation loaded as needed
    └── assets/           - Files used in output

核心原则

简洁是关键

上下文窗口是共享资源。你的技能要与 Agent 所需的其他内容共享上下文。请保持简洁，并仔细斟酌每条信息：

• Agent 真的需要这个说明吗？
• 我能否假设 Agent 已经知道这些？
• 这一段内容是否值得占用相应的词元？

设置合适的自由度

• 高自由度：适用于存在多种有效方法的文本说明
• 中自由度：带参数的伪代码或脚本
• 低自由度：用于脆弱操作、参数很少或没有参数的专用脚本

使用所有模型进行测试

技能是对模型的补充，因此其有效性取决于底层模型。请使用计划搭配技能的所有模型进行测试。

参考资料

如需详细指南，请参阅：

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