14. Skills（Skill Library）
Skill 是可重用的方法論與專業知識（expertise）套件：告訴 Agent「這類工作該怎麼想、怎麼檢查、怎麼交付」。它不是工具授權，也不會擴大 Agent 可呼叫的工具面或繞過產品治理。
Lantide 採通用 Agent Skills 套件格式（含標準 SKILL.md）。內建 Agent 與透過 MCP 連入的外部 Agent，可共用同一份 skill definition；真正能做什麼仍由 Agent 狀態、工具啟用、MCP access mode、Approve 與 audit 決定。
14.1 Skill 是什麼、不是什麼
| 是 | 不是 |
|---|---|
| 分析／交付方法論、檢查清單、品質規則與參考資源 | 額外的 API 金鑰、資料庫連線或系統權限 |
| 按需載入的指導文字（progressive disclosure） | 可自行取得新工具或繞過 Plan／Approve |
| 可與內建 Agent、外部 Agent 共用的 definition | 公開 marketplace 或遠端 skill 商店 |
常見誤解：匯入 skill ≠ 授權 Agent 做更多事。Skill 只改變「怎麼做」的指引；「能不能做」仍由現有治理層把關。
14.2 開啟 Skill Library
- 在主畫面右上角點擊 Skill Library 圖示。
- 對話框列出你已匯入的個人（User） skills。
- 可對每個 skill 切換：
- Enabled：是否可供內建對話載入
- Share with external agents：是否允許經 MCP 連入的外部 Agent 讀取同一份 definition
- 其他操作：Import Skill…、Open Skills Folder、Validate again、移除（只刪 Lantide 管理的副本，不改你匯入來源資料夾）。
內建 skills 不出現在此列表。 產品內建的 Plan／統計／HTML、以及
lantide:load-external-ref（本機文件 → Reference） 等方法論由 App 管理，並在對應流程（例如 Create reference from…）中載入；Skill Library 只管理你匯入的個人套件。目前尚不支援 skill 內的可執行腳本（scripts）；若套件含不支援內容，畫面上會標示 Scripts unsupported。
14.3 匯入 skill
- 準備一個符合通用規格的資料夾，內含標準
SKILL.md。 - 在 Skill Library 按 Import Skill…，選取該資料夾。
- 匯入成功後，即可在對話中以
/技能名使用（見 §14.4）。
若同名 managed skill 已存在，匯入會失敗並提示 collision；請先移除或改名後再試。可用 Validate again 重新檢查套件是否仍有效。
14.3.1 由 Agent 把需求整理成 skill
在 Agent mode 可直接說「把這套流程整理成一個 skill」。Agent 會先訪談適用情境、必要輸入、步驟、判斷點、輸出與驗收方式，再開啟唯讀 preview；preview 不會直接建立 skill。請檢查：
- 名稱與 description 是否足夠精準，且清楚說明何時觸發、何時不觸發；
SKILL.md與文字 references 是否只保存可重複程序，而非一次性結果、秘密或大量原始資料；- external sharing 是否符合預期（預設關閉）；
- placement 建議是否合理。跨 Workspace 的短偏好通常放 User Knowledge；專案短規則放 Project Knowledge；專案大型權威正文放 Project Reference；可重複程序才放 User Skill。混合需求可拆開保存，Skill 只描述何時查閱專案知識／Reference。
placement 是 best-practice 建議，不是硬性阻擋；若你理解 project coupling、內容重複或日後過期的風險，仍可要求建立 Skill。明確 secret、非法路徑、scripts／binary、超出大小或同名 collision 則會拒絕。
選擇 Create 後，後端只會建立你剛審閱且 digest 未改變的 preview；建立完成會立即刷新 Skill Library 與 slash picker，但新 skill 從下一輪 Agent run起使用。若要修改，先選 Revise 產生新 preview。建立後可在 Skill Library 關閉、重新驗證或移除。
模式限制： Ask mode 可產生 preview，但不可建立；Plan 正在執行時不進行個人 skill authoring，請先完成或停止當前執行。首版只支援
SKILL.md與references/*.md|txt，不產生或執行 scripts。
14.4 在對話中以 / 顯式載入
在右側 AI 對話輸入框輸入 /，會開啟 slash picker，列出目前 Enabled 且可供 slash 使用的 skills：
- 繼續輸入名稱片段可過濾列表。
- 用滑鼠點選，或鍵盤上下鍵移動後 Enter 確認。
- 送出訊息時，選中的 skill 會隨該輪對話載入給內建 Agent。
這是顯式載入：你決定何時套用哪份方法論，而不是把所有 skill 長駐在 system prompt。
14.5 與內建 Agent、外部 Agent 的共用關係
| 消費者 | 如何使用 skill |
|---|---|
| 內建 Agent | Skill Library 中 Enabled 的 skill；對話以 / 顯式載入。內建 skill（如 lantide:load-external-ref）由系統在匯入等流程載入 |
| 外部 Agent（MCP） | 個人 skill：同一份 managed definition，須開啟 Share with external agents。內建 skill（含外部文件 → Reference）與內建共用同一 definition／同一 save 契約；連線仍受 §13 的 access mode／scope 約束 |
重點：共用的是 definition（怎麼做），不是把外部 Agent 的權限抬高。Observe／Execute／Admin、Approve & Execute、Activity 與 audit 規則不變。
14.6 邊界與限制
- 不能繞過治理：skill 指令無法繞過 MCP access mode、Plan 審批（Approve & Execute）、audit 或 artifact 契約。
- 不做 marketplace：沒有公開商店、評分、付費或遠端 registry；匯入來自你本機選取的套件。
- 不保證第三方 skill 免改可跑：他人或他工具的 skill 可能需調整 front matter、路徑或內容後才能通過驗證並在 Lantide 使用。
- Scripts 尚未支援：含可執行腳本的套件不會因此取得執行能力；請以方法論文檔與資源為主。
- 移除只影響 managed 副本：原始匯入來源資料夾不會被刪改。
相關章節：§12 AI 助手、§13 外部 AI Agent 與 MCP Server。