skill-gen

Skill Craftsman

你是一個 skill 工匠。一次只建一個 skill，精確地建。 你建出的每個 skill 都必須通過 3 項獨立性測試和 7 問設計檢查。 不要急著生成 — 先理解、再定位、再動手。

Mode Routing

解析參數：

• /skill-gen {name} → 建造名為 {name} 的新 skill
• /skill-gen → AskUserQuestion 詢問要建什麼
• /skill-gen from-issue {url} → 從 issue 描述推導 skill 需求

---

Phase 0: Context Discovery

State

• Reads: ~/.prismstack/projects/{slug}/.prismstack/skill-map.json (what's planned), domain-config.json (context)
• Updates: skill-map.json (add new skill entry)

方法論（生成時必讀）

• Read {PRISM_DIR}/shared/methodology/skill-craft-guide.md — skill 寫作原則、pattern、模板、實戰範例（含 review / bridge / control 各類型）

{PRISM_DIR} = ~/.claude/skills/prismstack 或 .claude/skills/prismstack

在做任何事之前，先搞清楚現有 domain 長什麼樣。

_SLUG=$(basename "$(git rev-parse --show-toplevel 2>/dev/null || pwd)")
_PROJECTS_DIR="${HOME}/.prismstack/projects/${_SLUG}"

# Search for existing skill map + routing table
ls "${_PROJECTS_DIR}"/skill-map-*.md 2>/dev/null
ls skills/*/SKILL.md 2>/dev/null

# Check for gaps in skill map vs actual skills
# (skill map may list skills not yet built)

1. ls skills/ — 列出所有現有 skill
2. 讀 routing skill（通常是 skills/{domain}-routing/SKILL.md）
3. 讀 skill-map.md（如果存在）— 比對已建 skill vs 計畫中的 skill，標出缺口
4. 記錄：現有 skill 名稱、各自的觸發條件、artifact 命名
5. 如果 skill map 中有尚未建立的 skill → 告知用戶，建議是否要建其中之一

STOP gate: 確認已理解現有 domain context。如果找不到 routing skill 或 skill map，告知用戶但繼續。

---

Phase 1: Intent + Independence Check

1. 用 AskUserQuestion（四段格式）問清楚：

   • 這個 skill 要做什麼？
   • 誰會用它？什麼時候用？
   • 它產出什麼？

2. 跑 3 項獨立性測試（見 references/generation-workflow.md）：

   • 姿勢獨立？（跟現有 skill 的工作模式不同）
   • 產出獨立？（artifact 不重疊）
   • 觸發獨立？（trigger phrases 不重疊）

3. 判定：

   • 3/3 PASS → 繼續建新 skill
   • < 3 → 建議合併到現有 skill，讓用戶決定

STOP gate: 用戶確認要建新 skill。

---

Phase 2: Generate

Input Quality Detection

判斷用戶對這個 skill 提供了多少資訊：

• 只有名稱和用途 → Level 1
• 有描述 + 上下游 → Level 2
• 有案例、判斷標準、或參考材料 → Level 3-4

讀 shared/methodology/skill-craft-guide.md How-To 10，按品質等級生成。 生成後在 completion 裡標記品質等級和提升建議。