Skip to content

程式碼與結構解讀

LLM Wiki 本身不包含程式碼——它是一份想法文件(idea file),設計為直接複製貼上給 LLM Agent。以下對這份文件的 Markdown 結構與 Schema 設計進行解讀。

文件結構分析

# LLM Wiki(H1 標題)
├── ## The core idea(核心想法)
├── ## Architecture(架構:三層)
├── ## Operations(營運:Ingest / Query / Lint)
├── ## Indexing and logging(index.md + log.md)
├── ## Optional: CLI tools(可選工具)
├── ## Tips and tricks(實用技巧)
├── ## Why this works(為何有效)
└── ## Note(備註)

這是一份遞迴結構的文件——它本身就是它所描述的 wiki 的雛形。每個 H2 章節對應一個概念頁面,有清楚的內文和層級。

Schema 的設計模式

Karpathy 提到的 Schema(例如 CLAUDE.md 或 AGENTS.md)應該包含以下關鍵元素:

markdown
# Wiki Schema

## 目錄結構
- raw/         # 原始資料(不可修改)
- wiki/        # LLM 生成的維基頁面
- index.md     # 內容目錄
- log.md       # 操作日誌

## 慣例
- 每個概念頁面使用 YAML frontmatter(tags, date, source_count)
- 內部連結使用 WikiLink 格式 `[[頁面名稱]]`
- 頁面標題使用 H1,章節使用 H2/H3

## 工作流程
### Ingest 流程
1. 讀取原始檔案
2. 與人類討論重點
3. 寫入/更新 wiki 頁面
4. 更新 index.md
5. 記錄到 log.md

### Query 流程
1. 讀取 index.md 定位相關頁面
2. 讀取相關頁面內容
3. 合成答案並附引用
4. 將好的答案存回 wiki

### Lint 流程
1. 掃描所有頁面檢查矛盾
2. 找出孤立頁面
3. 建議新增遺漏的概念頁面
4. 建議需補充的資料來源

index.md 設計

markdown
# Wiki Index

## 概念
- [[LLM Wiki 的核心想法]] — 利用 LLM 維護個人知識庫
- ...

## 實體
- [[Andrej Karpathy]] — LLM Wiki 提出者
- ...

## 來源
- [[2026-04-02 LLM Wiki Gist]] — 原始想法文件
- ...

log.md 設計

markdown
## [2026-04-02] ingest | LLM Wiki Gist
讀取原始 Gist,建立 10 個筆記頁面,完成翻譯,建立索引。

## [2026-04-03] query | 比較 RAG 和 LLM Wiki
建立比較表格頁面,探討兩者的適用場景。

關鍵設計原則

  1. index.md 是唯一的入口點——LLM 在回答問題時先讀 index 再深入具體頁面,取代 RAG 的向量檢索
  2. log.md 是操作軌跡——一致的日期格式讓 Unix 工具可以直接 grep
  3. Schema 是雙向溝通的橋樑——人類和 LLM 共同演化這個文件