Claude Code 完成了任務,摘要說功能已經實作,你卻還說不清楚行為改在哪裡。在 Yenpo 中開啟它實際修改的本機專案,從 diff 開始,把摘要沒交代的呼叫與分支讀清楚,再決定下一步。
準備本機 Git 儲存庫和 macOS 版 Yenpo。瀏覽程式碼和差異不需要模型連線,想請 AI Reader 協助時再設定即可。
1. 先確認這一輪的改動範圍
開始前,在 Claude Code 要編輯的目錄執行以下唯讀指令:
git rev-parse --show-toplevel
git rev-parse HEAD
git status --short
記下起始提交 ID、既有修改和未追蹤檔案。起始工作目錄乾淨時,比較容易判斷後續差異的歸屬。若已有尚未完成的工作,保留內容,並用平常的審查工具記錄起始版本;只記檔名,無法區分同一檔案先後發生的兩次編輯。
Claude Code 結束寫入後再執行一次。除了分支,也要確認目錄;若使用獨立 worktree,Yenpo 應開啟那個目錄。
| 結束後的狀態 | 應該檢查什麼 |
|---|---|
| 沒有新提交,開始前沒有改動 | 相對起始提交的本機改動 |
| 產生新提交 | 起始提交 → 最終提交,再看剩餘本機改動 |
| 開始前已有修改 | 對照記錄的起始內容,再判斷哪些屬於 Claude Code |
Yenpo 讀取 Git 狀態,不會自動還原 Claude Code 每輪對話的範圍。若沒有記錄原本已修改的內容,應把範圍稱為「目前改動」,不要認定全是這一輪的成果。
2. 在 Yenpo 中閱讀本機差異
開啟專案資料夾,點擊側邊欄帶加減號的「改動檔案」。「本地改動」以 HEAD 為基準統計改動。選擇檔案,即可閱讀行內 diff。
先看實作需求的檔案,再看呼叫端與測試。新增的測試或設定也要讀,它們往往比大段產生的內容更能說明行為。統計可能包含 Yenpo 中尚未儲存的文字;與命令列 Git 比對或執行測試前,先儲存打算保留的編輯。
若 Claude Code 已提交,開啟「版本比較…」,使用「提交」模式逐一查看相關提交相對第一父提交的差異,再回到「改動檔案」檢查未提交部分。要看整輪的淨差異,將下方佔位符換成記錄的起始與最終 ID,執行這條唯讀指令。Yenpo 的「比較」模式選擇的是分支,詳見版本選擇說明。
git diff START_COMMIT END_COMMIT --
3. 沿著一個行為讀出差異之外
假設需求是修正「更換搜尋詞後,舊結果仍然顯示」。讀完修改的函式,接著找呼叫端與更新畫面結果的位置。
- 誰啟動請求,哪個值識別目前的搜尋詞?
- 第一個請求比第二個更晚完成,會發生什麼?
- 測試有控制完成順序,還是只呼叫函式兩次?
使用檔案搜尋;有語言伺服器時,也可跳至定義或尋找參照。確認跟讀的分頁與 diff 是同一版本,目前檔案可能已經不同於提交比較的內容。
4. 向 AI Reader 提出明確問題
連接模型後,點擊本機改動標題處的「讓 AI 審查所有改動」準備草稿。針對提交比較則使用「讓 AI 審查這次比較」,保留比較附件。
送出前調整問題:
解釋搜尋結果處理的這次改動,從呼叫端追蹤到畫面更新。檢查舊請求最後完成的情況。每個判斷都引用相關程式碼,區分既有行為與新增行為,指出哪些測試確實涵蓋這個完成順序。只審查,不修改檔案。
保持編輯授權關閉。點擊回答裡的引用核對程式碼,涉及呼叫端或前置條件時開啟完整檔案。逐條核對引用的教學有具體例子。
5. 給 Claude Code 可以執行的回饋
有效的回饋應說清楚觸發條件與預期結果:
查詢 A 比 B 早開始、晚完成時,A 仍可能覆蓋 B 的結果。請檢查結果賦值路徑,補一個先完成 B、再完成 A 的測試。保留單次成功請求的既有行為。
先在自己的程式碼中確認問題,再使用這段回饋。把「更安全一點」換成實際需要的行為。修正後重新閱讀相關 diff,執行專案對應測試,並記下實際執行的命令與結果。
6. 留下簡短的審查紀錄
記下起始與最終提交 ID、已讀檔案、行為變化的摘要和未解問題。註明是否涵蓋未提交檔案,以及實際執行的檢查,下一輪就有明確的起點。
工作已整理到分支時,可接著看與 main 比較分支的教學;同樣的 Git 步驟也適用於 Claude Code 的分支。