verification-before-completion

「完成前驗證」(Verification Before Completion) 是一項關鍵的工程技能，旨在消除自動化軟體開發中的假陽性與推測性的狀態報告。它作為強制性的品質守門員，防止代理程式在未產生實證前就宣稱任務完成。透過強制要求代理執行特定的驗證指令並解析其輸出——檢查退出代碼、測試成功次數或清理過的 linter 結果——此技能確保斷言直接與當前的存儲庫狀態掛鉤，而非僅基於代理的信心或假設。此技能適用於在嚴格測試、回歸驗證與可靠交付至關重要的環境中運作的自主編碼代理。典型使用案例包括驗證 TDD 中的紅綠重構週期、透過退出代碼確認建置成功、針對原始徵狀驗證特定錯誤修復，以及在建立拉取請求或提交程式碼前，透過清單檢查確保滿足所有需求。此技能防止了常見的失敗，例如依賴局部檢查、信任過時的成功報告，或在沒有實證的情況下做出如「完成」或「完美」等過早的滿意度聲明。它作為一種行為保障措施，以維持開發者的信任度與系統穩定性。

• 執行「鐵律」：沒有最新的驗證證據，不得聲稱工作完成。

• 要求在進行任何狀態報告前，系統性地執行驗證指令（測試、建置、linter）。

• 為每個開發任務實施識別、執行、驗證、報告的強制性工作流程。

• 識別危險訊號，例如推測性語言（「應該」、「可能」）與過早的滿意度表達。

• 防止依賴代理程式的自我反思或外部摘要，而非實際的 CLI 工具輸出。

• 標準化基於證據的報告，確保 PR、提交與任務轉換在技術上是健全的。

• 代理在行動前必須始終識別證明該聲明的特定指令。

• 要求代理閱讀完整的工具輸出，而非依賴被截斷或推論的日誌。

• 若缺乏明確的驗證指令，即視為未達到技能協議標準。

• 適用於軟體開發的每個階段：實作、重構、除錯與部署前準備。

• 明確禁止在未通過驗證閘門前進行新任務、提交或推播程式碼。