第十八章：撰寫第一支技能 — 從需求到 SKILL.md、範本、腳本、參考檔
千呼萬喚始出來！經歷了前面這麼多章節的鋪陳，各位終於要從「使用者」晉升為「創造者」了。準備好你的鍵盤，今天我們要親手寫出你的第一支 Hermes 專屬技能！✍️
這就像是教管家學做一道新菜。你不能只跟它說「做個漢堡」，你得給它食譜（提示詞）、告訴它需要什麼工具、甚至附上幾張參考照片。現在，讓我們一步步完成這份「究極漢堡食譜」吧！
🍔 從需求出發：你想解決什麼問題？
在動手寫程式之前，先想想：你想讓管家幫你做什麼？ 假設我們現在的需求是：「幫我整理一份包含一句名言和三條科技頭條的晨間簡報。」
太棒了，這就是我們第一支技能的靈魂！我們就叫它 morning-briefing 吧。
🧩 技能的拼圖：不只是 SKILL.md
雖然我們一直說 SKILL.md 是核心，但一個真正強大的技能，往往是由幾個不同的檔案組合而成的：
主戰場：
SKILL.md這就是那本魔法書的本體。你必須在這裡寫下「身分證（YAML）」和「具體步驟（Markdown）」。告訴管家先去搜尋新聞，然後再去找名言。範本檔 (Templates, 例如
.prompt檔) 如果你的提示詞太長，寫在SKILL.md裡會很亂。你可以把複雜的提示詞抽出來放在獨立的檔案裡，管家在執行時會自動去讀取它。輔助腳本 (Scripts, 例如
.py或.sh) 有時候，純粹靠大語言模型可能算數學算不準，或是爬網頁爬不到。這時候你可以寫一個小小的 Python 腳本當作輔助工具，讓管家在執行技能時去呼叫它。參考檔 (References) 如果你希望管家寫出來的簡報符合某種特定格式，你可以附上一份
example_briefing.md讓它當作範本參考。這招叫做「Few-Shot Prompting」，非常管用！
🛠️ 指令教學：動手打造你的第一支技能
我們來模擬一次建立與執行 morning-briefing 技能的過程吧！
介紹指令：從 create 到實際執行技能
💡 應用練習例子
練習 1：打好地基 (建立技能資料夾) 首先，我們用上一章學過的指令，先建立一個空白的技能模板：
hermes skill create morning-briefing幽默小提示：現在你的技能資料夾裡有一個空蕩蕩的 SKILL.md。這就像是買了塊畫布，準備好揮灑你的才華了嗎？
練習 2：寫入靈魂 (編輯 SKILL.md) 這一步需要你手動操作。請打開剛才建立的 SKILL.md（或是直接建立一個），並試著在裡面寫下這些內容：
---
name: morning-briefing
description: 產生一句名言與三則科技頭條
version: 1.0.0
category: productivity
---
# 執行步驟
1. 請使用 web_search 工具搜尋「今日每日名言」。
2. 請使用 web_search 工具搜尋「今日科技新聞頭條」，並挑選最重要的 3 則。
3. 把名言和新聞整理成一份 Markdown 格式的簡報輸出。這就是你教管家做菜的食譜！把它存檔，你的魔法書就完成了 90%。
練習 3：驗收成果 (執行你的新技能) 現在，深呼吸，讓我們來驗收你的偉大發明：
hermes run --skill morning-briefing看著終端機裡，管家依照你寫的步驟去搜尋、整理、然後吐出完美的晨間簡報… 這絕對是你今天最有成就感的一刻！恭喜你，魔法師！🎉
太神啦！你成功創造了你的第一支技能！雖然這只是一個簡單的範例，但它已經具備了無限的擴充潛力。
不過，就像寫程式會有 Bug 一樣，寫技能有時候也會遇到管家「會錯意」的情況。下一章《技能最佳實務》，我們將傳授你資深魔法師不外傳的秘訣：如何寫出不會出包的完美技能！我們第十九章見！🧙♂️