Obsidian Wiki Skill 生態系指南
Obsidian Wiki Skill 生態系指南
這個 Vault 的知識管理不是單一 skill，而是一組分工明確的 skill 生態系：各自負責寫入（write）或查詢（read-only）的不同職責，並透過 寫作與發佈分離的原則，讓自動整理的知識與手動發布的 Digital Garden 文章分開管理。
官方 Repo：https://github.com/ar9av/obsidian-wiki
中文好讀版：https://github.com/Ar9av/obsidian-wiki/blob/main/README_TW.md
相關入口
1. 設定／初始化類
| Skill |
用途 |
wiki-setup |
從零建立新 Vault 的資料夾結構、.env 設定與基本檔案；既有 Vault 也可以指定共用。通常只需要做一次。 |
2. 匯入類（寫入）
| Skill |
用途 |
wiki-ingest |
萬用匯入入口，處理 PDF、文章、聊天記錄、URL、資料夾等任何來源。 |
claude-history-ingest / codex-history-ingest / copilot-history-ingest / hermes-history-ingest / openclaw-history-ingest / pi-history-ingest |
分別把對應 AI 工具（Claude、Codex、Copilot、Hermes、OpenClaw、Pi）的歷史對話整批挖出來寫進 Wiki。 |
wiki-agent（/wiki-claude、/wiki-codex 等） |
與整批匯入不同：針對單一主題，只從某個 agent 的歷史裡挖出相關對話，匯入後立即回答問題。 |
wiki-capture |
把「當下這段對話」存成一篇完整 Wiki 筆記；--quick 模式零摩擦地把發現丟到 _raw/ 暫存，不寫 manifest／index／log。 |
wiki-update |
把「目前所在專案」的知識同步進 Wiki，供跨專案使用。 |
3. 查詢類（唯讀）
| Skill |
用途 |
wiki-query |
針對 Wiki 內容回答問題並附引用，是日常查詢的主要入口。 |
wiki-context-pack |
產生限定 token 數的內容包，供其他 agent／skill 消費，與 wiki-query 直接回答問題不同。 |
4. 維護類
| Skill |
用途 |
wiki-lint |
健檢：孤立頁面、矛盾內容、過時內容、壞連結；加 --consolidate 會直接修正並回報。 |
wiki-dedup |
找出「同一個概念、不同頁面」的重複，合併。 |
cross-linker |
自動幫頁面之間補上 wikilink。 |
wiki-synthesize |
找出常一起出現但沒有「綜合頁」串起來的概念，建立 synthesis 頁面。 |
tag-taxonomy |
統一標籤詞彙；本 Vault 已於 2026-07-08 bootstrap 出canonical tag 列表。 |
daily-update |
每日例行維護（檢查來源新鮮度、更新 index、重建 hot.md），可搭配 cron。 |
5. 總覽／報告類
| Skill |
用途 |
wiki-status |
目前 ingest 了多少、還剩多少沒處理；加「insights」關鍵字可看 Wiki 結構（hub 頁面、跨領域橋接）。 |
wiki-digest |
一段時間內（日/週/月）學到什麼的摘要報告。 |
wiki-dashboard |
用 Obsidian Bases／Dataview 建立動態查詢視圖。 |
6. 其他工具
| Skill |
用途 |
memory-bridge |
依「哪個 AI 工具產生」的維度瀏覽/比較知識，適合找工具間的知識落差。 |
wiki-export |
匯出成 JSON/GraphML/Neo4j/HTML 等格式。 |
graph-colorize |
依 tag／資料夾／可見度幫 Obsidian 圖形視圖上色。 |
vault-skill-factory |
把已經成熟的 Wiki 頁面群打包成一個可攜帶的 Agent Skill。 |
7. Vault 資料夾架構
Wiki 系統專用資料夾（AI 自動整理，依 Vault Conventions 規則與既有 Digital Garden 資料夾隔離）：
| 資料夾 |
用途 |
concepts/ |
定義、框架、心智模型 |
entities/ |
人物/工具/組織等實體頁 |
skills/ |
skill 相關知識 |
references/ |
外部來源摘要 |
synthesis/ |
跨概念綜合分析、決策記錄 |
journal/ |
多主題的 session 摘要 |
projects/ |
依專案分類的知識 |
_raw/ |
wiki-capture --quick 的暫存區，待 wiki-ingest promote |
_staging/ |
審核中、尚未確定分類的內容 |
_archives/ |
已淘汰/被取代的頁面 |
分類判準
上表是形狀，實際分類時判斷順序如下（依 llm-wiki、wiki-ingest、wiki-capture 三個 skill 彙整）：
- 可以指名道姓的東西（人/工具/組織/專案）→
entities/。程式碼庫 ingest 例外：只有架構層級、連結度 ≥ 2 的 class 才建頁。
- 教怎麼做一件事 →
skills/。
- 單一來源的濃縮摘要 →
references/（學術論文用 Paper Deep-Dive Template）。
- 跨來源整合分析，或一個決策及其理由 →
synthesis/。
- 橫跨多主題、無單一歸類的對話摘要，或定期 digest →
journal/。
- 以上皆非、單純是抽象概念/框架 →
concepts/（預設分類）。
最容易混淆：entities/（指名道姓的東西）vs concepts/（原理/想法）；journal/（綁時間點的日誌）vs synthesis/（不綁時間點的萃取知識）。
追蹤與 meta 檔案：
| 檔案 |
用途 |
index.md |
全站頁面索引 |
hot.md |
最近活動的語意快取（daily-update 維護） |
log.md |
所有 wiki 操作的 append-only log |
.manifest.json |
專案 ↔ source_cwd 對照表 |
| _meta/taxonomy.md |
canonical tag 詞彙表（tag-taxonomy 維護） |
一句話版本
想「查」→ wiki-query；想「存」→ wiki-capture（快速用 --quick）；想「大量匯入舊資料」→ wiki-ingest 或對應工具的 *-history-ingest；想「維護健康度」→ wiki-lint / cross-linker / wiki-dedup；想「看現況」→ wiki-status / wiki-digest。
延伸閱讀