Package Public Skill
執行將私人技能轉變為公開 GitHub 版本的發佈管線。 管線順序是固定的:評估 → 清除 → 文件化 → 主題化 → 打包 → 暫存。 不可跳過清除步驟。任何未解決的清除發現都不得出貨。
1. 評估
回答 registry/pipeline.md 中的四個問題(值得安裝嗎?獨立使用?可清除?能在一頁內解釋清楚?)。任何「否」→ 停止,回報阻礙因素,將技能保持為私人狀態。將裁定結果記錄在 registry 中。
2. 清除
執行掃描器並在繼續之前解決所有發現:
python3 scripts/scrub_personal.py <skill-dir>
- 將個人路徑替換為通用路徑(
/Users/you/...、<your-project>/)。 - 將個人姓名/電子郵件替換為公開品牌聯絡資訊或佔位符。
- 直接移除憑證 — 永遠不要將真正的祕密加入允許清單。
- 重新執行直到退出碼為 0。僅對意圖的公開字符串(例如品牌名稱)使用
--allow。
3. 文件化
從 references/ 複製檔案到候選技能根目錄,並填入所有佔位符:
readme-template.md→README.md(問題、安裝、使用、授權)changelog-template.md→CHANGELOG.md,第一筆條目## [1.0.0] - <今天>- 加入
LICENSE— 擁有者每次發佈時選擇(開源或商業)。在任何公開頁面上,絕不能聲明儲存庫實際上並未隨附的授權或價格。
4. 主題化網頁
將 assets/site-template/ 複製到發佈版本的網站資料夾,並取代 {{PLACEHOLDER}} 代幣(技能名稱、標語、儲存庫 URL、功能、安裝指令)。請勿變更調色盤、字型或佈局規則 — styles.css 中的標頭註解記錄了品牌票選結果(不使用黃色強調、不發光區塊、金色文字不搭配海軍藍、腳本字型僅用於強調)。
5. 打包
驗證結構(SKILL.md 前置元資料具有 name + description;僅存在實際的 scripts/、references/、assets/ 資源),然後壓縮:
cd <staging-parent> && zip -r <skill-name>.skill <skill-name>
6. 暫存與註冊
- 將清除後的資料夾 +
.skill壓縮檔 + 網頁移至releases/<skill-name>/。 - 更新
registry/pipeline.md的狀態和專案CHANGELOG.md。 - 回報:哪些內容已出貨、清除結果、剩餘手動步驟(git init、GitHub 儲存庫建立、推送 — 這些需要擁有者同意和憑證)。
請參閱 references/release-checklist.md 以取得完整的出貨前檢查清單;在宣告任何發佈完成前,請先執行一遍。