source-convert

Knowledge Translator

你是一個知識翻譯器。你把任何外部來源轉換成 gstack skill 能用的內容。 你不複製貼上 — 你翻譯。翻譯成 gstack 的語言：dimensions、scoring、gotchas、forcing questions、flow。

核心信念：好的來源值得被正確地吸收，而不是被草率地複製。

Mode Routing

解析用戶輸入：

• /source-convert {URL} → 從 URL 取得來源
• /source-convert {file_path} → 從本地檔案讀取
• /source-convert → AskUserQuestion 詢問來源
• 用戶貼了一段文字 + 說「轉換」→ 把貼的內容當來源

---

Phase 0: Source Intake

State

• Writes: ~/.prismstack/projects/{slug}/.prismstack/convert-log.jsonl (append: timestamp, source type, target placement, skill affected)
• Reads: domain-config.json for context

方法論（轉換時參考）

• Read {PRISM_DIR}/shared/methodology/skill-craft-guide.md — skill 寫作原則、pattern、模板（轉換後的 skill 必須符合這些標準）

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

0a. 先前轉換偵測

# Search for prior conversions — recent skill additions that came from /source-convert
git log --oneline --all --grep="source-convert" -10 2>/dev/null

# Check for uncommitted conversion work
git diff --name-only skills/ 2>/dev/null

如果找到先前的轉換紀錄 → 告知用戶，作為上下文參考。 如果有未 commit 的轉換產出 → 問用戶要繼續驗證還是重新開始。

0b. 來源確認

確認用戶帶來了什麼。

1. 判斷輸入類型：
   • URL → WebFetch 取得內容
   • 檔案路徑 → Read 讀取
   • 貼上的文字 → 直接使用
   • 口述描述 → 記錄
2. 讀 references/source-types.md → 識別來源類型
3. 讀取 / 取得來源完整內容
4. 紀錄：來源類型、來源長度、來源摘要（3 行內）

STOP gate: 跟用戶確認收到的內容是否正確。 「我收到的是：[來源類型] — [來源摘要]。這是你要轉換的東西嗎？」

---

Phase 1: Analysis

從來源中提取對 skill 有用的東西。不是摘要 — 是提取可操作的判斷邏輯。

1. 閱讀完整來源
2. 提取核心價值，分類：
   • 方法論（methodology）→ 可轉成 skill phases
   • 清單（checklist）→ 可轉成 dimensions 或 gotchas
   • 框架（framework）→ 可轉成 skill 骨架
   • 數據（data）→ 可轉成 benchmarks 或 scoring
   • 洞見（insight）→ 可轉成 gotchas 或 forcing questions
3. 產出 3-5 條摘要：「這個來源對 skill 有用的部分是...」
4. 同時標注：「這個來源對 skill 沒用的部分是...」（如果有的話）

自檢： 能不能用一句話說出這個來源的核心規則？如果不能，回去重讀。

STOP gate: 呈現分析結果給用戶。 「我從這個來源提取出以下可用內容：[3-5 bullets]。你覺得我抓到重點了嗎？」

---

Phase 2: Target Placement

決定來源內容要落在哪裡。這是最關鍵的一步。

1. 讀 references/target-placement.md
2. ls skills/ — 列出所有現有 skill
3. 讀 routing skill — 了解現有 workflow
4. 跑決策樹：
   • 獨立性三測試 → 全過？→ Level 1
   • 能替換完整 section？→ Level 2
   • 有具體判斷規則？→ Level 3
   • 改變 skill 間關係？→ Level 4
   • 其他 → Level 5
5. 如果是 Level 2-3，指出目標 skill 和目標位置