Files
kbdb-graph-plugin/.claude/commands/wiki-capture.md
T
Leo efe8e165cf feat: KBDB-graph 插件獨立 — 全面改寫成走基本盤 API(API-as-Wall)
按 leo 鐵律(2026-06-14)把插件從「直接 SQL 操作基本盤表」改寫成
「只透過基本盤 arcrun/kbdb HTTP API 讀寫」。零建表、零 migration、零 SQL。

- 新增 src/lib/kbdb-client.ts:唯一對外通道,封裝 entries/templates/records API
- 新增 src/lib/templates.ts:triplet/entity template 定義(替代建表)
- 改寫 21 個違規 action(triplet/graph/entity/search)→ 走 client,圖在插件層記憶體組裝
- 移除所有 migrations、D1/Vectorize/AI 綁定;embedding/語意搜尋歸基本盤 optional 模組
- index.ts 只掛 triplets/graph/entities/search 路由;基本盤路由歸 arcrun/kbdb
- 測試改走 mock client(純 node);裁剪 CLAUDE.md 只留 graph 插件 + 鐵律
- 修正 SDD design.md「讀現狀推翻鐵律」的錯誤判斷(共用 D1 → API-as-Wall)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-14 20:59:41 +08:00

1.6 KiB
Raw Blame History

/wiki-capture — 把對話結論存進 wiki

把這次對話中產生的決策、誤解釐清、或重要結論存入 wiki。 解決「討論過了但知識消失」的問題。


執行流程

第一步:辨識對話中的可記錄內容

掃描當前對話,找出:

類型 判斷標準 存到哪
架構決策 「為什麼選A不選B」「我們決定用X」 decisions-summary.md + docs/2-architecture/decisions/
CC 的誤解被糾正 CC 說了某件事,使用者說「不是,是...」 mistakes.md
重要狀態更新 完成了某件事、阻擋了某件事 status.md
技術發現 踩到坑、找到解法、重要行為確認 mistakes.md 或對應 SDD

第二步:列出清單給使用者確認

格式:

這次對話我整理了以下內容要存入 wiki

1. [MISTAKE] CC 誤解了 X,正確是 Y
2. [DECISION] 決定用 A 不用 B,原因是 C
3. [STATUS] 完成了 task 2.3,下一步是 2.4

確認後存入,有需要修改的嗎?

停下來等確認。

第三步:寫入

確認後,依照格式寫入對應檔案:

mistakes.md 格式:

⚠️ MISTAKE: [錯誤描述]
   症狀: [CC 的表現]
   正確做法: [應該怎麼做]
   原因: [背景]
   日期: [YYYY-MM-DD]

decisions-summary.md 格式:

## [主題] — [YYYY-MM-DD]
**結論**[一句話]
**原因**[簡短說明]
**詳細**docs/2-architecture/decisions/[檔名]

重大決策同時在 docs/2-architecture/decisions/ 建立 ADR 檔案。

第四步:確認

告知存到哪些檔案,共幾條記錄。