Files
kbdb-graph-plugin/.claude/commands/sdd-check.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.4 KiB
Raw Blame History

/sdd-check — 確認當前任務有沒有對應 SDD

動手前執行。確保 CC 有全局觀,不會在沒有設計文件的情況下猛衝。


執行流程

第一步:理解任務

確認使用者要做什麼:

  • 涉及哪個子系統?
  • 是新功能還是修改現有功能?
  • 影響範圍?

第二步:尋找對應 SDD

docs/3-specs/ 下尋找對應的子系統目錄,確認有沒有:

  • design.md(設計文件)
  • tasks.md(任務清單)

第三步:根據結果回應

情況 A:找到對應 SDD

✅ 找到 SDDdocs/3-specs/[子系統]/
📋 design.md[確認]
📋 tasks.md[確認,列出相關 task]
🎯 對應 task:[編號和描述]
繼續嗎?

情況 B:找不到 SDD,任務明確

⚠️ 找不到對應 SDD
任務:[描述]
建議在 docs/3-specs/[建議子系統名]/ 建立 SDD

要我幫你起草 design.md 嗎?(需要你確認後才動手)

情況 C:找不到 SDD,任務模糊

⚠️ 找不到對應 SDD,而且任務範圍不夠清楚
請先回答:
1. 這個功能屬於哪個子系統?
2. 完成的標準是什麼?
3. 有沒有不能動的邊界?

注意

  • 找不到 SDD 不等於可以直接動手
  • 小修改(修 bug、改文字)可以豁免,但要明確說「這是小修改,範圍是 X」
  • 新功能、架構變動、跨模組的修改 → 一定要有 SDD