suxi-learning

個人知識管理 vault — 結合 Karpathy「LLM Wiki」模式與 Learning How to Learn 學習原則。 你(未來的 self)應該每隔幾個月回來重讀一次 README 跟 CLAUDE.md


0. 為什麼存在這個 vault

不是要建第二大腦,是要建 一個你能信任的知識來源:

  • 你想學的東西(MCP / Cloudflare / AI / SRE)變得太快,看完就忘。
  • 收藏 ≠ 學會。要把素材「揉碎」成自己的話,才算內化。
  • LLM 可以幫你做綜合整理,但學習卡(chunks)必須自己手寫 — 寫卡的過程本身就是學習,不能外包

1. 三層結構

raw/        # 原始素材   — LLM 唯讀
wiki/       # LLM 綜合頁 — LLM 讀寫,但要你過稿
chunks/     # 學習卡     — 你自己寫,LLM 不准動

加上輔助層:

daily/      # 每日日誌
reviews/    # 週/月回顧
templates/  # 三個模板:chunk / source / daily
docs/       # vault 自身的 setup 文件
index.md    # wiki 入口
log.md      # 操作時間軸 (append-only)
CLAUDE.md   # 給 LLM 的 schema 與邊界規範

完整目錄職責與 frontmatter schema 看 CLAUDE.md


2. 日常工作流

2.1 我吃進一個新材料(Ingest)

  1. 把素材丟進 raw/(我自己貼,LLM 不替我貼)。
  2. 對 Claude Code 說「ingest raw/<file>」。
  3. Claude 起草 wiki/sources/<slug>.md,先貼在對話裡讓我過。
  4. 我修一輪 → Claude 落檔 + append log.md
  5. 若摘要點到新概念,我選一兩個讓 Claude 開 wiki/concepts/ 新頁。

2.2 我有問題(Query)

  1. Claude 先讀 index.md 找入口。
  2. 引 wiki 頁回答,每段動到知識就要附 [[link]]
  3. 沒答案就明說「vault 沒收錄」,不要硬掰。

2.3 我要做學習卡(Chunkify)

  1. 指定某張 wiki 頁要 chunk 化。
  2. Claude 拆出候選卡片,輸出在對話裡(套 templates/chunk.md)。
  3. 為每張卡提 2~3 個 Recall 問題。
  4. 我自己複製貼到 chunks/<slug>.md,自己調整 — 這步不外包。

2.4 每週體檢(Lint)

每週對 Claude 說「lint 一下」,它會寫一份 wiki/reviews/lint-YYYY-MM-DD.md:

  • 矛盾、孤兒頁、過時頁、缺源頁、不平衡 domain
  • 只報告,不自動修。我決定要動什麼。

2.5 每日 / 每週 / 每月

  • Daily: 開新 daily/YYYY-MM-DD.md(套 templates/daily.md)。記錄 Recall 紀錄、散步想想。
  • Weekly: reviews/YYYY-Www.md — 看一週 daily,挑 3 個重點寫到 wiki。
  • Monthly: reviews/YYYY-MM.md — 跑 lint,review 過期 chunks。

3. Recall 與 Spaced Repetition

每張 chunks/ 卡片都有 next_review 欄。手動間隔建議:

第 N 次 Review間隔
1+1 天
2+3 天
3+7 天
4+21 天
5+60 天
6++180 天

回憶失敗 → 退回上一階,重來。 (裝 Spaced Repetition plugin 可以自動化,見 obsidian-setup.md。)


4. Git 工作流

  • 私人 GitHub repo。
  • 每天結束 commit 一次,訊息格式: YYYY-MM-DD: <一句話>
  • 不要 force push。chunks/ 是你的記憶,history 不能掉。
  • .gitignore 已排除 Obsidian workspace 狀態與本機 plugin data。
git add .
git commit -m "2026-05-19: 初始化 vault"
git push

5. 邊界 (給未來的我)

  • 不要每天都開新概念頁。3 個新頁/天上限,逼自己挑重點。
  • 不要讓 Claude 自動產 chunks。寫卡就是學習。
  • 不要把 raw/ 當作筆記區。raw/ 是「素材池」,不是學習區。
  • 每個月看一次有沒有 wiki 頁從未被 chunk 化過 — 若一直沒被 chunk 化,問自己:是這頁不重要,還是我在逃避?

6. 後續設定