第二十章:技能發佈與分享 — 本地 registry、GitHub 發佈、版本升級策略
「富貴不還鄉,如錦衣夜行!」當你寫出了一個超神的技能(比如自動幫你搶演唱會門票),如果只藏在自己的電腦裡,那未免也太孤單了。
在開源與分享的時代,把你的魔法書印成冊、發放給全世界的玩家,才是身為一位高階魔法師最大的榮耀!今天,我們要教你如何將辛苦寫好的技能打包、發佈,甚至管理它的版本更新。準備好接受大家的掌聲了嗎?👏
📦 發佈技能的三種境界
分享技能其實不難,取決於你想分享給誰:
1. 本地孤芳自賞 (Local Registry)
如果你只是想在自己的不同電腦間同步技能,或者是想分享給同一個辦公室的同事。你可以建立一個「本地技能庫 (Local Registry)」。這就像是在公司內網架設了一個小小的圖書館,大家只要設定好路徑,就能互相借閱魔法書。
2. 走向全世界 (GitHub 發佈)
這是最主流的做法!把你的技能資料夾推上 GitHub,它就成了一個開源專案。任何人只要有你的 GitHub 網址,就能透過 Hermes 指令一鍵下載並安裝你的技能。這就像是把你的書放到了全球最大的線上書店!
3. 官方認證 (提交 PR 到官方庫)
如果你的技能真的寫得太棒了、太實用了(例如前面提到的 plan 或 github-pr-workflow),你可以向 Hermes 官方提交 Pull Request (PR)。一旦被接受,你的技能就會成為系統內建的標準魔法!這絕對是光宗耀祖的里程碑。
🏷️ 版本升級策略:魔法也是會過期的
當你的技能越來越多人用,你可能會發現 Bug,或是想加入新功能。這時候,SKILL.md 裡面的 version 欄位就派上用場了!
請務必遵守「語義化版本 (Semantic Versioning)」的潛規則,也就是大名鼎鼎的 v1.0.0: * 大版本 (第一個數字):做了會讓舊使用者崩潰的重大改變時增加。 * 小版本 (第二個數字):加入了超酷的新功能,但不影響舊功能時增加。 * 修補版 (第三個數字):偷偷修掉一個 Bug 時增加。
🛠️ 指令教學:把你的魔法推向世界
讓我們來練習一下與分享、發佈相關的指令操作!
介紹指令:hermes skill 的發佈與更新相關指令
💡 應用練習例子
練習 1:打包你的技能 在發佈之前,你可以先用打包指令確認技能資料夾沒有問題:
hermes skill pack my-first-skill幽默小提示:這會把你的技能壓縮成一個漂亮的包裹。如果系統報錯,可能是你忘記在 SKILL.md 裡寫上版本號或是作者名字了,這就像寄信忘記貼郵票一樣!
練習 2:從 GitHub 安裝別人的心血 假設你的朋友在 GitHub 上發佈了一個神級技能,你可以這樣一鍵安裝:
hermes skill install https://github.com/your-friend/awesome-hermes-skill看!不需要手動下載解壓縮,管家會自動跑去網路書店幫你把書買回來並放進書櫃裡。
練習 3:升級已安裝的技能 當你發現你安裝的外掛技能推出了新版本:
hermes skill update awesome-hermes-skill管家會去檢查 GitHub 上有沒有更新的 SKILL.md。如果有,它就會幫你把魔法書升級到最新版!
🎉 太棒了!你現在已經是個開源貢獻者(潛在的)了!
懂得分享的魔法師,運氣都不會太差。現在你已經會寫、會管、還會分享技能了。
不過,有些強大的魔法可能需要好幾個檔案互相配合,甚至需要用到網頁模板?下一章,我們將帶你進入深水區——《進階技能模式》。準備好挑戰多檔案專案和模板引擎了嗎?我們第二十一章見!🌊