Beginner
5 minutes
How to 理解大型程式碼庫 with Eigent
追蹤請求流程、梳理陌生模組,並快速找到正確檔案—— 在你進行第一次修改之前。
What you need
- Eigent 桌面應用程式
- 程式碼庫存取權(本機或已連線的 repo)
Best for
- 正在熟悉 repo 或服務的新工程師
- 任何想在修改功能前先了解其運作方式的人
- 在參與專案前審查新程式碼庫的技術主管
Starter Prompt
解釋請求在程式碼庫中的 [系統區域名稱] 之間是如何流動的。 請包含: - 哪些模組負責哪些部分 - 資料在哪裡被驗證 - 在進行修改前需要特別注意的主要陷阱 最後列出我接下來應該閱讀的檔案。
運作方式
- 將你想理解的相關檔案、目錄或功能區域提供給 Eigent。
- 要求它追蹤請求流程,並說明哪些模組負責業務邏輯、傳輸、持久化或 UI。
- 在你修改任何內容之前,詢問驗證、副作用或狀態轉換發生在哪裡。
- 最後詢問你接下來應該閱讀哪些檔案,以及哪些地方風險較高。
其他可試的提示
- 哪個模組負責真正的業務邏輯,而不是傳輸層或 UI 層?
- 驗證發生在哪裡?那裡強制了哪些假設?
- 如果我修改這個流程,哪些相關檔案或背景工作很容易被漏掉?
- 修改這個區域後,我應該執行哪些測試或檢查?
- 先給我這個 repo 的高層地圖,再帶我深入了解。
如何使用
在已連線程式碼庫的情況下開啟 Eigent。若你是新手,先用較大的範圍開始(例如「先給我這個 repo 的高層地圖」),再縮小到你需要修改的特定區域。你越能明確界定請求範圍——例如功能名稱、目錄、請求路徑——得到的說明就會越具體。持續追問,直到說明具體到足以讓你放心進行第一次修改。
預期輸出
一份具體的模組地圖,清楚標示哪些程式碼負責哪些部分;一份追蹤後的請求流程;關鍵驗證檢查點;容易出錯或很容易被忽略的區域清單;以及在修改前應先閱讀的下一批檔案清單。
限制
- 最適合將請求範圍縮小到特定區域,而不是一次詢問整個 repo。
- 非常大型的 monorepo 最好先縮小到單一服務或套件。
- Eigent 只會讀取已連線程式碼庫中的內容——它無法推論尚未觀察到的執行期行為。