打造自己的技能
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 檔案,表頭:序號、發票號、日期、金額、稅額、價稅合計、銷售方、備註
管理個人技能
| 操作 | 說明 |
|---|---|
| 開啟資料夾 | 在檔案管理器中定位技能的本地檔案 |
| 刪除 | 從列表移除,不可復原,需重新上傳 |
| 啟用/停用 | 停用後不會自動調用,但仍可透過「使用」按鈕手動調用 |
安全提示
- 建立技能前,確認腳本內容不含危險操作(刪除系統檔案、訪問敏感目錄等)
- 技能的訪問範圍由你的本地授權配置決定,技能無法訪問未授權的目錄
- 不要安裝來源不明的第三方技能,安裝前使用「安全性審查」功能審閱腳本內容
- 個人技能僅自己可見,不會進入技能市場