Community程式設計與開發github.com

Wanbicoi/agent-config

對一個編碼工作階段進行回顧,找出環境與流程改進的機會。

agent-config 是什麼?

這個技能引導 AI 代理在完成編碼工作階段後執行結構化回顧。它定義了系統性的審查類別:導航效率、自動化檢查(linting、型別檢查、測試、檔案系統檢查)、編碼標準、工具經濟性、AGENTS.md 檔案規模、無效指令以及資訊存取。對於每個類別,該技能提供了具體的使用時機,幫助代理判斷問題的嚴重性。此技能支援從用戶指定的工作階段或當前工作階段讀取日誌,並參考 `writing-for-agents` 風格指南以及 `CLAUDE.md`、`CODING_STANDARDS.md` 等儲存庫檔案。最終的輸出是按嚴重性排序的改進建議列表。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Wanbicoi/agent-config/tree/HEAD/skills/retro

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

用戶要求進行 回顧。你應提出對編碼代理 環境 的改進建議,以提升未來執行的效率。

步驟

  1. 針對寫作風格指南,呼叫 writing-for-agents 技能的 Skill 工具。

  2. 讀取用戶指定的工作階段的主要原始資料。這可能意味著在此機器上搜尋工作階段日誌。如果用戶未指定工作階段,則預設為當前工作階段。

  3. 在以下類別中尋找改進候選項目。

    • 導航:代理找到正確檔案的難易度如何?檔案之間是否存在隱藏的依賴關係?加入 導航指標 會更容易嗎?使用時機:當工作階段花費很長時間才找到某個資訊。
    • 自動化檢查:是否存在能夠捕捉到代理所犯錯誤的自動化檢查?例如 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)?使用時機:當代理進行了昂貴的工具呼叫。
    • 無效操作:尋找引導檔案中不會修改代理行為的指令。使用時機:當引導檔案龐大且難以管理時。
    • 資訊存取:尋找增加代理資訊存取權限的機會。例如記錄開發伺服器日誌、以唯讀方式存取第三方服務。使用時機:當代理無法取得關鍵資訊時。
  4. 按嚴重性排序,將這些候選項目呈現給用戶。

參考資料

實作 vs 審查

請記住,所有工作都經歷兩個階段:實作和審查。實作代理承受最大的 上下文壓力。他們負責探索、撰寫程式碼和除錯錯誤。

審查代理的上下文壓力最小——它接收 diff,因此無需探索。它通常不需要撰寫程式碼或進行除錯。

這意味著審查代理應負責強制執行編碼標準,而非實作代理。

檔案

你可以存取儲存庫中的幾個檔案:

  • CLAUDE.md / AGENTS.md:這些檔案會被推送到在此儲存庫中工作的任何代理的上下文視窗中。應極其謹慎地使用它們,通常僅作為指向其他檔案的 導航指標。
  • CODING_STANDARDS.md:此檔案在審查期間讀取,而非實作階段。如果標準檔案長度超過 1,000 行,請在其中新增指向 docs 資料夾的 導航指標。
  • 文件:將文件用作參考檔案,由其他檔案指向。在撰寫新文件前,先查詢現有文件。
  • 技能:將技能用於文件(因其描述會進入代理的上下文視窗),或用作用戶呼叫的命令。請遵循 writing-for-agents 技能的建議。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相關技能