AI 功能
自定义技能(Skills)
通过标准 SKILL.md 规范扩展 AI 助手的复合指令集与专属业务处理能力。
技能(Skills)是一个包含 SKILL.md 规范文件的独立目录。
- 模板(Templates): 适用于由用户在菜单中主动选取的固定格式输出;
- 技能(Skills): 遵循 Agent 技能标准,包含清晰的触发条件描述(Trigger Description),使 AI 助手在识别到匹配的用户意图时自动动态加载并遵循。
1. 打开技能目录
进入 Kapinote 的 设置 → 技能,点击 打开文件夹。在打开的系统目录中,为每个技能新建一个专属子文件夹(建议子文件夹名与技能名一致):
skills/
└── customer-follow-up/
└── SKILL.md2. 编写 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 分隔符
---完整闭合 name与description均为单行文本- 该文件位于
skills/下的独立子文件夹中
4. 技能(Skills)与模板(Templates)的核心差异
| 维度 | 模板(Templates) | 技能(Skills) |
|---|---|---|
| 触发机制 | 用户手动在 UI 下拉框选取或输入 / 命令 | 助手根据用户提问语义自动匹配并动态加载 |
| 存放方式 | 应用内界面管理,存储于本地 SQLite | 文件系统中的 SKILL.md 目录规范 |
| 适用场景 | 固定的格式化报表、邮件草稿 | 复杂的领域特定业务逻辑、多步推导规则与 Agent 工具集成 |
提示: 请勿将特定会议的具体事实写入技能文件中;会议数据应始终来自于当前选中的上下文。