Initial commit

skills/llm-wiki/SKILL.md

@@ -0,0 +1,134 @@
+---
+name: llm-wiki
+description: >-
+  為任何開發專案建立或維護 LLM Wiki 記憶系統——一套讓 CC（Claude Code）不再重複犯錯、
+  不忘決策脈絡的雙空間文件結構。觸發時機：
+  （1）新專案 init——「幫我建立 wiki 系統」「新專案要設置文件結構」；
+  （2）老專案 migrate——「幫我整理文件」「文件太亂了」「散落的 md 幫我收一收」；
+  （3）對話結論 capture——「把剛才的討論記下來」「這個決定要存起來」「我不想再解釋一次」；
+  （4）wiki 更新——「更新 status」「記錄這個 mistake」「加一條決策」。
+  只要涉及「讓 CC 記住某件事」或「整理專案文件讓 CC 好找」，都用這個 skill。
+---
+
+# LLM Wiki Skill
+
+讓 CC 不再是失憶的協作者。這個 skill 幫你在任何專案裡建立一套
+**人寫文件 + CC 整理 wiki** 的雙空間系統，讓每次 session 都能無縫接上。
+
+靈感來源：Andrej Karpathy 的 LLM Wiki 概念——不用 embedding，
+只靠 pre-compile 把知識整理成 LLM 友善的格式。
+
+---
+
+## 四種使用情境
+
+| 情境 | 觸發訊號 | 跳到 |
+|------|---------|------|
+| **A. 新專案 init** | 空專案、剛開始 | → [流程 A](#流程-a新專案-init) |
+| **B. 老專案 migrate** | 已有文件但很亂 | → [流程 B](#流程-b老專案-migrate) |
+| **C. 對話結論 capture** | 剛討論完某個決策 | → [流程 C](#流程-c對話結論-capture) |
+| **D. Wiki 日常更新** | session 結束、踩到坑 | → [流程 D](#流程-d-wiki-日常更新) |
+
+---
+
+## 雙空間架構
+
+```
+專案根目錄/
+├── CLAUDE.md                ← 導航牌，≤100 行，永遠不增長
+├── docs/                    ← 原始文件空間（人寫，CC 讀）
+│   ├── README.md
+│   ├── 1-vision/
+│   ├── 2-architecture/decisions/
+│   ├── 3-specs/
+│   ├── 4-guides/
+│   ├── 5-records/{incidents,test-reports}/
+│   └── 6-user/
+└── .claude/wiki/            ← CC 整理的知識（CC 寫）
+    ├── INDEX.md
+    ├── mistakes.md
+    ├── status.md
+    └── decisions-summary.md
+```
+
+三條原則：docs/ 人寫 CC 不改 | wiki/ CC 維護 | CLAUDE.md ≤100 行
+
+詳細格式見 `references/templates.md`。
+
+---
+
+## 流程 A：新專案 Init
+
+1. 建立目錄結構
+2. 依 `references/templates.md` 建立六個核心檔案
+3. 訪談（每次一個問題）：做什麼 / 技術限制 / 技術棧 / 現有規範
+4. 填入 CLAUDE.md，完成確認
+
+---
+
+## 流程 B：老專案 Migrate
+
+⚠️ 三個階段，每階段等確認再繼續。
+
+**階段一：掃描 + 分類計畫**
+遞迴找所有 .md，標注建議位置和信心度，列清單等確認。
+
+分類規則：
+```
+子系統設計文件 → docs/3-specs/[子系統]/
+為什麼做某決定 → docs/2-architecture/decisions/
+怎麼操作       → docs/4-guides/
+歷史記錄       → docs/5-records/
+給使用者看的   → docs/6-user/
+不確定         → 列為「待確認」，問使用者
+```
+
+**階段二：讀文件，建 wiki**
+每個文件讀完後提取到對應 wiki 檔案，全部讀完後展示結果等確認。
+
+**階段三：歸檔**
+按確認好的分類移動，根目錄只留必要項目，更新 CLAUDE.md 路徑。
+
+---
+
+## 流程 C：對話結論 Capture
+
+這是最容易被忘記、也最重要的情境。
+
+| 內容類型 | 存到哪 |
+|---------|-------|
+| 架構決策 | `decisions-summary.md` + `docs/2-architecture/decisions/[日期]-[主題].md` |
+| CC 誤解被糾正 | `mistakes.md` |
+| 狀態更新 | `status.md` |
+
+操作：辨識 → 列清單給使用者確認 → 寫入 → 告知存到哪裡
+
+**Mistakes 格式：**
+```
+⚠️ MISTAKE: [錯誤描述]
+   症狀: [CC 的表現]
+   正確做法: [應該怎麼做]
+   原因: [背景]
+   日期: [YYYY-MM-DD]
+```
+
+---
+
+## 流程 D：Wiki 日常更新
+
+Session 結束時固定更新 status.md：
+- 這次做了什麼
+- 遇到什麼問題
+- 下次從哪裡開始
+- 有新誤解 → 同時 append mistakes.md
+- 有新決策 → 同時 append decisions-summary.md
+
+---
+
+## 維護規則
+
+1. `docs/` 只讀不改
+2. `.claude/wiki/` 只增不刪
+3. `CLAUDE.md` 不增長，超過 100 行就是放錯地方
+4. 分類不確定就問
+5. 對話結論當場 capture