overview-graphlisted
Install: claude install-skill SungFeng-Huang/research-cards
# Overview Knowledge Graph — Maintenance Skill
## Backend
`heptabase`/`both`:原路徑不變(whiteboard、tag、UUID)。`obsidian`:四支 scripts 全部
支援——卡片 id 用 `Folder/Name`;**知識地圖對應 Obsidian Canvas**(config
`obsidian.graph.canvas`,JSON Canvas 格式):工具只「加缺少的檔案節點」到畫布下方的
暫存區,**永不移動使用者手動排好的節點**(與 Heptabase whiteboard 的人工策展分工相同:
腳本管帳、人管圖)。`make_hub`/`resplit` 建新卡時自動補 canvas 節點(等同原本手動
`whiteboard add-card` 那步)。`audit_graph` 檢查對應:Level→frontmatter `level`、根目錄
覆蓋→`obsidian.graph.root_card`、whiteboard 成員→canvas 檔案節點(`canvas_optional`
豁免清單)、↔ 鏡像照常;topology snapshot 檢查為 heptabase 專屬(跳過並註明)。
The `study/overview` cards form a **knowledge graph**: a navigation **tree**
(spine) plus **lateral edges** (cross-links). This skill owns structural changes;
per-card content is owned by the unified `overview` skill (topics/<key>.md docs) and `overview-daodu`.
```
L1 📚 目錄 (nested-bullet hierarchy of everything)
L2 topic hubs(幕次脈絡 narrative → 子卡)+術語卡
L3 comparison cards + sub-hubs(e.g. 聽覺理解・推理=Spoken 主題的聽覺翼)
L4 cards under a sub-hub
+ lateral edges: 相關主題(橫向連結) sections, rendered as whiteboard lines
```
## Key IDs
| thing | id |
|-------|----|
| overview tag | config `heptabase.collections.overviews.tag_id` |
| `Level` property (select, options 0–4) | config `heptabase.graph.level_prop` |
| 📚 root index | config `heptabase.graph.root_card` |
| knowledge-map whiteboard | config `heptabase.graph.whiteboard` |
| hubs: Tokenizer / Spoken / Duplex / 聽覺翼(sub) | (config) / (config) / (config) / (config) |
Overview card