Community研究與資料分析github.com

mohamedzhioua/agent-done-or-not

防止你的 AI 助手謊報「完成」。一套單檔驗證關卡,適用於 Claude Code、Cursor 與 Codex。代理必須先通過驗證才能結束任務。

agent-done-or-not 是什麼?

這套技能確保 AI 開發代理(如 Claude Code、Cursor、Codex)在報告任務完成前,能透過獨立的驗證指令來證明工作確實已達標。它透過一個名爲「done-gate.sh」的 Bash 腳本,擷取驗證命令(如測試、建置、型別檢查或端點 curl)的執行結果、退出碼與輸出 SHA-256 雜湊值,並僅在收到新鮮的「通過」憑證後才允許代理回報完成。此技能特別適合需要在程式碼修改後強制執行建置或測試通過的場景,有效杜絕代理依靠記憶或推測來謊報狀態。支援多數現代 AI 開發平台,且實作方式輕量——僅需一個 Shell 指令即可嵌入任何開發流程。

相容平台✓Claude Code✓Codex CLI✓Cursor
npx skills add mohamedzhioua/agent-done-or-not

Installed? Explore more 研究與資料分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

done-or-not

使用時機

當你要向使用者報告某項任務、建置、測試、修正或驗證步驟已「完成」時,請務必使用此技能。任何聲稱完成的陳述都必須有關卡提供的證明,而非僅靠信心或記憶。

使用方式

  1. 找出能證明工作已完成的指令。選擇最小且能實際驗證聲稱的檢查項目:測試、建置、型別檢查、 lint、對執行中端點執行 curl,或其他具有明確通過/失敗行為的指令。

  2. 透過驗證關卡執行驗證指令:

    bash done-gate.sh capture --label check -- <你的驗證指令>
    

    關卡會記錄指令、退出碼以及輸出的 SHA-256 雜湊值。它會以該指令自身的退出碼結束,因此失敗的檢查會導致 capture 失敗。

  3. 僅在取得最新「通過」憑證後,才報告工作已完成。

  4. 若檢查失敗,請修正問題後再次執行 capture。絕不能在有紅燈檢查的情況下回報成功。

當底層框架支援時,Stop 關卡會強制執行此規則:它會阻止代理結束回合,直到存在新鮮的「通過」憑證爲止。請不要繞過關卡;請產出證明。

相關技能