iT邦幫忙

鐵人檔案

2026 iThome 鐵人賽
回列表
Software Development

AI 時代的 Clean Code:30 天讓 AI 產出的程式碼可讀、可驗證、可維護 系列

本系列從《無瑕的程式碼 第二版》出發,結合 Uncle Bob 的 AI 觀點與我的 AI Coding 經驗,重新思考 Clean Code 在 AI 時代的價值,並延伸出我建立的 CLEAN 五原則:C 掌握真實情境、L 限制變更範圍、E 說清楚意圖與邊界、A 留下可審查實據、N 守住可預期行為。透過真實 API 專案與 Codex 實驗,分享開發者如何駕馭 AI Agent,持續產出可讀、可維護、可驗證的程式碼。

參賽天數 18 天 | 共 27 篇文章 | 0 人訂閱 訂閱系列文 RSS系列文
DAY 1

Day 1|第三個參賽系列:我為什麼還想寫 AI 時代的 Clean Code?

Day 1|第三個參賽系列:我為什麼還想寫 AI 時代的 Clean Code? 安安~我是ChiYu~ 前兩個 iThome 鐵人賽系列,我從七月就開始準備;...

2026-09-01 ‧ 由 ChiYu 小艾 分享
DAY 2

Day 2|叫 AI 清理程式碼,為什麼常只清到表面?

Day 3|CLEAN 五原則:如何掌握 AI Coding 的情境、範圍、意圖、證據與行為? 安安~我是ChiYu~ 昨天的 Agent 很有把握地寫下:...

2026-09-02 ‧ 由 ChiYu 小艾 分享
DAY 3

Day 3|CLEAN 五原則:如何掌握 AI Coding 的情境、範圍、意圖、證據與行為?

Day 3|CLEAN 五原則:如何掌握 AI Coding 的情境、範圍、意圖、證據與行為? 安安~我是ChiYu~ 昨天的 Agent 很有把握地寫下:...

2026-09-03 ‧ 由 ChiYu 小艾 分享
DAY 4

Day 4|AI 把函式拆小就算 Clean Code 嗎?從小、命名、組織與順序檢查重構結果

Day 4|AI 把函式拆小就算 Clean Code 嗎?從小、命名、組織與順序檢查重構結果 安安~我是ChiYu~ 同一段四十多行的 Controller...

2026-09-04 ‧ 由 ChiYu 小艾 分享
DAY 5

Day 5|AI 取的名稱格式正確,為什麼還是可能誤解程式意圖?

安安~我是ChiYu~ 昨天,我把逾期處理中的單筆流程抽成一個私有方法: var processingResult = await ProcessOverdue...

2026-09-05 ‧ 由 ChiYu 小艾 分享
DAY 6

Day 6|註解與格式都漂亮,程式碼為什麼還是難讀?

安安~我是ChiYu~ 昨天,我們把 Work Item 逾期流程的命名規則寫進 Repository,讓 Agent 可以在安全範圍內自主命名。 名稱說清楚之...

2026-09-06 ‧ 由 ChiYu 小艾 分享
DAY 7

Day 7|AI 把函式拆得越小,就越符合 Clean Code 嗎?三種拆分方式實測

安安~我是ChiYu~ 昨天,我們替 Work Item 逾期流程保留兩則有測試依據的警告註解,也確認 Formatter 只能整理已設定的格式規則。 註解沒有...

2026-09-07 ‧ 由 ChiYu 小艾 分享
DAY 8

Day 8|同一項需求交給下一個 AI Agent,三種函式結構會走出哪條修改路徑?

安安~我是ChiYu~ 昨天,我從三份函式拆分結果中選了 Stepdown 版本。 ProcessOverdue 現在可以由上而下讀成四個步驟:找出逾期候選、逐...

2026-09-08 ‧ 由 ChiYu 小艾 分享
DAY 9

Day 9|AI Agent 一次重寫或分段 Commit:哪個容易還原,哪個完成後更好讀?

安安~我是ChiYu~ 昨天,我把同一項需求交給三種函式結構,觀察全新 Agent 會如何理解資料、又會把修改放在哪裡。我最後採用 CQS,但那只回答了資料目前...

2026-09-09 ‧ 由 ChiYu 小艾 分享
DAY 10

Day 10|WorkItem 要公開資料還是封裝行為?用新增業務種類與新增操作比較三種模型

安安~我是ChiYu~ 昨天我比較了一次重寫與分段 Commit,最後保留可以逐步驗證、失敗時局部還原的清理節奏。函式內部整理完後,我接著往物件邊界看,Work...

2026-09-10 ‧ 由 ChiYu 小艾 分享