编写技能

编写流程

1. 收集需求 - 向用户询问：

- 该技能涵盖的任务或领域是什么？

- 需要处理哪些具体使用场景？

- 是否需要可执行脚本，还是仅需操作说明？

- 是否有参考材料需要包含？

1. 草拟技能 - 创建：

- SKILL.md 文件，包含简洁明了的操作说明

- 若内容超过 500 行，可添加额外的参考文件

- 若需确定性操作，可提供辅助脚本

1. 与用户评审 - 提交草稿并询问：

- 是否覆盖了您的使用场景？

- 是否有遗漏或不清楚的地方？

- 某些部分是否需要更详细或更简略？

技能结构

skill-name/
├── SKILL.md           # 主要说明文件（必需）
├── REFERENCE.md       # 详细文档（如需）
├── EXAMPLES.md        # 使用示例（如需）
└── scripts/           # 辅助脚本（如需）
    └── helper.js

SKILL.md 模板

---
name: skill-name
description: 对功能的简要描述。在 [特定触发条件] 时使用。
---

# 技能名称

## 快速上手

[最简可行示例]

## 操作流程

[复杂任务的分步说明，附检查清单]

## 高级功能

[链接到独立文件：参见 [REFERENCE.md](REFERENCE.md)]

描述要求

描述是代理在决定加载哪个技能时唯一能看到的内容。它会与所有已安装技能的描述一同出现在系统提示中。代理通过阅读这些描述来判断是否应选择该技能。

目标：向代理提供足够的信息以明确：

1. 该技能具备什么能力
2. 在何时/为何触发它（具体关键词、上下文、文件类型）

格式要求：

• 最多 1024 个字符
• 使用第三人称书写
• 第一句：说明其功能
• 第二句：以“Use when [specific triggers]”形式表达触发条件

良好示例：

从 PDF 文件中提取文本和表格，填充表单，合并文档。当处理 PDF 文件或用户提及 PDF、表单或文档提取时使用。

不良示例：

帮助处理文档。

该示例无法让代理区分此技能与其他文档类技能。

何时添加脚本

在以下情况添加实用脚本：

• 操作具有确定性（如验证、格式化）
• 相同代码会被反复生成
• 需要对错误进行显式处理

脚本能节省 token 并提升可靠性，优于由模型生成的代码。

何时拆分文件

在以下情况将内容拆分为独立文件：

• SKILL.md 超过 100 行
• 内容涉及不同领域（如财务与销售模式）
• 高级功能很少被使用

评审检查清单

草稿完成后，请确认：

• [ ] 描述中包含触发条件（“Use when...”）
• [ ] SKILL.md 少于 100 行
• [ ] 不包含时效性信息
• [ ] 术语保持一致
• [ ] 包含具体示例
• [ ] 参考文件层级不超过一级