前言¶

自己寫的 Skill 想給別人用，最直接的方式是發佈到 SkillHub 社區。但真正走一遍就會遇到一連串瑣碎問題：API Token 放哪、本地 CLI 怎麼調、Git Bash 下路徑會不會踩坑、Skill 文件的 frontmatter 要符合哪些字段要求、怎麼確認不會誤發。這套流程一旦做熟，每次發佈都在重複同樣的判斷。SkillHub 發佈器（SkillHub publish helper）做的事情，就是把這條「本地 Skill → SkillHub 社區」的發佈鏈路固化成一套可複用方法，附帶一個默認防誤發的發佈腳本。

這是什麼¶

SkillHub 發佈器是一個發佈在 SkillHub 社區的 Skill（來源 community），座標 @user_00c9b356/skillhub-publish-helper，當前版本 1.4.0，分類 dev-programming，發佈者 user_00c9b356。它解決的是發佈流程本身：前置條件、Token 安全讀取、本地 CLI 調用、frontmatter 字段轉換、dry-run 預檢、常見報錯處理，並提供一套發佈後的反饋閉環方法論。

核心功能¶

下面列出資料中已覈實的能力，按發佈流程順序排列。

1、前置條件：發佈前需要完成實名認證並持有 API Token。
2、本地 CLI 調用：覆蓋從本地調用 SkillHub 接口的完整路徑，並包含對 Git Bash 路徑 bug 的規避。
3、frontmatter 轉換指南：給出 SkillHub 要求的 frontmatter 字段說明，便於把本地 Skill 的元數據整理成社區接受的格式。
4、dry-run 預檢：發佈腳本默認執行 dry-run，只做檢查不實際發佈，防止誤發。
5、安全發佈：加 --publish 參數纔會真正提交發布。
6、Token 安全讀取：Token 從環境變量 SKILLHUB_TOKEN 或 --token 參數讀取，不落盤。
7、常見報錯處理：覆蓋 409 slug 衝突等發佈階段常見報錯。
8、反饋閉環方法論：發佈 → 取評測 → 優化 → 重發的流程由 references/eval-feedback-loop.md 承載。

隨包附帶通用 publish.sh 腳本，實現上述第 4 到第 6 項。另有本機可選的 fetch_eval.sh，用於一鍵取回評測做對比；該腳本因觸發服務端掃描 bug（編號 566）未隨發佈包分發。

安裝與啓用¶

該 Skill 通過 SkillHub 社區分發，座標 @user_00c9b356/skillhub-publish-helper，版本 1.4.0。啓用前需準備好 API Token，可用環境變量方式提供：

export SKILLHUB_TOKEN="<your-token>"

隨後在 Skill 目錄內運行隨包附帶的 publish.sh。腳本依賴上述環境變量，或改用 --token 參數傳入。

典型用法¶

發佈腳本的核心行爲是默認 dry-run、顯式加 --publish 才真發。典型的兩次運行如下。

第一次，只做預檢，不實際發佈：

./publish.sh

這一步執行 dry-run，會檢查 frontmatter 字段、路徑等問題，但不會向社區提交。

確認預檢通過後，再真正發佈：

./publish.sh --publish

如果不想設置環境變量，可以用參數傳入 Token：

./publish.sh --publish --token "<your-token>"

發佈完成後，按 references/eval-feedback-loop.md 的方法論取回評測、優化、重發，形成閉環。

適用場景與注意¶

適合在 SkillHub 社區發佈 Skill 的開發者，尤其是需要反覆發佈、迭代的情況。資料中明確提到一個已實測的事實：在 WorkBuddy 沙箱內即可直連 api.skillhub.cn 完成發佈，無需轉到用戶 WSL。

需要注意的幾點：

1、Token 不要寫進腳本或配置文件，統一走環境變量或 --token 參數。
2、frontmatter 字段要按 SkillHub 要求整理，dry-run 階段會先暴露這類問題。
3、遇到 409 錯誤通常意味着 slug 已被佔用，需要更換 slug。
4、fetch_eval.sh 未隨發佈包分發，需要時需自行從方法論文檔中獲取。
5、該 Skill 帶 requires_api_key=true 標籤，說明使用前必須先準備好 API Token。

結尾¶

SkillHub 發佈器的價值不在於提供一個新的發佈接口，而是把發佈這條鏈路上的前置條件、路徑坑、字段要求和防誤發機制一次性梳理清楚，讓人不必每次重新試錯。官方地址：https://api.skillhub.cn/user_00c9b356/skillhub-publish-helper