iT邦幫忙

2026 iThome 鐵人賽

DAY 14
0

Day 14 封面:三塊指向不同方向的路牌,柱下散落寫不出字的紙條

昨天講了記憶的四層結構。今天講這套結構運轉幾週後暴露的問題:記過的東西查不到

症狀長這樣。某位隊友接到一件活,動手做,踩坑,花半小時爬出來。我在旁邊看著覺得眼熟,去翻流水帳——三週前另一位踩過一模一樣的坑,解法都寫著。

筆記在,坑照踩。等於沒記。

病因:寫的人跟查的人用的詞不一樣

複盤了幾次之後發現規律。

寫筆記的時候,你剛解完問題,腦子裡是答案的詞:「core.quotepath 設定」「clasp 部署權限」「SimpleMDE 的 setValue」。筆記標題和內文自然用這些詞。

查筆記的時候,你剛遇到問題,腦子裡是症狀的詞:「git 檔名變成一堆數字」「部署上去打不開」「打字進去沒反應」。

你拿症狀的詞去搜答案的詞,搜不到是正常的。知識都在,索引錯了。

解法:一張任務詞路由表

我們在操作手冊區的最上層放了一張路由表。每一列三個欄位:

・任務詞:含同義詞、症狀詞、工具詞——查的人腦子裡會有的那些詞
・去讀哪份手冊
・停手警語:動手前必須先做的那件事

重點全在第一欄。它是用「遇到問題的人會怎麼講」寫的,不是用「解完問題的人會怎麼分類」寫的。同一份手冊可以被五六個不同的詞命中,因為五六種症狀最後都通到它。

拿真實的一列當例子:

任務像是…(含同義詞/症狀詞) 先讀 ⚠️ 停手警語
裝/部署 Apps Script(GAS、clasp、Web App、授權、同意畫面、存取遭拒、403) runbook gas_deploy.md 同意畫面一定要勾「全選」——沒勾滿不報錯、執行記錄照樣說「已完成」,但資料不會落地

注意第一欄收了「存取遭拒」「403」這種症狀詞——出事的人腦子裡是錯誤訊息,不是「GAS 部署」這個分類。那句停手警語也有它自己的故事:它原本掛在一篇完全不相干的筆記尾巴,七天後另一個人裝 GAS,沒人想得到去翻那篇,同一個坑重踩一次,才被搬到這裡。

主指令規定:全隊動手前,先拿任務詞對這張表,命中就去讀,並照停手警語先做那件事。

配套規矩:踩到「查不到」,當場修索引

路由表不是建完就完了。真正讓它活著的是這條:

踩到「明明記過卻查不到」時,當場把那條搬到會被搜到的位置,改成任務詞、進路由表。別只在流水帳補一句。

「當場」兩個字是關鍵。此刻你同時擁有兩種詞,剛剛還在用症狀的詞找,現在也知道答案的詞。這是修索引的唯一好時機,過了這一刻,你又只剩下答案的詞了。

主指令裡那句評語我很喜歡:這比任何定期整理都有效。定期整理是憑想像猜「別人會怎麼查」,當場搬移是拿真實發生的一次「查不到」直接補洞。

搜尋是最後一道,不是第一道

路由表沒命中,才進全文搜尋;全文搜尋也沒有,才算新路徑,自己設計,並在回報時明講「未找到既有工具」。

把全文搜尋放最後是刻意的。搜尋看起來萬能,但它只在「你用的詞剛好在檔案裡」時有效,而這正是前面說的斷層所在。路由表是人工維護的橋,專門跨那道斷層。

還有一個工程細節值得記:在 Windows 上用搜尋工具,檔案篩選的寫法跟其他平台不一樣,寫錯會直接報路徑錯誤。這條也在路由表裡,連「怎麼搜」本身都是一條需要索引的知識。

明天講一個更尷尬的問題:筆記系統有兩套的時候,它們會打架。


上一篇
Day 13|記憶不是聊天紀錄
系列文
一個人的 AI 團隊:Claude Code 當組長,帶四家引擎做教學工作的實測與踩坑14
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言