第二十二章：技能除錯與維護 — 失敗常見原因、patch 熱修補、向下相容

常言道：「寫 Code 一小時，DeBug 一整天。」寫技能也是一樣的道理。當你的魔法不靈光，管家開始在原地打轉甚至胡言亂語時，身為魔法師的你可不能只會重開機！

在技能系統的最終章，我們要教你如何成為一位技能急診室醫生。學會看懂錯誤訊息、快速打上補丁（Patch），並確保你的魔法在升級後不會害死那些還在用舊版本的無辜路人。

🚑 技能失敗的「三大死因」

當技能罷工時，通常逃不出這三個原因：

「幫我弄點吃的。」這句話對人來說很簡單，但對管家來說可能是個災難。它可能會幫你訂披薩，也可能會教你怎麼種小麥。如果技能結果跟你想的不一樣，90% 的原因是你的 SKILL.md 提示詞寫得不夠具體。

你叫管家去查網頁，卻沒有在技能設定裡開啟 web 工具。這就像是叫士兵去打仗卻不發給他步槍一樣！管家會委屈地回報：“Tool not found” (找不到工具)。

這很現實。如果你的模型 API 額度用完了，管家就會瞬間變成植物人。這時候請乖乖去加值吧！

當你發現技能有一個小 Bug，難道要重新發佈一個全新版本嗎？不用！Hermes 提供了 patch 功能，讓你可以快速為技能打上補丁。

但請注意向下相容 (Backward Compatibility)！如果你只是修復了錯字，你可以盡情 Patch。但如果你把技能的「輸入變數」從 name 改成了 full_name，那些還在使用舊指令（只傳入 name）的使用者就會全面崩潰。記住，己所不欲，勿施於人！

遇到問題不要慌！讓我們來練習幾個實用的除錯與修補指令。

介紹指令：使用 --debug 抓蟲，以及 hermes skill patch 打補丁

練習 1：叫出急診室紀錄 (--debug) 當技能失敗時，第一步永遠是查看底層日誌：

hermes run --skill broken-skill --debug

幽默小提示：仔細看那些密密麻麻的文字。如果看到 RateLimitError，代表你呼叫太快或是沒錢了；如果看到 prompt is missing required variables，代表你忘記給變數啦！

練習 2：為技能打上熱修補 (patch) 假設你剛修好了一個小 Bug，不想改大版本號，可以這樣做：

hermes skill patch my-skill "修復了遇到空白字元會當機的問題"

管家會自動幫你把版號從 1.0.0 升級到 1.0.1，並加上你寫的修補日誌。就像是給魔法書貼上了一張小小的 OK 繃！

練習 3：切換到舊版本測試相容性 身為一個負責任的開發者，你應該要確保舊版本還能用。試著降級執行：

hermes run --skill my-skill@1.0.0

這招超級實用！如果你發現新版本把一切都搞砸了，至少你還能隨時退回到那個曾經美好的舊版本避難。

🎉 第三部份：技能系統，全劇終！

太感動了！你從一個只會叫管家聊天的麻瓜，一路成長為能夠自己寫 SKILL.md、發佈、維護技能的首席魔法師！這絕對是 Hermes Agent 最核心、也最精華的部分。

不過，光有強大的單一技能還不夠。在真實的工作中，我們往往需要把多個任務串聯起來，甚至讓管家按照排程自己工作。準備好進入「全自動化」的世界了嗎？下一章【第四部份：工作流與自動化】的首部曲《計畫模式》即將展開！我們第二十三章見！⚙️