做 IT 維運的人都會寫筆記，現在還會讓 AI 代理幫忙記。但這幾次經驗讓我學到一件事：文件不是真相，實測才是。

三次卡關

紀錄上寫的 實際狀態 結果
某個自動化帳號已經設好免密碼的權限白名單 那個權限設定檔根本不存在 排程和手動操作全部卡住
某台實驗用虛擬機「初始設定還沒完成」 其實早就設定完、也登入過了 規劃的依據整個是錯的
舊筆記：遠端控制虛擬機時「鍵盤可以用、滑鼠不行」 換了環境之後剛好相反 照抄舊結論，卡了好一陣子

這三次都不是有人故意寫錯。是環境變了——重建過、升級過、換了版本——但紀錄沒跟著變。AI 代理更麻煩：它會很有自信地照著記憶檔裡的過時資訊去做。

我現在的做法

  • 權限或關鍵設定改完，立刻跑一個驗證指令：例如改完權限，就馬上用那個帳號實際執行一次，而不是只看設定檔。
  • 常用的連線建一份定期檢查清單：例如各台主機的遠端登入、NAS 的連線，定期跑一次。
  • 每份紀錄加上「最後驗證日期」：超過一段時間沒驗證的，就當成「待確認」，不當成事實。
  • 環境重建或升級後，舊筆記一律當成假設：重新測過再用。
  • 知識庫設定過期提醒：我的筆記庫會把超過 180 天沒更新的頁面標成「可能過時」。

小結

寫筆記的目的是讓下一次更快，但前提是筆記是對的。紀錄寫的是「當時的狀態」，不是「現在的狀態」。關鍵的事，永遠用一個指令重新確認一次。

資料來源

  • 本人 IT 維運紀錄與知識庫整理（2026-08）

封面圖由 AI 生成。