用戶要求進行 回顧。你應提出對編碼代理 環境 的改進建議,以提升未來執行的效率。
步驟
-
針對寫作風格指南,呼叫
writing-for-agents技能的 Skill 工具。 -
讀取用戶指定的工作階段的主要原始資料。這可能意味著在此機器上搜尋工作階段日誌。如果用戶未指定工作階段,則預設為當前工作階段。
-
在以下類別中尋找改進候選項目。
- 導航:代理找到正確檔案的難易度如何?檔案之間是否存在隱藏的依賴關係?加入 導航指標 會更容易嗎?使用時機:當工作階段花費很長時間才找到某個資訊。
- 自動化檢查:是否存在能夠捕捉到代理所犯錯誤的自動化檢查?例如 linting、型別檢查、測試、檔案系統 linter?首先閱讀儲存庫本身的檢查命令(其
package.json/建置工具的lint/check腳本、CI 工作流程),因此發現應是該檢查已存在但未配置或靜默中斷,而不是重新發明輪子。一個沒有 護欄(沒有 pre-commit hook,也沒有執行 lint/型別檢查/測試命令的 CI 任務)的儲存庫本身就是一個發現:未經 lint 的儲存庫是一個常態性的錯失機會,而非中性預設。使用時機:當代理犯了自動化檢查本可捕捉的錯誤,或儲存庫完全沒有護欄。 - 編碼標準:是否應為 審查代理 提供新的規則來強制執行?是否應移除或澄清現有規則?首先對違規進行分類:機械式 的違規(固定的語法模式、禁止的 API、匯入形狀、檔案位置規則)必須採用確定性檢查,沒有商量餘地:在儲存庫自身的 linter 中新增自訂規則、新增 pre-commit hook,或新增 CI 任務,選擇儲存庫語言和現有護欄中最經濟的方式。預設使用建置檢查而非撰寫規則。將
CODING_STANDARDS.md保留給真正的 判斷性事項(跨檔案一致性、「與周圍風格相符」、任何護欄都無法替代的事項)。使用時機:當審查代理未能捕捉到錯誤。 - 全域 AGENTS.md:是否有任何引導指令應移至編碼標準(或自動化檢查)?使用時機:當 AGENTS.md 檔案特別龐大時——無論是在儲存庫還是在用戶的全域範圍內。
- 工具經濟性:代理是否進行了可以簡化的昂貴工具呼叫?是否存在任何特別消耗 token 效率不彰的自訂工具(CLI、MCP)?使用時機:當代理進行了昂貴的工具呼叫。
- 無效操作:尋找引導檔案中不會修改代理行為的指令。使用時機:當引導檔案龐大且難以管理時。
- 資訊存取:尋找增加代理資訊存取權限的機會。例如記錄開發伺服器日誌、以唯讀方式存取第三方服務。使用時機:當代理無法取得關鍵資訊時。
-
按嚴重性排序,將這些候選項目呈現給用戶。
參考資料
實作 vs 審查
請記住,所有工作都經歷兩個階段:實作和審查。實作代理承受最大的 上下文壓力。他們負責探索、撰寫程式碼和除錯錯誤。
審查代理的上下文壓力最小——它接收 diff,因此無需探索。它通常不需要撰寫程式碼或進行除錯。
這意味著審查代理應負責強制執行編碼標準,而非實作代理。
檔案
你可以存取儲存庫中的幾個檔案:
CLAUDE.md/AGENTS.md:這些檔案會被推送到在此儲存庫中工作的任何代理的上下文視窗中。應極其謹慎地使用它們,通常僅作為指向其他檔案的 導航指標。CODING_STANDARDS.md:此檔案在審查期間讀取,而非實作階段。如果標準檔案長度超過 1,000 行,請在其中新增指向 docs 資料夾的 導航指標。- 文件:將文件用作參考檔案,由其他檔案指向。在撰寫新文件前,先查詢現有文件。
- 技能:將技能用於文件(因其描述會進入代理的上下文視窗),或用作用戶呼叫的命令。請遵循
writing-for-agents技能的建議。