Engineer

vault 的 CLAUDE.md、16 個 skill、navi 與 hooks 累積了一個月，換到新模型後沒有人檢查它們還合不合用。這篇記錄 /claude-doctor 的設計：為什麼內建的 /doctor 不夠、為什麼每次稽核前都先做一輪研究、換模型的提醒為什麼從 hook 搬到 navi 狀態列、又為什麼不必每 30 秒檢查一次。支線是第一輪稽核的結果：CLAUDE.md 從 251 行瘦到 179 行，10 個 skill 的強調標記從 476 個降到 41 個。也記錄稽核腳本把 glob 當成粗體、以及 subagent 回報的問題本身判斷錯的兩個坑。

Day19 定下的「每趟旅行是一個單一的 HTML」，用起來最困擾的是按上一頁就直接回總覽。這篇記錄把它翻掉的過程：為什麼光拆檔案沒用、要每個畫面都有網址；單一外殼加

指南升成主角之後，我拿手機實際用了一輪，丟給 Claude 一串體驗問題，第一條就是收回 Day21 做的「往下收、往上露」：「那個好卡，用一層就好了」。記錄這輪 UI 調整的取捨：固定哪一層（Claude 建議只固定頁首，我選頁首加日期列）、「← 總覽」收進選單還是整個拿掉、地區篩選要不要改下拉選單（地區要、類別不要），以及計畫被我退回六次、每次補了什麼。踩到的坑是為了壓低日期列把日期排成一行，最後一顆按鈕超出畫面 13px、整頁可以左右滑；之後「手機不能左右滑」寫成專案的硬規定，改版面前要在四種寬度量過。另外自動部署停住，改成手動部署。

旅行頁原本以「回來後的紀錄」為主，行前指南只是一個原樣保留的內嵌分頁；實際用下來我只看指南。這次的目標是四件事：少切頁面、打開就是當天的建議行程、旅途中記下去了哪就同步回指南（之後找店先列還沒去的，回來後的整理也直接在上面做）、頁首講清楚還剩幾天。記錄的取捨有：指南的分項攤平成頁首導覽、手機用漢堡選單（下拉選單被我否決），地點總表併進指南、新店只能加在清單尾端，頁首日期併進原本那一列、改成時間軸；另外用地址補座標的腳本把每家店畫進示意圖，太遠或沒座標的用虛線圈。踩到的坑有：合併時一刀切掉一個函式導致整頁空白、記住的舊分頁讓預設頁失效、平滑捲動讓切分項看起來沒反應、手機上一列塞不下日期、只靠店名幾乎查不到座標。

手機看行前指南時，頂部疊了三層固定列、約 190px。記錄為什麼選「往下滑收起」而不是壓縮高度、往上滑時再分兩段（滑一點只露出日期列，滑多才全部回來），為此破例改了說好原樣保留的指南樣式，以及讓收起不惱人的幾條規則：靠近頂端一定顯示、小於 8px 不判斷、捲到底的回彈不算往上滑、看不見的列鍵盤也碰不到。另一條線是地點總表的「吃」加上子分類與篩選按鈕：選項太少時 AI 可以上網補，但來源不明是隱憂，所以我改成自己丟資料給 Claude、由它查證與統整。

/projects/ 的卡片明明寫了 aspect-ratio，Art-Tracking 還是被一張直式截圖撐到 985px：封面是 column flex 的子項目，圖片的 height 100% 對不到確定的高度，修法是把圖片改成絕對定位。另外記錄封面比例選 4:3、手動 weight 排序、Archived 分區、自動連到最新一篇開發紀錄、為了漢堡選單複製一份 PaperMod header，以及上線後第二輪把小卡精簡、封面從截圖換成 icon。坑包括只讀 CSS 就誤判、漏一行 project 讓最新一篇指錯、背景分頁量到 0×0、拿掉一層包裝後標題被主題蓋成 24px。

新專案 travel-storage：跟 Claude 一起排行程，每趟旅行做成一個自含式 HTML，放成一個私人網站。這篇記錄旅行頁怎麼設計成「一頁走完一趟旅行」：模板照行前指南還是回來後的全紀錄、行程項目用 done/plan/skip 等狀態從計畫走到實際、行前指南原樣內嵌而不是拆掉重寫、總覽頁對還沒結束的旅行只給出發日期（網址也不帶地名）、旅途中「先在對話回選項，挑了才寫進頁面」的更新流程，以及離線快取的代價。

用 git 同步 vault 十天後的四個觀察：log 和 TODO 這種每個動作都會碰的檔一直衝突、手機能互動很實用、本機所有 session 都踩在 main 上互相卡住、GitHub 網頁可以直接當閱讀介面。今天一次 push 被另一個 session 沒 commit 的變更擋下來，於是把「每個 session 都開 worktree、不分任務大小」寫成規則，並用 SessionStart 與 PreToolUse 兩層 hook 擋住在主目錄寫檔。記錄過程中的取捨（為什麼不是看情況才開、為什麼保留 Obsidian 自動 pull、規則之外要不要用 hook 硬擋、收件重複要查 git 歷史還是另記一本帳、過期的決策檔怎麼刪），四個坑（hook 擋到自己要寫的另一個 repo、剛開的 worktree 被判成可清、log 同一個 hunk 混著兩個 session 的條目、在 worktree 裡長指令被拒），以及接下來要觀察的九件事。

Day11 列過 llm-wiki 的 15 個 skill，但只有名字、一句話用途和行數。今天附上 inbox-triage、wiki-query、wiki-build、note-enrich、note-explore、vault-maintain 的範本，拿掉個人資訊和我這個 vault 特有的部分。每個 skill 附上什麼時候用、自己客製化時要注意哪幾條。把 llm-wiki 看成一台引擎：wiki-build 是核心，inbox-triage 負責加燃料，wiki-query 產出答案，vault-maintain 定期檢修，note-enrich 和 note-explore 分別顧思考的廣度與深度。另外說明其他 skill 為什麼不放，以及一個容易誤解的地方：這六個不是各自獨立的指令，它們共用 index.md、log、TODO.md 幾個慣例，也會互相呼叫。

拿一份附了檔案位置與 diff 的設計 handoff 修部落格，照做前先驗證，發現三處跟實際不符：layouts/blogs/list.html 會套到所有分類頁、水平捲動掃了 121 頁都重現不出來、閱讀時間到不了預期的 5–7 分鐘。另外記錄上一篇／下一篇怎麼定義「同分類」、Series 總覽頁怎麼做到英文網址配中文名稱，以及三個坑：Claude 把截圖時機誤判成 overflow 弄壞 image-zoom、html/template 把 var() 預設值轉成 ZgotmplZ、全站連結色的優先權把實心按鈕的字蓋成深色，而對比掃描用 3:1 當門檻漏抓了一顆。