Claude
9a5219d8bd
vault repo（Logseq/Obsidian 只有原文）需要萃，萃取歸 template。新增可重跑、 content_hash 冪等的增量萃取，把原始筆記萃成 system-dev/wiki 精耕卡＋[[wikilink]]， 供下游 Arcrun ingest 機械拉三元組。AI 只產卡片，不寫 KBDB、不拉三元組。 - 新增 /wiki-extract 命令：vault 增量重萃入口（給 Routine 反覆跑，不需 token）。 content_hash 冪等（.extract-manifest.json，hash 沒變＝零 AI 呼叫）；卡片格式沿用 wiki-init 第五步不重造；原文唯讀 + D16 精耕非 RAG。 - 新增 Logseq 任務 marker 解析單一真相源 docs/4-guides/logseq-markers.md： 大寫 marker（非 GFM checkbox），TODO/LATER→todo、DOING/NOW→in-progress、 WAITING→blocked、DONE→done、CANCELED/CANCELLED→closed；跳過 LOGBOOK/屬性行。 與 template#4 tasks 投影共用同一套，不各寫一份。 - install/update 帶下新命令與 guide；wiki-init 加增量重萃指針。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
文件分類索引
CC 整理文件時的分類依據。找不到分類就問，不要猜。
分類規則
| 目錄 | 放什麼 | 判斷標準 |
|---|---|---|
| 1-vision/ | 為什麼做這個 | 產品願景、北極星、設計哲學 |
| 2-architecture/ | 系統怎麼設計的 | 架構圖、技術棧、元件關係 |
| 2-architecture/decisions/ | 為什麼這樣設計 | ADR，選A不選B的原因 |
| 3-specs/ | 要做什麼 | SDD，每個子系統一個目錄 |
| 4-guides/ | 怎麼做 | 部署、開發流程、CLI 用法 |
| 5-records/ | 發生過什麼 | 歷史記錄，不修改只增加 |
| 5-records/incidents/ | 生產問題復盤 | 故障原因、時間線、改進方案 |
| 5-records/test-reports/ | 測試結果 | 壓測報告、驗收記錄 |
| 6-user/ | 給使用者看的 | README、安裝教學、FAQ |
CC 整理文件時的判斷流程
這個文件是...
├── 有明確子系統 + 設計內容？ → docs/3-specs/[子系統]/
├── 解釋為什麼做某個決定？ → docs/2-architecture/decisions/
├── 說明怎麼操作？ → docs/4-guides/
├── 記錄發生過的事？ → docs/5-records/
├── 給外部使用者看的？ → docs/6-user/
└── 以上都不確定？ → 列為「待確認」，問負責人
SDD 結構（docs/3-specs/ 下每個子系統）
docs/3-specs/[子系統名]/
├── design.md ← 設計文件（要做什麼、怎麼做、邊界在哪）
└── tasks.md ← 任務清單（[ ] 未開始 [🔄] 進行中 [x] 完成）
CC 動手前必須有這兩個檔案。找不到就停手。
.claude/wiki/ — CC 的記憶空間（CC 維護，人不手動編輯）
| 檔案 | 用途 | 更新時機 |
|---|---|---|
INDEX.md |
wiki 導引 | 新增 wiki 檔案時 |
mistakes.md |
CC 已知誤解 + 避坑 | 每次被糾正後 |
status.md |
當前進度 + 下一步 | 每次 session 結束 |
decisions-summary.md |
架構決策摘要 | 重大決策後 |