skill-authoring-workflow

skill-authoring-workflow 是 Product Manager Skills 儲存庫的主要品質控管機制。它為產品經理提供了一套結構化、以工具優先的方法，將未成形的提示詞、粗略的工作坊筆記或實驗性框架轉化為符合嚴格儲存庫標準的專業級資產。透過使用 find-a-skill.sh、add-a-skill.sh 和 test-a-skill.sh 等原生腳本，此流程消除了主觀臆測，確保每一項新貢獻都能立即部署且易於搜尋。其設計旨在減少貢獻者的阻力，同時最大化所得 AI 代理的可靠性。

• 優化從非結構化想法到完整格式化 skills/SKILL.md 資產的轉換過程。

• 對前端內容 (frontmatter)、元數據限制（名稱 ≤ 64 字元，描述 ≤ 200 字元）及章節順序執行嚴格的驗證門檻。

• 提供導引式精靈或內容優先生成器，協助根據原始素材進行內容產生。

• 自動化儲存庫整合任務，包括 README 表格更新、技能計數遞增及交叉參照解析。

• 提供強大的測試套件，用於煙霧測試、元數據審計及觸發詞驗證。

• 支援將技能打包為可分發的 ZIP 檔，適用於 Claude Desktop、Codex 及企業級 CLI 工具等各種代理環境。

• 專為需要擴展內部工具組且不希望產生技術債的 PM、開發人員及 AI 工程師設計。

• 在作為互動式顧問使用時，需遵循 workshop-facilitation 協定。

• 必須強制使用 check-skill-metadata.py 腳本以滿足「完成定義 (Definition of Done)」要求。

• 非常適合將舊版文件轉化為可執行的代理邏輯。

• 避免常見陷阱，如冗長的描述、模糊的觸發語言及斷裂的相依連結。

• 要求持續使用標準化 CLI 工具，以避免憑感覺開發並確保輸出品質的可預測性。