打造自己的技能
LanMate 内置了 24 个技能,技能商店有 146 个,但总有些需求是现成技能覆盖不了的——比如你们单位特有的审批流程、特定的数据格式处理、或者一套固定的工作模板。这时候,你可以创建自己的技能。
什么时候该创建技能
先问自己三个问题:
- 这个任务是不是反复出现?(如果只做一次,直接对话就行,不用做技能)
- 现有技能能不能搞定?(先看看内置技能和技能商店有没有覆盖)
- 任务有没有明确的步骤和规则?(如果每次做法都不一样,技能也帮不上忙)
适合做成技能的任务特征:
- 有固定流程:每次执行步骤基本一致
- 有明确规则:输入和输出有标准格式
- 反复出现:至少每周都会用到
技能是什么
每个技能本质上是一份说明文件(SKILL.md)加配套的脚本资源。说明文件定义了技能的名称、描述和调用规则,LanMate 据此判断在什么场景下调用它。技能可以调用本地文件、蓝信接口或外部服务。
技能文件支持两种格式:
- .md 文件:纯说明文件,定义调用规则和方法论,不含脚本
- .zip 压缩包:包含 SKILL.md 和配套脚本(Python)、参考资料等
创建技能的步骤
1. 明确技能要做什么
先想清楚:
- 触发场景:用户说什么话时应该调用这个技能
- 输入:技能需要什么输入(文件、文本、参数)
- 输出:技能产出什么(文件、文本、数据)
- 步骤:执行流程是什么
2. 编写 SKILL.md
SKILL.md 是技能的核心。基本结构:
---
name: my-custom-skill
description: 一句话描述技能做什么,触发条件是什么
---
# 技能名称
## 这个技能做什么
(简要说明技能的能力和适用场景)
## 调用规则
(什么情况下调用,什么情况下不调用)
## 执行步骤
1. 第一步做什么
2. 第二步做什么
...
## 输出格式
(指定输出的文件格式、结构等)
3. 上传到 LanMate
- 打开 LanMate,点击左上角的「技能」
- 点击「个人技能」→「安装技能」
- 选择你编写好的 .md 或 .zip 文件上传
- 系统自动完成文件校验、内容解析和安全审查
- 通过后技能出现在列表中,默认启用
上传时系统会检查:文件格式(仅 .md 和 .zip)、唯一性(名称不能重复)、安全审查(脚本内容无可疑行为)。
4. 测试和迭代
安装后,在对话中用「使用 /技能名」指令测试。如果不满意,修改 SKILL.md 后重新上传覆盖。
技能示例:周报模板
假设你们单位周报有固定格式,每次都要手动排版。可以做一个技能:
---
name: weekly-report-template
description: 按单位周报模板生成 Word 文档,触发词:写周报、生成周报、本周工作总结
---
# 周报模板技能
## 调用规则
当用户要求写周报、生成周报时调用此技能。
## 执行步骤
1. 询问用户本周完成的主要工作(如已在对话中提供则跳过)
2. 按以下结构生成周报:
- 一、本周完成的主要工作(每项含工作内容、关键结果)
- 二、进行中的工作及进展百分比
- 三、下周工作计划(按优先级排列)
- 四、需要协调的问题和风险
3. 每项工作用一句话概括,附关键结果或数据
4. 输出 Word 文档,文件名格式:周报_YYYYMMDD.docx
## 输出格式
Word 文档,标题用黑体三号,正文用仿宋四号,段落间距 1.5 倍。
技能示例:发票整理
需要定期整理报销发票图片,识别金额并汇总到 Excel:
---
name: invoice-organizer
description: 批量识别发票图片中的金额、日期、发票号,汇总到 Excel 表格。触发词:整理发票、发票汇总、报销
---
# 发票整理技能
## 调用规则
当用户要求整理发票、汇总发票信息时调用此技能。
## 执行步骤
1. 读取指定目录中的所有发票图片(jpg/png)
2. 对每张图片执行 OCR 识别
3. 提取:发票号码、开票日期、金额、税额、价税合计、销售方名称
4. 汇总到 Excel 表格,按日期排序
5. 在表格末尾生成合计行
6. 无法识别的字段标注"待核对"
## 输出格式
Excel 文件,表头:序号、发票号、日期、金额、税额、价税合计、销售方、备注
管理个人技能
| 操作 | 说明 |
|---|---|
| 打开文件夹 | 在文件管理器中定位技能的本地文件 |
| 删除 | 从列表移除,不可恢复,需重新上传 |
| 启用/禁用 | 禁用后不会自动调用,但仍可通过「使用」按钮手动调用 |
安全提示
- 创建技能前,确认脚本内容不含危险操作(删除系统文件、访问敏感目录等)
- 技能的访问范围由你的本地授权配置决定,技能无法访问未授权的目录
- 不要安装来源不明的第三方技能,安装前使用「安全性审查」功能审阅脚本内容
- 个人技能仅自己可见,不会进入技能市场