Kapinote logo文档
AI 功能

自定义技能(Skills)

通过标准 SKILL.md 规范扩展 AI 助手的复合指令集与专属业务处理能力。

技能(Skills)是一个包含 SKILL.md 规范文件的独立目录。

  • 模板(Templates): 适用于由用户在菜单中主动选取的固定格式输出;
  • 技能(Skills): 遵循 Agent 技能标准,包含清晰的触发条件描述(Trigger Description),使 AI 助手在识别到匹配的用户意图时自动动态加载并遵循。

1. 打开技能目录

进入 Kapinote 的 设置 → 技能,点击 打开文件夹。在打开的系统目录中,为每个技能新建一个专属子文件夹(建议子文件夹名与技能名一致):

skills/
└── customer-follow-up/
    └── SKILL.md

2. 编写 SKILL.md 规范文件

文件开头必须包含标准的 YAML Frontmatter,声明单行的 name(技能名称)与 description(意图触发描述),正文部分为详细的 Markdown 指令:

---
name: customer-follow-up
description: Use when the user asks for a follow-up email after a customer or sales meeting.
---

# 客户跟进邮件生成指南

请严格遵循以下工作规范:
1. 仅以当前选中的会议转录为事实依据。
2. 提炼核心决议、明确责任人与交付节点的待办清单。
3. 严禁臆造或推测未提及的商业承诺。
4. 语言风格保持专业、克制、简洁。

设计建议: name 推荐使用小写英文字母与连字符(如 code-review-summary);description 应清晰描述该技能的“激活场景与条件”,以便 AI 语义路由能够精准匹配。

3. 重新扫描与加载

在文件夹中完成编辑后,返回 Kapinote 的 设置 → 技能 页面,点击 刷新 按钮。解析成功的技能将展示其名称与描述。

若技能未正常显示,请检查以下常见问题:

  • 文件名必须严格为大写 SKILL.md
  • 开头与结尾的 YAML 分隔符 --- 完整闭合
  • namedescription 均为单行文本
  • 该文件位于 skills/ 下的独立子文件夹中

4. 技能(Skills)与模板(Templates)的核心差异

维度模板(Templates)技能(Skills)
触发机制用户手动在 UI 下拉框选取或输入 / 命令助手根据用户提问语义自动匹配并动态加载
存放方式应用内界面管理,存储于本地 SQLite文件系统中的 SKILL.md 目录规范
适用场景固定的格式化报表、邮件草稿复杂的领域特定业务逻辑、多步推导规则与 Agent 工具集成

提示: 请勿将特定会议的具体事实写入技能文件中;会议数据应始终来自于当前选中的上下文。