技能怎麼發出去：壓縮檔、網址、私有市集

技能寫好，第一個問題一定是怎麼給同事用。

我看過最常見的做法是把資料夾壓縮起來丟到群組，附一句「解壓縮放到那個目錄」。能用，可是過三個月就開始亂，沒人知道誰手上是哪一版，修了一個錯誤之後，只有剛好下載過新檔案的人才修好。

階段        發法                    代價
自己試      資料夾／壓縮檔／網址    每次手動更新
小團隊      共用資料夾一次載入      版本靠口頭同步
長期維護    私有市集（一個 repo）   要維護兩份清單檔

從輕到重

最輕的是直接指。啟動時用參數指向一個資料夾就能載入。2026 年 4 月底那一版起，參數也吃 .zip 壓縮檔，還能用另一個參數從網址抓一份下來，只用在這一場對話。適合「我做了一個東西，你先試試看」。

中間那一層是指向整個資料夾。2026 年 9 月起，同一個參數可以指到一個放了很多外掛的資料夾，一次全部載入。小團隊把共用的東西放在同一個雲端同步資料夾，這招就夠了。

最重的是做一個私有市集，要長期維護的話只有這個做得到。它就是一個 GitHub 倉庫，裡面放一份市集清單檔，每個外掛再各放一份自己的清單檔。做好之後，公司裡的人在設定裡登記這個市集一次，之後用安裝指令裝，要更新也有版本可以追。私有倉庫要認證的話，官方建議走 GitHub CLI 的認證設定，或在 CI 裡用 token 改寫 Git 網址。

企業還多一層：組織層級的市集由擁有者在管理後台設定，來源類型有限制，而且外掛裡不准放頂層的 bin/ 資料夾，可執行檔要放在 scripts/。

最常見的坑是版本號

官方文件列了一串常見錯誤，我挑三個最容易中的。

資料夾結構放錯位置。清單檔要放在 .claude-plugin/ 裡面，但技能、代理、hook 這些內容要放在外掛的根目錄，別放進 .claude-plugin/。我覺得這條最容易放錯。

清單檔的版本號沒跟著改，使用者那邊會繼續用快取裡的舊版。每次發布前都要改版本號，這一步沒有自動化，只能自己記得。

版本號在兩個地方各寫一份，也會打架。版本只寫在外掛自己的清單檔，市集清單檔別再寫一次。

發出去之前，先用官方的驗證指令檢查一遍。它會挑出欄位拼錯、型別不對、路徑無效這些問題，加上嚴格模式還會把警告當成錯誤。

動手做

還在自己試的階段，建立骨架和驗證各一行：

claude plugin init 我的外掛名稱 --with skills
claude plugin validate ./我的外掛名稱 --strict

要開始發給別人，先把誰拿到哪一版講清楚。這段可以幫你把發布流程寫成一頁：

我做了一個 Claude Code 外掛要發給公司同事用。請幫我寫一份一頁的發布與更新流程，
內容要包含：
1. 版本號什麼時候要加，加在哪一個檔案（提醒我不要在兩個地方各寫一份）。
2. 發布前的檢查清單：驗證指令、測試案例、改了什麼要寫在哪裡。
3. 同事怎麼安裝、怎麼更新、怎麼回報問題。
4. 一段給不熟技術的同事看的三行安裝說明。
請用繁體中文，語氣平實，不要用 emoji。

流程寫好之後，找一個還沒裝過的同事試一次最準。看他能不能只靠一行安裝指令加那一頁說明就裝好，再看你說不說得出公司裡誰在用哪一版。如果最後還是得再傳一次檔案給他，表示流程還有地方要補。

那一頁流程寫好後，放在倉庫最上層的說明檔裡，同事問怎麼裝的時候直接貼連結給他。

站內延伸

• 技能的資料夾長什麼樣 → 做第一個 Skill
• 同一份技能給三家工具用 → 一份技能三家工具用
• 助手共用的組織做法 → 找方法AI 助手共用

來源： Claude Code：Plugin marketplaces（私有市集的兩份清單檔與資料夾結構、私有倉庫認證、組織市集限制）；Claude Code：Plugins reference（plugin init、validate --strict、--plugin-dir、--plugin-url）；Claude Code：Discover plugins（安裝與更新）；Claude Code：週報 2026-w19（壓縮檔與網址載入）；Claude Code：週報 2026-w37（參數可指向整個資料夾）。