前言：這個系列最後留下什麼？我對 AI 協作、專案理解與維護有什麼新看法？

前一天整理完 RoomRush 可能的技術債，我和 Agent 討論了這些問題可能的影響，以及如果未來要修改可能會有哪些風險。經過這次和 Hermes 一起重讀整份專案後，我對專案開發更有概念，未來也會更加謹慎處理可能的 Bug。

今天我們會進入這系列的尾聲，我會回顧這系列我和 Hermes Agent 協作的心得，與重讀整份專案的感想，未來如果要維護這專案，我也會思考自己要從哪裡下手才不會太混亂。

和 Hermes Agent 協作後，我的收穫

這是我第一次使用 Hermes Agent 協助自己重新理解一份完整的專案。比起自己一個檔案一個檔案慢慢翻，Agent 確實幫我節省了不少時間。

我可以直接把專案檔案交給 Agent，告訴它我目前想了解的方向，再透過來回討論確認細節。從資料流、畫面流程，到各個架構元件負責的事情，都可以逐步整理出來。

但這次的經驗也讓我發現，AI Agent 可以幫忙加快理解專案的過程，卻不能直接代替自己理解專案。

如果只是把程式碼丟給 Agent，然後直接接受它整理出的結果，我可能只會得到一份看起來很完整的筆記；真正重要的是，在閱讀 Agent 的分析時，自己也要去確認它說的內容，並且理解這些程式碼為什麼會這樣運作。

重讀整份專案後，我學到什麼

重新把 RoomRush 從頭到尾看過一次後，我最大的感受是：「能夠把專案做出來」和「真正理解自己做了什麼」，其實是兩件不同的事情。

當初開發 RoomRush 時，我比較在意的是功能能不能正常運作。但這次重新閱讀程式碼後，我開始注意到以前沒有想過的事情，例如資料是怎麼流動的、不同檔案之間是怎麼互相配合的，以及某些設計如果未來要修改，可能會牽動到哪些地方。

這也是我在整理技術債時感受最深的地方：
有些問題在 App 正常運作的時候其實不容易發現，但當我真的把每個檔案拆開來看，就會開始注意到重複的邏輯、命名不一致、未使用的檔案，以及一些可能造成維護風險的設計。
這些事情如果只是停留在「Vibe Coding，先讓功能跑起來」的階段，很容易被忽略。

另外，我發現這次整理出的許多維護問題，都集中在「管理者功能線」中。這也讓我開始注意到，管理者功能除了需要考慮正常的功能流程之外，也需要特別注意權限控管與安全性。
有些看起來很小的問題，如果沒有妥善處理，可能會進一步造成資料被錯誤修改，甚至產生資安上的風險。這讓我了解到，一個功能能夠正常運作，並不代表它已經具備完善的安全性。

也因為這次重新閱讀專案，我開始發現自己對後端與安全性相關的知識還不夠，因此未來也希望能再補強這方面的學習。

未來如果要維護 RoomRush

如果未來真的要重新整理 RoomRush，我不會直接從「大改架構」開始。

我會先處理比較明確、也比較容易確認影響範圍的問題，例如補齊安全性檢查、整理重複的邏輯、統一命名方式，以及刪除已經沒有使用的檔案。

在確認這些問題之後，再進一步思考哪些地方真的需要重構。

因為這次重新閱讀專案後，我也開始意識到，維護舊專案最重要的事情之一，不一定是馬上把它改得更漂亮，而是先知道自己改動的地方會影響什麼。

如果連原本的資料流和程式架構都還沒有弄清楚，就直接開始重構，反而可能讓原本可以運作的功能出現新的問題。

展示與成果

雖然這 30 天我沒有真的大幅修改 RoomRush，但我覺得這次重新理解專案本身，就已經是一種成果。

因為以前的我比較像是「做出了一個可以使用的 App」，而現在的我至少可以開始回答：

• 這個資料是從哪裡來的？
• 它經過哪些地方？
• 哪個檔案負責處理什麼事情？
• 如果今天要修改這個功能，可能會影響哪些地方？
• 哪些地方現在雖然可以運作，但未來可能會成為維護上的問題？

GitHub：
https://github.com/liu-yu1028/EmptyRoomFinder

線上操作：
https://appetize.io/app/b_bbqvft556jil3taiseo4xy2hve?device=pixel7&osVersion=13.0&toolbar=true

當初的專案我留在這裡，也歡迎讀者指點，未來有機會我會再延伸發展。

結論

30 天前，我原本只是想重新認識自己以前寫過的 RoomRush，順便嘗試看看 AI Agent 到底能不能幫助我理解一份已經完成的專案。一路做到最後，我發現這其實不只是一次「使用 AI Agent 整理程式碼」的實驗。

從一開始只知道 App 可以跑，到後來開始理解資料流、畫面流程、架構，再到最後整理出技術債和未來可能的維護方向，我重新看了一次自己曾經做過的專案。
這也讓我開始理解，一個專案真正完成，可能不只是「功能可以運作」而已。

當我們開始思考它的架構、可讀性、維護性，以及未來如果需要修改會發生什麼事情時，才會真正開始理解這個專案。

而 AI Agent 對我來說，最大的價值也不只是「幫我寫程式」，它更像是一個可以一起討論專案的工具。
我可以讓它幫我快速整理大量程式碼，再由自己去確認、提問、修正，最後把原本看起來很陌生的程式碼，慢慢變成自己能夠理解的東西。

這次的 30 天，我沒有把 RoomRush 改造成一個全新的專案，但我重新認識了這個自己曾經做過的專案：從「讓它跑起來」，到「開始看懂它」。
這大概就是這 30 天，我從 RoomRush 身上得到最大的收穫。