编写技能

编写流程

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 行
• [ ] 无时效性信息
• [ ] 术语保持一致
• [ ] 包含具体示例
• [ ] 参考文件层级不超过一级