前言:「你們現在也有一堆沒人敢刪的 lint 規則吧?」 這是一句很難反駁的質疑,也是這個系列該正面回答的問題。前面用了好幾天篇幅講「把期待寫成可執行規則」——...
前言:我曾經也覺得「多寫一點防禦性程式碼比較安全」 這篇不打算再講案例數字,想單純誠實地講一段自己的心路歷程。因為如果不誠實面對自己曾經站在哪一邊,這整個系列講...
前言:「照著規則做,就不會過度設計了吧?」 如果前面 24 天讓你覺得「只要把複雜度預算、架構測試這些機制都建好,過度設計問題就解決了」,今天這篇要來澆一盆冷水...
前言:「你的案例太簡單了,複雜系統不適用吧?」 這是這個系列最容易被挑戰的一句話。前面 23 天,我一直拿一個只有 4 條業務規則的新聞發佈系統當案例——標題不...
一張付款流程的 PR,CI 綠燈、Copilot review 留了幾則意見,工程師處理完便合併。過幾天,另一張 PR 修掉它留下的錯誤。前一張在週報裡算「已完...
前言:「所以到底 Code Review 該由誰做?」 這是第三部的最後一篇,也是這系列問到現在最直接的一個問題:如果程式碼是 AI 產生的、規則是架構測試在驗...
前言:「複雜度預算不就是事後補救嗎?」 昨天講完複雜度預算,可能有讀者已經在心裡吐槽:這套機制還是「等 AI 寫完,我再去檢查改了幾個檔案」,本質上還是事後補救...
前言:「這個 PR 改了 11 個檔案,很多嗎?」 如果你把一個「文章加一個分類欄位」的需求丟給團隊,PR 開回來改了 11 個檔案,你會核准嗎?大部分 rev...
前言:「這些規則我早就跟團隊講過了,為什麼還是沒用?」 「依賴要往內指,不能反向依賴」「不要為了假設性的需求先建抽象層」——這些話,只要當過幾年 tech le...
前言:「這系列講了 16 天問題,到底什麼時候要講解法?」 如果你從 Day 1 一路看到這裡,大概已經受夠「過度設計有多可怕」這件事了——745 個檔案、21...
前言:「這段程式碼沒有 bug,review 過關,問題在哪?」 Day 11-13 拆解的三個案例(空的 UnitOfWork、假的重試、死碼 DTO),都有...
前言:「測試都綠燈了,還要吵什麼設計問題?」 這句話幾乎是每個團隊在 code review 時都會遇到的攔阻論點:PR 附上了測試報告,10 個測試全部通過,...
開發到第五天後半,CC 叫我去刷卡,說是要開通 Apple 開發者帳號,才能讓其他朋友用 TestFlight 測試。 開發者帳號要年費我知道,iOS 的 A...
前言:如果 AI 幫你寫完了一切,你還剩下什麼工作? 「issue 分類交給 AI、PR review 有清單幫忙、bug 定位 AI 先查、文件 AI 順手修...
前言:AI 一眼就能看出這個人「程度好不好」,但這句話該不該說出口? 「這個 PR 一看就是新手寫的,AI 幫忙先篩一輪,程度太差的直接退回去,維護者只看篩過的...
前言:「業務邏輯這麼簡單,隨便寫都差不多吧?」 看到「新聞發佈系統」這幾個字,你腦中浮現的畫面可能是:一個 Article 資料表、幾個 CRUD API,隨便...
前言:讓 AI 審查 AI,是不是找了個裁判自己吹哨? 「讓另一個 AI agent 來 review 剛剛那個 AI agent 寫的程式碼,這樣真的有用嗎?...
前言:「多找幾個人 review 不就好了?」 這是很多團隊面對「AI 產出太快、review 跟不上」這個問題時的第一個直覺解法:加派人手、要求更仔細的 re...
前言:能動、測試也過,問題到底藏在哪 昨天講完為什麼架構審查需要獨立設計,今天用一個具體案例,把「一般 code review 看不出問題、架構審查一查就抓到」...
前言:「感覺寫得太複雜」不是一個可以放進 checklist 的標準 前幾天講了本質複雜度跟意外複雜度的區別,但這種區分方式有一個實務上的問題:它終究要靠「感覺...
前言:這段程式碼「看起來」沒問題,就代表真的沒問題嗎? 「這個 PR 的程式碼邏輯清楚、測試也補齊了,AI 說可以合併,那應該沒問題吧?」 PHPUnit &a...
前言:規則寫進文件那天,它最有效 「這條規則我已經寫進 CLAUDE.md 了,AI 應該會一直遵守吧?」 如果你也這樣想過,先別急著放心。昨天講到架構規則要盡...
前言:「CI 全綠,還要 review 什麼?」 這句話幾乎是每個團隊都講過的話。測試涵蓋了主要情境、CI 顯示全綠、PR 描述寫得清清楚楚——這時候要求「再花...
前言:「我需求講得很清楚啊,AI 亂加東西干我什麼事」 這是很多人第一次看到 AI 生出的過度設計程式碼時的直覺反應:明明只交代了一句話,AI 卻自己加了一堆...
前言:「反正有 AI,程式碼多寫一點也沒關係吧?」 這句話你大概率聽過,甚至自己講過。邏輯聽起來很合理:以前工程師手動寫程式碼很貴,一行都要斤斤計較;現在 AI...
前言:明明只是修一個小功能,為什麼牽連了另一個模組? 「我只是想讓訂單頁面多顯示一個欄位,AI 怎麼會改到用戶模組的程式碼?」 這是進入第二部後我想先處理的問題...
AI reviewer 說「Approve」,PR 旁邊亮起綠色勾勾。這一刻很容易讓人誤以為工作少了一份:既然機器看過,required approval 也湊...
前言:外部貢獻者的 PR,跟自己寫的 PR,能用同一套審查邏輯嗎? 「反正 AI review code 就是看程式碼寫得對不對,誰送的 PR 應該都一樣吧?」...
模組二|敘事規格化(Day 5–9) 《矽墟》是我正在寫的一部科幻小說,拆成 200 回短篇連載,整部作品用管軟體專案的方式在管:敘事結構寫成規格檔,成品用...
你看不到 agent 腦中怎麼想。 但你看得到它留下來的 diff。 這件事聽起來很廢話,卻是很多 coding agent review 討論最常跳過的一步。...