我讓 AI 花一整天掃 codebase,找到 6 個 Dashboard 缺失的完整紀錄
上週我花了一整天,讓 Claude 透過 OctoDock 掃描整個 OctoDock 的 codebase,對照 Dashboard 的功能設計,找出哪些功能在後端寫好了但 Dashboard 還沒有介面。最後找到 6 個。
這篇你會看到
- 實際的 prompt 和 AI 回傳結果
- 怎麼讓 AI 理解「後端有但前端沒有」這種跨層問題
- 碰到的問題和處理方式
- 掃描結果怎麼自動寫到 Notion 變成待辦
為什麼要做這件事
OctoDock 的後端有很多 API endpoint,但 Dashboard 不一定每個都用到了。這種「後端做好了但前端還沒接」的情況很難用手動檢查發現,因為沒人會去一個一個比對。
實際操作過程
第一步,我讓 AI 讀後端的 route 檔案:
讀取 OctoDock repo 裡的 src/app/api 目錄,列出所有 API endpoint 和它們的功能。
第二步,讀 Dashboard 的前端頁面:
再讀取 src/app/dashboard 目錄,列出所有 Dashboard 頁面和它們呼叫的 API。
第三步,交叉比對:
比對後端 API 和 Dashboard 頁面,找出哪些 API 在後端已實作但 Dashboard 還沒有對應的介面。列成表格,包含:API 路徑、功能描述、建議的 Dashboard 位置。
第四步,寫入 Notion:
把找到的缺失建成 Notion 待辦頁面,每個缺失一個子頁面,包含 API 路徑、功能描述、建議實作方式。
碰到的問題
⚠️ GitHub 的 file API 一次只能讀一個檔案。codebase 有三十幾個 route 檔,AI 需要逐個讀,過程很慢(大約 20 分鐘)。如果 codebase 更大,可能需要分批。
⚠️ AI 有時會把「內部用的 utility API」也列為缺失。需要在 prompt 加「只看用戶面向的功能,忽略內部 helper」。
學到的事
💡 讓 AI 先建一個「後端 API 清單」再建一個「前端頁面清單」,最後做交叉比對,比一次要 AI 做完所有事情更準確。拆步驟是關鍵。
💡 把結果直接寫成 Notion 待辦很重要。如果只是貼在對話裡,很容易過幾天就忘了。
想試試嗎?
到 octo-dock.com 註冊,連結 GitHub 和 Notion。把你的 repo 和待辦頁面告訴 AI,一句 prompt 就能開始。