工程開發
verification-before-completion avatar

verification-before-completion

強制執行工作驗證協議,要求在宣稱工作完成或成功前,必須運行驗證指令並確認輸出,以防止錯誤的成果聲明。

簡介

verification-before-completion 技能作為編碼代理的嚴格守門人,確立了一項不可動搖的原則:在沒有獨立、即時的證據之前,不得宣稱任何狀態,例如「已修復」、「已完成」或「測試通過」。此技能專為自動化編碼代理和旨在消除代碼錯誤假設的開發人員設計。透過將代理的行為從基於啟發式的報告轉向基於證據的驗證,顯著提高了交付成果的可靠性。

  • 強制執行嚴格的識別、執行和確認循環,用於每一個完成聲明。

  • 為檢查構建成功、測試通過率、代碼檢查狀態和需求合規性提供了系統化框架。

  • 直接整合到開發流程中,特別是在提交、推送或發起合併請求(PR)等 Git 操作之前。

  • 主動打擊「合理化」和「代理幻覺」,將任何未經支援指令輸出而表達的滿意或成功聲明視為危險訊號。

  • 包含常見軟體開發聲明與所需證據的全面對照表,例如要求修復 Bug 時必須經過完整的紅綠測試(Red-Green TDD)週期。

  • 使用方式:此技能應在任何任務的最後階段啟用,特別是在代理即將宣告任務完成或已驗證時。

  • 輸入/輸出:要求代理識別相關終端指令(例如 npm test 或 cargo build),並處理原始輸出流,以確認零失敗或預期退出代碼,然後才向用戶回報成功。

  • 實際限制:代理必須忽略內部的信心指標或先前的運行結果;必須發起新的執行以確保考慮到當前的環境背景。

  • 安全性:遵守此技能可防止因過早自信或疲勞導致的錯誤而交付包含 Bug、未定義函數或不完整的功能。

  • 整合:它是子代理驅動開發(Subagent-driven development)的重要檢查點,確保代理不會委派或批准尚未經過實證驗證的工作。

倉庫統計

Star 數
170,798
Fork 數
15,078
Open Issue 數
285
主要語言
Shell
預設分支
main
同步狀態
閒置
最近同步時間
2026年4月28日 上午11:38
在 GitHub 查看