第二大腦當 Onboarding 資產：用索引筆記當地圖

第二大腦當 Onboarding 資產：用索引筆記當地圖 新人來三個月了。 「結帳的折扣到底怎麼算？」「這個欄位為什麼要這樣驗？」「上次有個類似的 case，在哪裡？」 你知道答案。你也知道答案在哪：業務規則筆記、case 庫、上個月剛整理出來的啟發清單，全部都在系統裡。但你每次還是得停下來，帶著新人走一遍：「你點這裡，找到結帳模組，再進去這個頁面，對，就是這個……」 三個月下來，你變成了人肉索引。 有知識，不等於知識可以被找到 蒐集了、組織了、做了可重用的零件、連上了業務規則、把 bug 整理成啟發。這樣的知識系統，對熟悉它的人來說確實好用。但對剛進來的新人，幾百條筆記跟一片森林沒兩樣：東西都在，但沒有路。 他不知道要從哪裡進，也不知道這個系統的結構長什麼樣：模組怎麼分、哪些規則是核心、哪裡藏著歷史血淚。他有的只是一個搜尋框，和滿滿的不知道要搜什麼。 索引筆記：只負責指路，不負責塞內容 解法是做一種特別的筆記：它本身不放內容，只放通往內容的入口。 這種筆記以一個模組為單位。結帳就做一張結帳的，會員就做一張會員的。上面不放詳細規格，放的是「這個模組你該知道什麼」的導覽：這是什麼、核心規則在哪裡、最容易踩到的坑是哪些、主要 case 在哪裡找、相關的文件和人是誰。每一條都是連到底層筆記的入口，新人點進去，才是真正的內容。 地圖本身保持輕薄，只告訴人底層筆記在哪、為什麼要去看。 這樣新人就不用從幾百條 case 裡亂翻了。他從地圖進，順著入口往下走：先看這個模組是幹嘛的，然後看哪幾條規則最重要，再看歷史上踩過哪些雷，最後找到對應的 case。走得快不快看個人，至少不會迷路。 一張好地圖，長什麼樣 一張好用的地圖，就是五個入口的清單。 以「結帳」模組為例，地圖上的五個入口： 這個模組是什麼。 一兩句話說清楚這個模組做什麼、在系統裡的角色。讓新人不用再問「這是幹嘛的」。 核心業務規則。 列出這個模組最重要的規則，每條連到對應的規則筆記。規則不用抄過來，讓人知道哪幾條最關鍵、去哪裡看細節就好。 歷史血淚。 這個模組踩過哪些坑、修過哪些重要 bug，連到整理出來的啟發清單。這是新人最不可能靠自己挖到的部分，也是口頭帶最容易漏掉的部分。 主要測試流程與核心 case。 基本的測試路徑是什麼、最代表性的 case 在哪裡。讓新人知道要測什麼、從哪裡開始看。 相關的人與文件。 這個模組的 PM 是誰、spec 在哪裡、有問題要找誰。讓新人不用再問「這個找誰」。 五個入口，一張地圖，可能就二三十行。內容留在底層筆記，地圖保持精簡、好掃。 地圖是 Onboarding 的最短路徑 新人 onboarding 要建立的，是一張腦中的地圖：系統有哪些模組、各自的重點在哪、雷藏在哪。 與其口頭帶三個月，不如給他幾張地圖讓他自己走。 給了地圖之後，他的問題會變：從「有空問你」，變成「我看了地圖，這裡有個地方不懂」。你從人肉索引變回答疑的人，回答的問題從基礎業務邏輯，變成真正需要判斷和經驗的問題。 而且地圖可以重複使用。這次做好了，下一個新人直接給，不用重來。每帶一個新人，就修一次地圖，哪個入口缺、哪個說明不夠清楚，現場就能發現。地圖越帶越準。 新人也可以自己主動調查陌生產品，那套方法跟地圖剛好互補：地圖是你給的路，主動調查是他自己走路的方法。 老手也需要地圖 不只新人，輪調到不熟模組的老手、很久沒碰某功能要回去測的人，一樣需要地圖。 三個月沒碰結帳的人，跟新人面對同一個問題：不記得規則在哪、忘了上次有哪些雷。有了地圖，十分鐘能重建基本認識；沒有地圖，得翻 Slack 記錄、找舊的 case、或者再去問同事。 地圖是整個第二大腦的目錄頁。新人靠它入門，老手靠它快速回到狀態。 怎麼開始 我把知識庫分享給同事的時候，卡最久的地方之一是他不知道要補什麼。知識庫是開的，但什麼值得寫回來、要寫成什麼樣子，沒人教就不知道從哪裡下手。有了地圖，至少哪一格還空著，一眼就看得到。 不用一次做完所有模組的地圖。從新人最常問的那一兩個模組先做。 做地圖的最好時機，就是「你正在跟新人解釋這個模組」的當下。你口頭講的那套，這是什麼、規則在哪、以前踩過什麼，邊講邊記下來，講完地圖也好了。這不算額外的文件工作，只是把本來就會講的東西順手整理下來。 下次新人再問，直接給地圖。 下一篇：知識建起來了，也能導覽了，但測試計畫和報告還是每次臨時拼。怎麼讓第二大腦的知識輸出成可用的東西，計畫和報告從零件組起來，不用每次重寫？