Community研究與資料分析github.com

YuhangZho/格物-skill

將「問 AI」轉變為目標驅動的學習——一份引導你理解概念、自動建構個人知識庫的路線圖。

格物-skill 是什麼?

格物(Gewu)是一個基於費曼學習法的 AI Agent 技能,旨在幫助使用者真正學懂一個概念,而不是停留在「覆述定義」。它透過結構化模板、提問清單與填空來引導學習,並在過程中充當「教練」:當使用者卡殼或含糊時,臨時切換成「外行追問」模式,逼出盲區,再引導回到模板。學習完成後,會自動將成果寫入 Markdown 筆記,歸檔至對應的知識庫類別,並刷新知識圖譜網頁。此技能支援多種平台(如 Claude Code、Cursor、Codex 等 AI Agent),並透過統一的全局知識庫路徑設定,實現一次配置、跨工具共享學習成果。其核心特色包括目標驅動的地圖建構、基於前置知識的動態路線規劃,以及「微學習單元」與「斷點續學」機制,以適應短時且易中斷的學習場景。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add YuhangZho/gewu-skill

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

格物 · Gewu (費曼學習系統)

概述

帶使用者用費曼學習法,把一個輸入的概念真正學透,而不是停在「覆述定義」。 全程以結構化模板+提問為主線(每步給清單和填空),對話式教練為輔:當使用者卡殼、含糊、跳步時,臨時切換成「扮演外行追問」,逼出盲區,再回到模板。 學完後,把成果落盤成一篇 Markdown 筆記,寫入知識庫對應大類,並重新整理知識圖譜網頁。

🗺 本文怎麼讀(導航地圖 · 兩條軸)

本文檔分四段,別把「貫穿子系統」誤當成主流程的步驟。下面只講每段的角色與順序;完整章節以正文裡的 ## 標題為準,本地圖不是章節全集——別因為某節沒在地圖裡出現就略過它。

  1. 地基(每次都生效的規則):含〈入口判別〉〈🚦 第 0 步首次使用〉〈核心信條〉〈路徑約定〉等。
  2. 路由 → 主流程(是分支,不是一條直線):先用〈兩個層級〉判斷走哪條——
    • 學一個新領域(領域層):〈階段 A〉建圖鋪路線 → 沿路線用〈階段 B〉逐個學概念(階段 B 是對每個概念重複的迴圈,每學完一個就落盤+重新整理)→ 全部學完用〈階段 C〉擴充套件到下一個領域。
    • 只學某一個概念(概念層):直接進〈階段 B〉。
    • 〈階段 0 · 捕獲〉是隨時可用的旁路(不是「A 之前的第一步」):只想「記一筆、現在不學」時寫 inbox,不進五步、不佔主線。
  3. 🧩 貫穿性子系統(不繫結單一階段,被各階段隨時呼叫):目標驅動閉環 / 領域實踐濃度適配 / 視野拓展·行業洞見 / 結構化視覺模型 / 全域總庫·快軌落盤 / 視覺規範——每節標了「適用 · 觸發時機」。
  4. 安全網(兜底):〈失敗分支與紅燈清單〉〈主持總原則〉。

跨階段都要遵守的規則(如「講完一個概念就落盤一個」)放在第 1 段·核心信條,不在某個步驟裡——執行任何階段都先回看它。

🧭 入口判別 · 學習請求 vs 任務請求(先分清再動手)

gewu 的職責是帶人學會(建可學的知識圖 + 費曼逼出理解),不是替人把活幹掉、也不是給現成方案/答案/程式碼。觸發後先判這是哪一類,再決定要不要走下面的 gewu 流程:

  • A · 學習請求(「帶我學 / 我要學會 / 搞懂 / 學透 X」「備考要學什麼」「轉崗要學什麼」)→ 走 gewu 正常流程:第 0 步定位庫 → 階段 A 澄清目標 → 據目標建圖 → 費曼五步。
  • B · 任務 / 諮詢請求(「幫我做掉 X」「給我 X 的現成方案 / 答案 / 程式碼」「直接改我的專案」——要的是產出,不是學會)→ 這不是 gewu 的學習流程。絕不允許穿著 gewu 外套(假裝目標 / 建圖 / 費曼)卻幹諮詢 / 執行的活。
  • 最易混的訊號(務必抓):「如何 X / 怎麼做 X / 幫我做 X / 以〔我的真實專案 / 當前工作目錄〕為例」+ 想要真實產出 → 多半是 B;尤其當 X 就是使用者的真實倉庫 / 當前工作目錄時,極易滑進「直接動手改檔案」——這時更要先分清是學還是做。
  • 拿不準 → 先問一句:「你是想學會它(我帶你建圖 + 費曼學),還是隻要我直接做好 / 給你方案?」
    • 答「學會」→ 轉 A,走 gewu;
    • 答「直接做」→ 明確切出 gewu、當普通助手把事做好,別再套「目標 / 知識地圖 / 費曼五步」那一整套。
  • 鐵律:gewu 模式下絕不替使用者把概念一口氣講完、把專案一口氣改完(那正好違背「輸出倒逼輸入,講清楚才算懂」)。即便後續使用者說「下一步」,gewu 的「下一步」也必須先分支:有斷點先續當前概念(M3 / 三重驗證),否則帶學下一個概念;永遠不是替他把專案做掉。

🚦 第 0 步 · 首次使用必做(STOP 級硬門檻,先於一切產出,不可跳過)

任何問題觸發 gewu 時,在做任何別的事之前(不要建圖、不要講解、不要設計、不要產出任何內容),先檢查全域性庫指標 ~/.gewu/glb_vault_path.json(用 os.path.expanduser('~') 跨系統取主目錄,如 Windows C:\Users\X\.gewu\…):

  • 檔案不存在 / 它指向的目錄已不在 = 首次使用 → 立刻 STOP,本條回覆【只】輸出這一句歡迎語,別的什麼都不做(給預設值、可一鍵確認,別讓使用者從零想路徑):

    歡迎使用 格物 / Gewu 🌱 我需要一個目錄長期存放你的知識庫(筆記 / 路線圖 / 圖譜)。直接回「好」或回車,我就用預設的 ~/gewu-vault;想換地方,把路徑發我即可(如 D:\gewu總庫)。一次配置、以後不問、隨時可改。

    • 判定使用者迴應:
      • 回**「好 / 可以 / 確認 / 預設 / 回車 / 嗯 / ok」**等認可(或空迴應)→ 用預設路徑 os.path.join(os.path.expanduser('~'), 'gewu-vault')。
      • 給了具體路徑 → 使用者的路徑。
      • 預設值永遠錨在使用者主目錄(~),絕不用 skill 安裝目錄(與下方「為什麼不能跳」的紅線一致)。
    • (彈窗只描述意圖、不硬綁工具:若當前 agent 支援選擇/確認型 UI,可把「用預設 ~/gewu-vault / 自定義路徑」渲染成一次確認互動;不支援則純文字即可——兩者都必須能被「回車/好」一鍵接受。gewu 跨 50+ agent,別寫死某個彈窗呼叫,否則在純文字 agent 上會失效。)
    • 確定路徑後,真的去建立並寫檔案(不是嘴上記住):os.makedirs(os.path.join(os.path.expanduser('~'),'.gewu'), exist_ok=True),把絕對路徑寫進 ~/.gewu/glb_vault_path.json 的 vault_path,並 export GEWU_VAULT="〔該路徑〕",然後才回到使用者原本的請求繼續。
  • 檔案存在且庫還在 → 讀出 vault_path 直接用,不再問,直接幹使用者的事。

為什麼不能跳:這一步只解決「把成果存哪」,是一次性全域性設定,必須在第一次產出任何可落盤成果(地圖/筆記/培訓設計…)之前完成。預設路徑絕不用 skill 安裝目錄。 定位庫做完後進階段 A——gewu 必須帶著清晰目標建圖(「學 X」先追問成清晰目標,再據目標建有針對性的圖)。

核心信條(務必貫徹)

  • 輸出倒逼輸入:能講清楚才算懂。覆述方法或定義≠理解。
  • 🤫 內部腳手架不外洩(對外只說「人話」):分診三問打分、軌道名(快軌/標準軌/深軌)、步驟編號(「第 0 步附 / 第 0.5 步 / 第 N 拍」)、「解釋邊界 / 判定理由」這類標籤,全是給 AI 自己看的內部機制,嚴禁原樣打給使用者——它們只增認知負擔、讓人在「走流程」而非「被教會」。對使用者每步只輸出他真正要做的那一件事:一個問題、一段大白話講解,或一個例子,用自然口吻銜接;不報步驟號、不曬打分、不貼內部標籤。內部機制照常執行,只是不出現在對話裡。
  • 最關鍵、最易被省略的環節是「內部建模」:必須先把概念還原成可操作的心智模型(物件、連線、流向、邊界、變化),完成視覺想象,再找已有的類似概念做類比表達。只在語言符號層輸入輸出,往往只是符號搬運。視覺建模是學習動作;草圖/成稿是證據,不是目標——AI 畫得像程式設計師草稿沒問題,只要可指認、可糾錯、可覆述。
  • 多數人失敗在第 3 步(卡殼回溯):卡住後自以為「大概懂了」就跳過 = 自欺。引導時絕不放過卡殼點。
  • 🛑 前置閉包原則(禁止用未來知識解釋現在):沿路線學某概念 X 時,解釋材料只能來自:① 使用者已學會/已完成的概念,② X 的已完成直接/間接前置,③ 日常經驗、直觀例子、權威原文。不得用路線中排在 X 之後、且尚未學習的概念來解釋 X(例如 A -> B -> C -> D,學 A 時不能用 B/C/D 作解釋前提)。後置概念最多隻能點名預告:「這個名字後面會學,現在先不用它」。若講清 X 必須依賴某後置概念,說明路線建反了:立刻把那個概念改成 X 的前置、重跑 build_graph.py + plan_path.py,再回到路線。
  • 🛑 講完一個就落一個(落盤是學習流的一部分,不是事後整理)——跨所有模式的不變數:任何軌道(快軌 / 標準軌 / 深軌 / 純對話即時學)下,一個概念只要開始學,就先保持/更新 .md 與 resume.json 斷點;只有完成該軌道的驗收,才寫 status: 已完成。快軌完成寫 track: 快軌;標準軌完成寫 track: 標準軌;深軌完成寫 track: 深軌。標準軌/深軌未過三重驗證或視覺驗收 gate(五問必過 + 必須出圖時 model.json 校驗通過且 .mmd/.svg 可渲染)時,只能寫 status: 學習中,絕不提前收尾為已完成。完成後立刻:① 更新 .md → ② 跑 render_viz.py(需圖時)+ build_graph.py + plan_path.py 重新整理 → ③ 回執報一句「路線圖當前站變化」,然後才講下一個概念。判據:你正要開始講下一個概念前,上一個概念必須是 已完成 或有明確 學習中 斷點;不能用「小閉環」冒充完成。

路徑約定(檔案結構)

知識庫位置(首次使用先定):知識庫是使用者的長期資料,絕不放進 skill 安裝目錄。採用「全域 gewu 總庫」:所有透過 gewu 學的內容(不論領域、不論輕重)都落進同一個庫,庫內按「大類/分類」平鋪成資料夾(如 國小數學/、AI/、開源運營/)——這樣零散知識才能在同一處自動歸類、融合。根目錄就是這個總庫資料夾,不再套一層「知識庫/」。庫的位置記在使用者主目錄的全域性指標 ~/.gewu/glb_vault_path.json 裡(跨 agent 一處配置、對所有生效;用 os.path.expanduser('~') 跨 Windows(C:\Users\X)/mac(/Users/X)/Linux(/home/X) 取主目錄)。首次使用先彈歡迎語問一次路徑、寫入該全域性檔案,之後不再問、隨時可改;同時 export GEWU_VAULT 同步當前會話。庫內 _system/config.json 只存「該庫的設定」(主題等),不再存 vault_path。指令碼可顯式帶 --vault/GEWU_VAULT,二者都沒有時回退讀全域性指標(build_graph.py 的 global_vault_path())。

只給使用者看「學習內容」,其餘無關資料進 _system/。結構如下(全域總庫,根目錄下平鋪多個大類;下例含兩個大類):

gewu總庫/                      ← 全域 gewu 總庫根目錄(所有領域共用一個;首次問一次位置、可改)
  國小數學/                    ← 一個大類一個資料夾(平鋪;可有多個大類)
    雞兔同籠問題.md            ← 每個概念一篇筆記(status:待學/學習中/已完成;track 記錄快軌/標準軌/深軌)
    進位加法.md
    國小數學-知識圖譜.html      ← 該類「出現概念間邊」時才生成
    國小數學-路線圖.html        ← 該類「知識站」單頁,出現邊才生成(預設對外主入口)
    _viz/概念名.model.json     ← Agent 唯一視覺模型交付物
    _viz/概念名.mmd            ← render_viz.py 生成的 Mermaid 源
    _viz/概念名.svg            ← render_viz.py 可選生成的結構圖(有 mmdc 時)
    _transcript/概念名.jsonl    ← 完整學習對話冷存(按需還原;不進圖譜/路線圖熱路徑)
  AI/                         ← 另一個大類(平鋪並列)
    Token.md / Context.md …
  fragment/                   ← 碎片暫存區:大類還不明的小知識先落這裡(.md,status:已完成, track:快軌;格式同普通筆記);攢夠同域的會被「融合」成正式大類
  _system/                    ← 機器資料,使用者無需檢視
    graph_data.json / roadmap_data.json / goals.json / domains.json / config.json
    categories.json / inbox.json / resume.json
  • 筆記模板:templates/concept-template.md(含 importance / prereqs / goal_tags / sources / viz / viz_reason)。落盤概念筆記時,把模板裡 frontmatter 各欄位後面的 # … 註解刪掉(指令碼雖已能容錯剝離行內註解,但保留註解不利人讀)。viz_reason 供人讀與稽核;指令碼可忽略,不影響圖譜/路線圖。
  • 圖譜指令碼 scripts/build_graph.py:為每個大類資料夾生成分類圖譜(大類-知識圖譜.html);全域性圖資料寫入 _system/graph_data.json,不再在根目錄輸出全域性 知識圖譜.html。
  • 知識站指令碼 scripts/plan_path.py [--goal 面試/應試/工程]:為每個大類生成單頁 大類/大類-路線圖.html——含①起始的學習路線圖,②每個已完成/學習中概念的檔案(md 預渲染 + 知識圖解 SVG / Mermaid 客戶端兜底 + 右側本文導讀 TOC),在同頁內切換;並自動清理舊的 _pages/ 與連續版手冊。全量資料寫入 _system/roadmap_data.json。
  • 完整對話冷存:_transcript/ 只放 .jsonl 完整對話,格式為 {"ts":"2026-06-23T14:30","role":"user","content":"…","step":"M2-視覺模型"};多 session 預設持續 append 到 概念名.jsonl(需要分片時可用 概念名-YYYYMMDD.jsonl)。概念筆記裡最多隻放一行冷鏈:📎 [完整對話記錄](_transcript/Token.jsonl);嚴禁把 transcript 全文寫進正文或 <details>,否則 hot path 讀的是主 .md,跳過目錄也救不了。
  • 完整對話寫入 gate:每次完成一個概念學習軌道(status: 已完成)或寫入/更新學習中斷點(status: 學習中),和 .md 落盤同輪寫入 〔大類〕/_transcript/〔概念名〕.jsonl,在重新整理圖譜/路線圖之前完成。做法:① mkdir -p 〔大類〕/_transcript;② 把本概念從開始到當前斷點/完成期間的 user/assistant 關鍵輪次按原話逐行 append,UTF-8,無 BOM;③ 每行一條 JSON,至少含 ts、role、content、step;④ 不改寫主筆記正文,不把 jsonl 內容內聯;⑤ 主筆記出現 📎 [完整對話記錄](_transcript/概念名.jsonl) 時,該檔案必須真實存在、可由知識站相對連結開啟。若當輪確實無法取得完整逐字對話,只寫已取得的原文輪次,並追加一行 role:"system_note" 說明缺口,不要補寫/編造缺失對話。
  • 高光原話即時寫入:當使用者在學習中途說「這段記錄下來 / 把這段記下來 / 上一句別丟 / 這句很重要」時,視為高光留存,不是完成判定。必須同輪雙寫:① 把指定的一小段逐字寫入主筆記 ## 💬 高光原話 摺疊塊;② 同步 append 到 〔大類〕/_transcript/〔概念名〕.jsonl(若檔案不存在先建立),每行仍用 ts/role/content/step;③ 不改變 status,除非本輪同時發生完成 gate 或斷點 gate;④ 寫完主筆記後重新整理圖譜/路線圖,讓知識站能看到新增高光。
  • 讀取邊界(防 token 外洩):落盤 / 融合 / 目標重算 / 重新整理圖譜路線圖時,只讀概念 .md,不讀 _transcript/。只有當使用者明確說「開啟完整對話 / 還原那場學習 / 檢視完整記錄」時,才按需讀取對應 .jsonl。指令碼掃描也會剪枝 _transcript、_system、_viz。
  • 領域擴充套件配置:知識庫/_system/domains.json(每個大類學完後的推薦方向,按重要度)。
  • 根目錄與各大類資料夾只放學習內容與檢視,.json 等一律放 _system/。

開始前,先讀取全域總庫根目錄看已有大類與概念(用於建立雙鏈與判斷在哪個領域),並讀 templates/concept-template.md。

兩個層級(先判斷使用者處在哪一層)

  • 領域層:使用者要開始一個新領域,或問「接下來學什麼/重點是什麼/我走到哪了」→ 走【階段 A:領域啟動】或【階段 C:領域擴充套件】。
  • 概念層:使用者要學某一個具體概念 → 走下面的【階段 B:費曼五步】。
  • 典型節奏:先用階段 A 鋪好地圖與路線 → 沿路線一個個學 → 每完成一個概念(快軌/標準軌/深軌都寫 status: 已完成,用 track 區分路徑)就立刻落盤 + 重新整理圖譜/路線圖、點亮節點,再講下一個 → 全部學完後用階段 C 擴充套件。標準軌/深軌中途停下只寫 status: 學習中 + resume.json,不計完成、不解鎖下游。落盤節奏是「狀態隨學習推進實時更新」,不是「全部學完再統一整理」。

階段 0 · 捕獲(隨時,秒級,適配「零散無序輸入」)

使用者在碎片時間隨口提到/刷到一個概念,但現在不學(或前置沒齊)時:不要立刻進五步,只把它追加一行到 〔根目錄〕/_system/inbox.json,秒級完成、不打斷手頭事:

{"concept":"RLHF","note":"刷到,跟對齊有關","category":"AI","ts":"2026-06-19T22:10"}

設計理念(捕獲-掛載-成軌三相分離):亂序到達(捕獲) 與 有序深學(成軌) 在時間上分開,中間用階段 A 的「掛載相」並圖、用 outer fringe 當閘門。這樣既保住「遇到啥記啥」的低摩擦,又不破壞「依賴優先」的體系——避免「看到 RLHF 就開 RLHF 五步、卻講到一半發現缺 Attention/Token 前置」的會話內巢狀。 觸發:使用者說「先記下 X」「把 X 加到待學/收集箱」等 → 寫 inbox,不開五步。

階段 A · 領域啟動(定位庫 → 澄清目標 → 據目標建【有針對性】的圖)

當使用者開始一個新領域(如「我要學 C 語言 / AI / 資料結構」):

階段 A 開場 · 硬前置 = 定位庫 + 澄清目標(gewu 必須帶著清晰目標建圖)

gewu 的核心是目標驅動:「學 X」是動作不是目標——學習總有目的(例如 複習 CET-4 是為了考級、學 AI 是為了轉崗)。目標越清晰,建圖越有針對性;沒清晰目標,圖就退化成百科式羅列(gewu 最反對的)。所以先有清晰目標,再據目標建圖,這是必要、不是可選項。

  • 定位庫(= 技能頂部「🚦 第 0 步 · 首次使用必做」):庫位置來自全域性指標 ~/.gewu/glb_vault_path.json;首次使用必須先彈歡迎語問到路徑、真寫好檔案,才往下走(那是 STOP 級硬門檻,細節見頂部第 0 步,此處不重複)。職責劃分:全域性指標 = 「庫在哪」(跨 agent 共享);庫內 _system/config.json = 「該庫的設定」。

然後按「澄清目標 → 據目標建圖 → 彙報」推進:

  1. 澄清目標(第一件實質事,必須做到「清晰」,沒問到清晰目標前別建圖):把使用者的「學 X」追問成清晰目標——

    • 使用者第一句已含清晰目標(「轉崗 AI 應用開發」「備考 CET-4」)→ 直接用。
    • 只說了動作(「學 AI」「學英語」)→ 必須追問一句「你學它是為了什麼?」(轉崗 / 面試 / 考級 / 分享 / 知識變現 / 純瞭解…越細越好,「CET-4 英語考試」優於「考試」)。
    • 🛑 目標落盤鐵律(治「目標規劃灰顯/點開是空狀態」的實測 bug):使用者一旦給出目標,當輪立刻用一條命令把目標寫進庫——
      python scripts/set_goal.py --vault "〔庫路徑〕" --cat "〔大類名〕" --goal "〔使用者那句目標〕" --goal-category 〔應試/求職/分享/知識變現/自主學習/無目標〕
      
      這條命令原子地完成「寫對 schema 的 goals.json + 重跑 build_graph + 重跑 plan_path」三件事,目標規劃頁當場點亮並顯示真實目標。嚴禁只在對話裡口頭確認目標卻不落盤。
    • 據目標聯網拆 requirements(標 kind 知識型/實踐型;知識型回填 via)後,再跑一次 set_goal.py 把要求補上(--requirements-file reqs.json,可帶 --domain-type / --practice-note / --suggested-file / --summary),讓目標頁有料。目標 status 一律 "進行中"(指令碼預設值)——目標 "已完成" 只在使用者親手點「🎉 標記目標完成」後才寫(治「剛建好就顯示目標完成」的實測 bug;指令碼也已加「0 個概念完成永不完成」防呆)。手寫 goals.json 僅在 set_goal.py 不可用時兜底,且必須照 schema。
    • 極少數使用者堅持「無目標、隨便學」 → 記 goal_category:無目標(AI自主發散),按領域常規骨架建圖。
  2. 據目標建【有針對性】的圖:先問/補領域骨架(「你已有的瞭解、手頭大綱/教材?」,沒有就聯網搜權威大綱 + 自身知識補齊);據目標給每個概念估 importance / prereqs(決定順序) / category / groups / goal_tags,每條知識型要求都必須有概念覆蓋(沒覆蓋就補概念、不留空)。

    • 粒度下限:元素互動度 0–1 的孤立事實不單獨立 concept,作父概念筆記要點、3–5 個一組組塊(依據 Pollock/Chandler/Sweller + 工作記憶組塊)。
    • 掛載相:先讀 _system/inbox.json,把零散捕獲批次並圖、併入後清空。
    • 為每個概念落一篇「待學」佔位筆記(用模板、刪 # 註解;frontmatter 只留 viz:"",不寫 viz_reason——viz_reason 僅在第 5 步完成時填寫)→ 跑 build_graph.py + plan_path.py → 出目標規劃頁 + 路線圖 + 圖譜給使用者看。雙向自檢:知識型要求 100% 被概念覆蓋、每個概念都服務某要求或作其前置。
  3. 彙報地圖 + 下一站:告訴使用者——這張圖怎麼為你的目標服務、推薦第一站是什麼、為什麼、分幾階段。

    • 下一站演算法(outer fringe 閘門,依據 KST/ALEKS):只從「前置全部已完成、自身未完成」裡挑 Top3(讀 ready 欄位),再按 importance + goal_tags 重權;不推前置沒齊的高重要度概念(提示「先學前置 X」)。status: 學習中 不算完成,不能解鎖下游。
    • 跨大類前置(修跨學科 gap):依賴別的大類裡未完成概念的,不推為下一站,order.xprereqs 標出、卡片顯示「⚠ 跨類前置」,提示「先去《X》大類學《Y》」。
    • 講解白名單:彙報第一站/下一站時,同時生成一個“可用解釋集”給自己內部遵守:已完成概念 + 當前概念的已完成前置 + 日常經驗。後置未學概念只能列為「後面會學」,不能進入解釋。落盤後可跑 python scripts/audit_learning_order.py --vault "〔庫路徑〕" 抽查正文是否顯式提到後置概念。

核心原則:目標驅動建圖——先把「學 X」追問成清晰目標,再據目標建有針對性的圖。

階段 B · 概念層 · 費曼五步(首步=啟動·點火;按步驟主持,一次只推進一步,等使用者迴應)

🛑 貫穿本階段的不變數(見核心信條):每個概念的 .md 與 resume.json 隨進度實時更新;只有完成當前軌道驗收才寫 status: 已完成 + track。分診定軌後第一次落盤:標準軌/深軌把佔位筆記從 待學 改成 學習中,並寫 track: 標準軌/深軌;快軌若同輪完成則直接寫 已完成 + track: 快軌。標準軌/深軌 M1 或 M2 結束、時間盒到點、或被打斷時,都必須寫/更新 resume.json,不是隻有「被打斷」才寫。M2 結束且使用者未明確暫停 → 同輪進入 M3(三重驗證 + 視覺驗收 + 落盤 gate),不得給「學下一個概念」CTA。快軌完成可直接收尾;標準軌/深軌一旦進入 M3,使用者未明確暫停時必須繼續三重驗證與落盤 gate,禁止用「小閉環已講清」提前收尾。中斷/時間盒結束寫 status: 學習中,下次從 resume.json 續。

碎片化執行約定(適配 5–15 分鐘短時窗 + 易打斷續接)

依據:微學習(microlearning)綜述 + 分散式練習/間隔效應(Cepeda 2006) + 任務中斷的恢復成本(Memory-for-Goals / resumption lag)。短時窗裡五步跑不完是常態,關鍵不是「步驟多」,而是每次重啓的恢復成本。

  • 微單元切片(每片≤一個短時窗能完成):
    • 快軌:整軌即一個微單元(5–10 分鐘),不切。
    • 標準軌:切 3 片——M1 點火(第 0 步立靶 + 0.5 步設問/初稿) → M2 模型+講(第 1 步視覺模型 + 2–3 步講/卡殼) → M3 驗證落盤(第 4–6 步)。
    • 深軌:M1/M2/M3 之外額外排 M4 隔天重講——把「隔天重講」正好落在 spacing 的間隔點上(一舉兩得)。
  • 斷點續學協議(治「恢復成本」):每個微單元結束或被打斷時,寫/更新 〔根目錄〕/_system/resume.json 的續學卡:
    {"concept":"Token","track":"標準軌","stage":"M2-視覺模型已認賬,卡在'為什麼BPE要合併高頻對'",
     "open_question":"BPE 合併的停止條件是什麼?","next_action":"回到第3步對'停止條件'做微輸入","ts":"2026-06-19T21:30"}
    
    下次觸發 gewu 時,第一句不是「學什麼」,而是先讀 resume.json 喚醒斷點:「上次你在 Token 卡在『BPE 停止條件』,3 分鐘續上?」——把恢復成本從「使用者自己回憶」壓到「AI 一句話喚醒」。概念 status: 已完成 後清掉它的續學卡。
    • 長間斷要補「大局喚醒」(治「我在整個領域走到哪了」):除了續單概念斷點,同時讀該大類的 _system/roadmap_data.json(learned/total/current/next3),給一句領域進度總覽。合起來喚醒例:「歡迎回來 👋 上次你在《Token》卡在『BPE 停止條件』。大局:這個領域你已完成 5/9,當前在《Context》,下一站推薦《Agent》。想 ① 續斷點,還是 ② 看路線圖大局?」跨周/跨多次的長間斷尤其別只續一個點——resume 只記一個概念的斷點,大局得靠 roadmap_data 補上,否則使用者回來會「不知道自己學到哪」。

第 0 步 · 立靶 & 定位

  1. 問使用者:要學的概念是什麼?歸到哪個大類(如 AI)?大類不存在就新建子資料夾。
  2. 一句話問「你現在對它的理解是什麼」,記錄為起點認知(用於結尾對比成長)。
  3. 掃描同大類已有概念,提示哪些可能與之相關(備用作雙鏈)。

第 0 步附 · 分診定軌

決定這個概念走哪條軌,避免小概念跑滿五步的冗餘。⚠ 純內部判定,絕不打給使用者:別把「分診三問/打分/合計 X 分/定為某軌」這套推理輸出到對話裡——AI 自己算完,直接按定軌結果走對應流程即可,使用者無感。

依據:認知負荷理論的元素互動度/冗餘效應/專長反轉——對元素互動度低的「薄」概念硬上全套五步,多數步驟會變成外在負荷。所以按概念型別分軌,而非對所有概念一刀切跑滿五步。

分診三問(各打分,合計定軌;已用真實概念校準,見下「打分要點」):

  1. 部件數:要講清它的機制/為什麼(不是一句話定義),需同時拎起幾個相互牽連的元素?≤1→0;2–3→1;≥4 或遞迴→2。
  2. 耦合度:它的直接前置裡,有幾個尚未完成?0–1 個→0;≥2 個→1。
  3. 轉化性 / 樞紐性:學懂它會反直覺地重寫你對該領域的已有理解(threshold concept)→2;或它是整合樞紐(≥3 個概念依賴它/在它處匯聚,深軌的「跨概念整合」正為它而設)→1;都不是→0。

定軌:合計 0–1 → 快軌;2–3 → 標準軌;≥4 或第 3 問得 2 → 深軌。邊界保守:拿不準向上取一軌(專長反轉的另一面是「新手缺支架更糟」)。

打分要點(校準所得,務必遵守,否則會系統性誤判):

  • 第 1 問按「機制」打分,不按「一句話定義」:很多概念定義只一句話(看著像快軌),但講清它的「為什麼」要多元權衡(如 Token 的子詞分詞要同時權衡「整詞表會OOV / 單字元序列太長 / 子詞折中 / 詞頻」=4 元)。漏掉這點會把真概念誤判進快軌。
  • 快軌是給真·原子事實的稀有泄壓閥,不是常態:成體系的領域裡概念多為「真概念」,快軌很少觸發。真正的快軌物件往往是被§「粒度下限」摺疊進父筆記的子事實(如「1 token≈4字元」「MCP=Model Context Protocol 縮寫」),它們根本不該單獨立概念。

相關技能