Skill Designer
概述
從結構化的技能點子規格產生一個完整的 Claude CLI 提示。該提示會指示 Claude 按照儲存庫慣例建立一個完整的技能目錄：包含 YAML 前置資料的 SKILL.md、參考文件、輔助腳本和測試框架。
使用時機
- 技能自動生成流水線從待辦事項中選取一個點子，需要一個設計提示給
claude -p - 開發者想要從 JSON 點子規格啟動一個新技能
- 對產生的技能進行品質審查時，需要了解評分標準
前置需求
- Python 3.9+
- 不需要外部 API 金鑰
- 參考檔案必須存在於
references/目錄下
工作流程
步驟 1：準備點子規格
接受一個包含以下內容的 JSON 檔案（--idea-json）：
title：人類可讀的技能名稱description：技能的功能描述category：技能分類（例如：交易分析、開發者工具）
接受一個標準化的技能名稱（--skill-name），它將作為目錄名稱和 YAML 前置資料中的 name: 欄位。
步驟 2：建構設計提示
執行提示建構器：
python3 skills/skill-designer/scripts/build_design_prompt.py \
--idea-json /tmp/idea.json \
--skill-name "my-new-skill" \
--project-root .
該腳本會：
- 載入點子 JSON
- 讀取所有三個參考檔案（結構指南、品質檢查表、範本）
- 列出最多 20 個現有技能以避免重複
- 將完整的提示輸出到標準輸出
步驟 3：將提示傳遞給 Claude CLI
呼叫流水線將提示透過管道傳遞給 claude -p：
python3 skills/skill-designer/scripts/build_design_prompt.py \
--idea-json /tmp/idea.json \
--skill-name "my-new-skill" \
--project-root . \
| claude -p --allowedTools Read,Edit,Write,Glob,Grep
步驟 4：驗證輸出
在 Claude 建立技能後，驗證：
skills/<skill-name>/SKILL.md存在且包含正確的前置資料- 目錄結構遵循慣例
- 使用 dual-axis-skill-reviewer 評分達到門檻
輸出格式
腳本輸出純文字提示到標準輸出。成功時退出代碼為 0，如果必要的參考檔案遺失則退出代碼為 1。
資源
references/skill-structure-guide.md-- 目錄結構、SKILL.md 格式、命名慣例references/quality-checklist.md-- 雙向審查者 5 類別檢查表（100 分）references/skill-template.md-- 包含 YAML 前置資料和標準區段的 SKILL.md 範本scripts/build_design_prompt.py-- 提示建構器腳本（CLI 介面）