done-or-not
使用時機
當你要向使用者報告某項任務、建置、測試、修正或驗證步驟已「完成」時,請務必使用此技能。任何聲稱完成的陳述都必須有關卡提供的證明,而非僅靠信心或記憶。
使用方式
-
找出能證明工作已完成的指令。選擇最小且能實際驗證聲稱的檢查項目:測試、建置、型別檢查、 lint、對執行中端點執行
curl,或其他具有明確通過/失敗行為的指令。 -
透過驗證關卡執行驗證指令:
bash done-gate.sh capture --label check -- <你的驗證指令>關卡會記錄指令、退出碼以及輸出的 SHA-256 雜湊值。它會以該指令自身的退出碼結束,因此失敗的檢查會導致 capture 失敗。
-
僅在取得最新「通過」憑證後,才報告工作已完成。
-
若檢查失敗,請修正問題後再次執行 capture。絕不能在有紅燈檢查的情況下回報成功。
當底層框架支援時,Stop 關卡會強制執行此規則:它會阻止代理結束回合,直到存在新鮮的「通過」憑證爲止。請不要繞過關卡;請產出證明。