第十五章:技能系統架構 — SKILL.md 結構、前置中繼資料、分類、版本
歡迎來到【第三部份:技能系統】!各位初級指揮官,你們已經通過了基礎訓練。現在,我們要帶領大家進入高階玩家的魔法學院,學習如何為 Hermes Agent 打造專屬的「技能 (Skills)」。🧙♂️
如果說前兩部分是教你怎麼使用管家「內建」的功能,那技能系統就是讓你教管家「原本不會的新招式」。不管是自動發文到 Twitter、每天早上幫你整理股市報表,還是自動審查程式碼,一切的起點,都在於一個神聖的檔案:SKILL.md。
📜 魔法書的真面目:SKILL.md
在 Hermes 的世界裡,每一個技能都是一本小小的魔法書,而這本書的封面和目錄,就是 SKILL.md。它告訴管家:這個技能叫什麼名字?有什麼用?以及要怎麼執行?
一個標準的 SKILL.md 包含兩個最重要的部分:前置中繼資料 (Frontmatter) 與 Markdown 內文。
1. 前置中繼資料 (Frontmatter):技能的身分證
這段寫在檔案最開頭,被 --- 包圍的 YAML 格式區塊,是給系統看的。它定義了這個技能的 DNA: * Name (名稱):必須是獨一無二的,像是 twitter-auto-post。 * Description (描述):簡單說明這個技能在幹嘛。 * Version (版本):像 1.0.0,讓你知道這個魔法有沒有過期。 * Category (分類):把技能分門別類,比如 social 或 finance,方便日後在茫茫技能海中尋找。
2. Markdown 內文:魔法咒語的本體
在 --- 之後,就是你寫給管家(Agent)看的提示詞(Prompt)與執行步驟。你可以在這裡詳細說明這個技能的運作邏輯,就像是在寫 SOP 手冊一樣。
🛠️ 指令教學:偷看別人的魔法書
在我們自己動手寫之前,先來看看別人是怎麼寫的吧!我們會用到檢視技能的基礎指令。
介紹指令:使用 hermes skill 相關指令
💡 應用練習例子
練習 1:列出所有已安裝的技能分類 想看看你目前擁有哪些類別的技能,請輸入:
hermes skill list --categories幽默小提示:如果你看到一堆你從沒見過的分類,別緊張,那可能是系統內建送你的見面禮。
練習 2:偷窺特定技能的身分證 假設你有一個叫做 plan 的內建技能(如果沒有,換成任意一個清單上的技能名稱),我們來看看它的 SKILL.md 簡介:
hermes skill view plan這會把這個技能的詳細資訊(包括版本、描述)印在終端機上。這就像是拿著放大鏡在看魔法書的目錄。
練習 3:把魔法書整個攤開來 如果你想連同裡面的提示詞(Prompt)一起看個精光,請加上 --raw 參數:
hermes skill view plan --raw哇嗚!現在這個技能的原始碼完全暴露在你面前了。多看幾個優秀的 SKILL.md,絕對能讓你的魔法功力大增!
🎉 恭喜踏入技能系統的大門!
現在你已經知道 SKILL.md 是什麼,以及它的重要性了。這就像是你拿到了魔法學院的入學通知書!
不過,Hermes 本身其實就已經偷偷自帶了一堆超級好用的內建技能了。在我們自己「造輪子」之前,下一章我們將帶你進行一場《內建技能速覽》,看看有哪些現成的魔法可以直接借來用!我們第十六章見!✨