跟 AI 一起寫程式：從一份 CLAUDE.md 到 Skills 跟規範
2025 年初 AI 對我來說還是拿來問問題的工具，到了 2026 年幾乎所有程式都是 Claude Code 寫、我做 review。這一年多我經手的幾個專案，給 AI 的設定也一路演變：先是把所有東西塞進一份上千行的 CLAUDE.md，再把固定流程拆成 Skills，最後連領域知識、規格流程跟測試閘門都做進去。這篇整理這三個階段、每個階段的做法，還有為什麼會這樣改。
大貓的第一個家
歡迎來到我的部落格，這裡有我分享的技術筆記、生活點滴和旅遊見聞。
領域知識太重的案子：工程師怎麼邊做邊學
約 5 分鐘2026 年我大半年都在做一套給電力調度員練習跟考試用的模擬系統。它模擬的是變電所的圖控畫面，開關會動、電驛會跳、警報會叫，但一切都在軟體裡。技術架構很快就定了，真正難的是領域知識：規格書的文字跟實際系統對不上、每一條畫面規則背後都有電力的道理，工程師不懂就只能邊做邊學。這篇是這個案子的回顧，講我們怎麼從會議、錄影跟驗收回饋裡把領域知識一點一點補起來，還有下次再遇到這種案子我會怎麼做。
我這兩年在用的全端架構：monorepo、微服務與多租戶是怎麼組起來的
約 6 分鐘這兩年我參與的專案幾乎都長在同一套架構上，Next.js 前端、NestJS 的 API Gateway 跟微服務、以網域辨識租戶的多租戶設計，全部放在一個 monorepo 裡。這篇從一個請求的路徑開始，把整套架構怎麼組起來、每一層負責什麼、多租戶怎麼貫穿前後端整理一遍。後端跟基礎設施是同事設計的，我從前端的角度來寫。
冬季東京九天自由行
一月的東京九天自由行，從河口湖的富士山、三鷹的吉卜力美術館、迪士尼，到築地、淺草、原宿、澀谷這些經典路線，中間穿插了吉伊卡哇樂園、月島文字燒和各種超市採買。
2025 年度回顧
約 5 分鐘來記錄一下我在 2025 年發生的大小事情 🎉
來去電影院 2025
約 1 分鐘2025 年忙到沒記下每一部電影是哪一天看的，所以今年的觀影清單改成依台灣上映日期排序。
秋季釜山五天員工旅遊
這是我第一次去釜山，而且是跟著公司的員工旅遊一起去的。五天四夜從松島海上纜車、斜坡滑車、海東龍宮寺，玩到甘川洞文化村、海雲台搭船跟汗蒸幕，我很喜歡釜山這種靠海城市的氣氛。
把聊天室做成一個套件：Clouda 的前端架構與運作方式
約 7 分鐘Clouda（雲寶寶）是我做的一個 AI 聊天室小工具，裝進各個專案之後，畫面右下角會多一顆按鈕，點開就能跟 AI 對話。後端由同事負責，我做的是前端，包括怎麼用 React 跟 Shadow DOM 做成一個不會跟宿主打架的元件、用 Vite 打包成套件發佈到私有的 npm registry、用 data 屬性當設定介面，還有怎麼用 fetch 接 SSE 串流把回覆一個字一個字印出來。
一個人做專案，也要寫給下一個人看的文件
九月我把做了大半年的 EMS 前端交接給新同事。交接能順利，靠的不是最後一週惡補，而是從一個人做 Starter Kit 的時候就持續留下的東西：README、資料夾結構說明、架構圖、決策紀錄、Commit 規範、任務紀錄。這篇整理一個專案該留下哪些文件、各自是寫給誰看的，還有實際交接時怎麼用它們。
需求先講清楚：User Story 與驗收標準怎麼幫團隊少走冤枉路
約 5 分鐘2025 年我主要在開發一套能源管理系統（EMS）。半年多下來最有感的不是技術，而是「需求規劃」這件事：畫面改了兩三次、時程一度很趕，後來把需求確認的順序補起來，並引入 User Story 與驗收標準之後，整個團隊才開始順。這篇整理我們怎麼做，還有我從中學到的事。