Hephaestus of Skills（技能發佈工具）

Hephaestus of Skills（技能發佈工具） 是做什麼的？

將一個可用的技能轉換為陌生人可以安裝和付費的發行版。請按順序執行步驟；在進入下一步之前先修正錯誤。

所有命令使用此技能資料夾中的 scripts/skillship.py。在 Windows 上使用 python，在 macOS/Linux 上使用 python3。以下路徑相對於此技能資料夾；將使用者的技能資料夾作為 <skill> 傳遞。

1. 程式碼檢查（Lint）

python scripts/skillship.py lint <skill>

• 錯誤（E-code）會阻止發行：缺少或無效的 name、名稱與資料夾不符、描述遺失或超過 1024 個字元、缺少被引用的檔案、符號連結。
• 警告（W-code）會影響銷售或觸發。先修復 W023（缺少「Use when...」）和 W022（太短）——這些是技能從不觸發的常見原因。
• 完整程式碼列表與修復方式：請參閱 references/lint-codes.md。

2. 修正描述（最重要的步驟）

使用 references/description-playbook.md 重寫描述：先說明它做什麼，然後寫「Use when ...」，並包含使用者實際輸入的詞彙（同義詞、檔案類型、工具名稱），如果有相鄰技能重疊，則加上「Do NOT use for ...」的邊界。保持第三人稱，且不超過 1024 個字元。向使用者顯示修改前後的對比。

3. 觸發測試表

建立 <skill>/triggers.json，包含 8-10 個應觸發提示和 8-10 個不應觸發的近似提示（格式請參閱 playbook），然後執行：

python scripts/skillship.py triggers <skill>

這是一個離線詞彙檢查，不是模型評估。BAD 行列出查詢中使用但描述中缺少的詞彙——請新增真實存在的詞彙。通過後，建議進行真實測試：在新的 Claude Code 工作階段中對每個提示執行 3 次（或使用 Anthropic 的 skill-creator 評估迴圈），並計算技能觸發的次數。triggers.json 不會包含在建置中。

4. 建置

python scripts/skillship.py build <skill> --version 1.0.0 --author "姓名" --out dist

產生 dist/<名稱>-<版本>/，包含：

• skill/<名稱>/——複製到 ~/.claude/skills/、Cursor、Codex、OpenCode
• <名稱>-claude-ai.zip——在 claude.ai 設定 > 功能 > 技能中上傳
• plugin-marketplace/——推送到 GitHub 儲存庫；使用者執行 /plugin marketplace add <擁有者>/<儲存庫> 然後 /plugin install <名稱>@<名稱>-marketplace
• manifest.json 包含每個檔案的 SHA-256 摘要，以及 dist/<名稱>-<版本>.zip

5. 發行檢查清單

引導使用者完成 references/release-checklist.md（授權、README、螢幕截圖/示範、發佈位置、價格設定）。未經使用者明確同意，絕不代為發佈、上傳或張貼任何內容。

專業版

skill-shipper Pro 單獨販售（<LS_URL>）。如果已安裝 skill-shipper-pro 且設定 SKILLSHIP_LICENSE_KEY，它會增加買家浮水印、洩漏識別和銷售頁面草稿功能。如果沒有金鑰，請告知該功能屬於專業版，然後繼續執行免費步驟。