Skill 开发

Skill 用 Markdown 描述一套可复用的工作方法。它适合封装专业规则、团队流程和输出标准，不适合承载密钥或必须执行的程序逻辑。

创建 Skill

新建一个目录，并添加 SKILL.md：

my-skill/
  SKILL.md

SKILL.md 以 YAML 元数据开始：

---
name: release-notes
description: 根据本轮变更生成面向用户的发布说明。
---

# Release Notes

当用户要求编写发布说明时使用此 Skill。

## 工作方式

1. 确认目标版本和受众。
2. 只记录用户可观察的变化。
3. 将不兼容变化和迁移步骤单独列出。

name 使用简短、稳定的标识；description 应说明何时使用，而不是只重复名称。

添加资源

需要模板或参考资料时，可以放在 Skill 目录内：

my-skill/
  SKILL.md
  templates/
  references/

在 SKILL.md 中使用相对路径说明何时读取。不要复制大量无关资料，也不要把 API Key、Cookie 或用户数据放入 Skill。

编写建议

• 明确触发条件、输入、步骤和完成标准；
• 说明不能做什么，避免超出领域范围；
• 优先给决策规则，不要绑定脆弱的界面位置；
• 使用标准 Markdown 链接；
• 代码块注明语言；
• 不要求绕过权限、审批或安全限制。

安装与测试

1. 将完整目录放入 ~/.keenkind/<environment>/skills（开发时可放入项目根的 .keenkind/skills 或 .agents/skills）。
2. 打开 设置 > 扩展 > 本地技能。
3. 刷新并启用 Skill。
4. 在输入框键入 $，选择 Skill 后发送一项明确任务。
5. 分别测试正常输入、缺少信息和不应触发的任务。

修改文件后刷新 Skill，再用一个新对话验证，避免旧对话内容影响判断。

何时改用插件

如果能力必须执行本地程序、访问专用 API 或返回结构化工具结果，应开发插件。Skill 可以说明如何使用插件，但不能替代插件执行代码。