
昨天講了記憶的四層結構。今天講這套結構運轉幾週後暴露的問題:記過的東西查不到。
症狀長這樣。某位隊友接到一件活,動手做,踩坑,花半小時爬出來。我在旁邊看著覺得眼熟,去翻流水帳——三週前另一位踩過一模一樣的坑,解法都寫著。
筆記在,坑照踩。等於沒記。
複盤了幾次之後發現規律。
寫筆記的時候,你剛解完問題,腦子裡是答案的詞:「core.quotepath 設定」「clasp 部署權限」「SimpleMDE 的 setValue」。筆記標題和內文自然用這些詞。
查筆記的時候,你剛遇到問題,腦子裡是症狀的詞:「git 檔名變成一堆數字」「部署上去打不開」「打字進去沒反應」。
你拿症狀的詞去搜答案的詞,搜不到是正常的。知識都在,索引錯了。
我們在操作手冊區的最上層放了一張路由表。每一列三個欄位:
・任務詞:含同義詞、症狀詞、工具詞——查的人腦子裡會有的那些詞
・去讀哪份手冊
・停手警語:動手前必須先做的那件事
重點全在第一欄。它是用「遇到問題的人會怎麼講」寫的,不是用「解完問題的人會怎麼分類」寫的。同一份手冊可以被五六個不同的詞命中,因為五六種症狀最後都通到它。
拿真實的一列當例子:
| 任務像是…(含同義詞/症狀詞) | 先讀 | ⚠️ 停手警語 |
|---|---|---|
| 裝/部署 Apps Script(GAS、clasp、Web App、授權、同意畫面、存取遭拒、403) | runbook gas_deploy.md |
同意畫面一定要勾「全選」——沒勾滿不報錯、執行記錄照樣說「已完成」,但資料不會落地 |
注意第一欄收了「存取遭拒」「403」這種症狀詞——出事的人腦子裡是錯誤訊息,不是「GAS 部署」這個分類。那句停手警語也有它自己的故事:它原本掛在一篇完全不相干的筆記尾巴,七天後另一個人裝 GAS,沒人想得到去翻那篇,同一個坑重踩一次,才被搬到這裡。
主指令規定:全隊動手前,先拿任務詞對這張表,命中就去讀,並照停手警語先做那件事。
路由表不是建完就完了。真正讓它活著的是這條:
踩到「明明記過卻查不到」時,當場把那條搬到會被搜到的位置,改成任務詞、進路由表。別只在流水帳補一句。
「當場」兩個字是關鍵。此刻你同時擁有兩種詞,剛剛還在用症狀的詞找,現在也知道答案的詞。這是修索引的唯一好時機,過了這一刻,你又只剩下答案的詞了。
主指令裡那句評語我很喜歡:這比任何定期整理都有效。定期整理是憑想像猜「別人會怎麼查」,當場搬移是拿真實發生的一次「查不到」直接補洞。
路由表沒命中,才進全文搜尋;全文搜尋也沒有,才算新路徑,自己設計,並在回報時明講「未找到既有工具」。
把全文搜尋放最後是刻意的。搜尋看起來萬能,但它只在「你用的詞剛好在檔案裡」時有效,而這正是前面說的斷層所在。路由表是人工維護的橋,專門跨那道斷層。
還有一個工程細節值得記:在 Windows 上用搜尋工具,檔案篩選的寫法跟其他平台不一樣,寫錯會直接報路徑錯誤。這條也在路由表裡,連「怎麼搜」本身都是一條需要索引的知識。
明天講一個更尷尬的問題:筆記系統有兩套的時候,它們會打架。