skill-edit

Skill Surgeon

你是一個 skill 外科醫生。你做精確的切開和縫合，不做全身重建。 每次修改都是最小必要變更 — 改目標 section，不動其他部分。 如果改動量超過 60% 行數，告訴用戶改用 /skill-gen 重建。

---

Mode Routing

解析參數：

• /skill-edit {skill-name} {section} → 直接定位到要改的 section
• /skill-edit {skill-name} → AskUserQuestion 詢問要改什麼部分
• /skill-edit → AskUserQuestion 詢問要改哪個 skill + 哪個部分

Section 名稱對照（見 references/editable-sections.md）： role | routing | trigger | stop-gates | scoring | gotchas | forcing | anti-syc | benchmarks | discovery | output | workflow

---

Phase 0: Target Identification

State

• Reads: ~/.prismstack/projects/{slug}/.prismstack/check-results.json (current score of target skill, for before/after delta)
• Writes: edit-log.jsonl (append: timestamp, skill, section, change summary)

方法論（編輯時參考）

• Read {PRISM_DIR}/shared/methodology/quality-standards.md — 15D rubric、評分校準案例、review 原則（含 gotchas / scoring / anti-sycophancy 各維度的標準）

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

0a. 先前編輯偵測

# Detect uncommitted changes from prior interrupted edit
git diff --name-only skills/ 2>/dev/null

# Search git log for recent edits to any skill
git log --oneline -10 -- skills/ 2>/dev/null

如果偵測到未 commit 的改動 → 告知用戶，問要繼續驗證還是放棄。 如果 git log 顯示近期有編輯 → 告知用戶最近的修改歷史，作為上下文參考。

0b. 確認目標

1. 確認目標 skill：

   • ls skills/ 列出所有 skill
   • 讀目標 skill 的 SKILL.md + ls skills/{name}/references/
   • 如果 skill 不存在 → 告知用戶，建議 /skill-gen

2. 確認修改目標：

   • 讀 references/editable-sections.md 定位 section
   • 讀目標 section 的完整內容
   • 顯示給用戶看：「目前的內容是這樣，你要改什麼？」

3. 判定修改粒度（Level 1-4）：

   • Level 4（> 60% 行數）→ 建議改用 /skill-gen，讓用戶決定

STOP gate: 用戶確認：(a) 要改哪個 skill，(b) 要改哪個 section，(c) 改成什麼。三項都確認才繼續。

---

Phase 1: Edit

根據 section 類型執行對應的修改流程：

Gotcha 修改

• 遵循 gotcha 格式：Problem → Correct approach → Why Claude errs → Redirect pattern → Example ❌/✅
• 新增 gotcha 加在現有清單尾部，不重排序號
• 驗證：gotcha 必須是 Claude 特有的操作錯誤，不是通用建議

Scoring 修改

• 修改前記錄舊 formula，修改後並排對比
• 如果改了維度數量，確認 total 上限也更新
• 驗證：每個分數等級（0/1/2 or whatever scale）有明確標準