---
name: lokipedia
description: Use when user shares knowledge to save, asks to look up something in the knowledge base, wants a health check, or mentions "Lokipedia", "知識庫", "筆記", "整理進去", "記下來", "有沒有筆記", "查一下 Lokipedia".
---

# Lokipedia

Loki 的個人知識庫，位於 `~/Documents/Lokipedia/`。Claude 是唯一的維護者，Loki 透過對話丟資料、用 Obsidian 瀏覽。

## Vault Structure

```
~/Documents/Lokipedia/
├── INDEX.md              ← 總入口、Recent、Stats
├── notes/                ← Atomic notes（扁平）
├── references/           ← 外部資料（文章、論文）
├── attachments/          ← 圖片、PDF
├── _index/               ← MOC 目錄頁
└── templates/            ← 筆記模板
```

## Modes

### 1. Ingest — 使用者丟資料進來

觸發：使用者貼連結、截圖、文字，說「整理進去」「記一下」等。

Flow:
1. 理解原始資料（讀連結、看截圖、理解文字）
2. 決定類型：concept → `notes/`，外部文章 → `references/`
3. 用自己的話寫成 atomic note（不是複製貼上）
4. 建立 wiki-links 到相關筆記
5. 更新 `_index/` 對應的 MOC
6. 更新 `INDEX.md` 的 Recent 和 Stats

### 2. Query — 使用者查詢知識

觸發：使用者問「Lokipedia 有沒有 X」「之前有記過 Y 嗎」。

Flow:
1. Grep `~/Documents/Lokipedia/` 搜尋相關筆記
2. 讀取找到的筆記
3. 綜合回答
4. 如果答案產生了新知識，回填成新筆記

### 3. Health Check — 維護品質

觸發：使用者說「health check」「檢查知識庫」「整理一下 Lokipedia」。

Flow:
1. 讀 INDEX.md 和所有 `_index/` MOC
2. Glob `notes/**/*.md` 和 `references/**/*.md` 取所有筆記
3. 檢查項目：
   - Orphan notes（沒有被任何其他筆記 link 到）
   - Broken links（`[[X]]` 但 X 不存在）
   - Tags 一致性（單複數混用、typo）
   - Frontmatter 完整性（缺 created/updated/tags）
   - 可合併或拆分的筆記
   - INDEX.md 的 Recent 和 Stats 是否正確
4. 修復能自動修的，其餘報告給使用者
5. 建議值得探索的新方向

## Writing Rules

### Frontmatter

```yaml
---
created: YYYY-MM-DD
updated: YYYY-MM-DD
tags: [複數, 小寫, 用英文]
related: [[其他筆記]]
---
```

`references/` 額外加：
- `source:` — URL
- `author:` — 作者

### Note Principles

- **Atomic** — 一則筆記一個概念
- **Self-contained** — 脫離上下文也能看懂
- **Own words** — 消化後重寫，不複製貼上
- **Linked** — 相關筆記用 `[[wiki-links]]`

### Conventions

- Tags 一律複數英文小寫（`articles` not `article`）
- 日期一律 `YYYY-MM-DD`
- 檔名用 kebab-case（`llm-knowledge-bases.md`）
- 檔名要唯一且有意義

### After Every Write

1. 更新相關筆記的 `related` 和 `updated`
2. 更新對應 `_index/` MOC
3. 更新 `INDEX.md` 的 Recent（最新的放最上面，保留最近 10 則）和 Stats