檢查就緒狀態
以 $check-readiness diff、$check-readiness pr <URL>、$check-readiness release 或 $check-readiness full 方式呼叫。
預設為唯讀。回報問題並提出具體解決方案。僅在使用者明確要求修正或套用發現時才進行編輯;之後需驗證受影響的行為。
1. 選擇目標
| 模式 | 目標 | 完成標準 |
|---|---|---|
diff | 當前儲存庫的暫存、未暫存及相關未追蹤變更,以及受影響的呼叫者和測試。當變更是目標時的預設模式。 | 每一項變更的行為及受影響的邊界都已被考量。 |
pr <URL> | 連結的 PR 差異、基底、對話、檢查及受影響的上下文。 | 每一項變更的行為都已被考量;遺漏的本地或遠端證據需明確指出。 |
release | 當前儲存庫及指定的部署目標,或從儲存庫組態中找到的目標。 | 每一個關鍵流程和發布依賴項目都有一個狀態。 |
full | 當前儲存庫適用的前後端表面。 | 每一條主要路由、操作、信任邊界、資料儲存和生命週期路徑都已完成盤點和評估。 |
使用使用者命名的模式。若未命名,則從 PR URL、當前變更或陳述的發布中推斷;否則使用 full。在檢查前記錄確切的目標、修訂版或差異、環境以及可用的驗證路徑。如果無法存取 PR URL,請回報被阻擋的內容;請勿以無關的本地差異取代。
嚴重性
每個 FAIL 都是阻擋性或建議性的。阻擋性:安全性、身分驗證/授權、資料遺失或損毀、中斷的關鍵流程、未經驗證的付款或 Webhook 處理、洩漏的機密、失敗的建置或測試。其他所有情況都是建議性的,不會單獨阻止 READY 狀態。每個就緒技能都會列出自己的阻擋範圍。
依模式劃分的深度
diff 和 pr:僅檢查變更觸及的行為;其餘部分在一行內標記為 N/A (未觸及),而非逐項檢查。發布門檻檢查(Lighthouse、部署環境的煙霧測試、分享預覽)僅適用於 release 和 full 模式,除非變更影響了這些項目。
2. 收集證據
對於 diff,檢查 git status --short --branch、暫存和未暫存的差異以及相關的未追蹤檔案。對於 pr,閱讀連結的 PR 及其差異、檢查和討論;僅在其修訂版已驗證時,才使用相符的本地簽出進行測試。對於 release 和 full,在測試前先繪製目標應用程式的範圍。為每個受影響的領域追蹤呼叫者、資料影響、組態、測試和部署依賴。
當後端程式碼或行為在範圍內時,執行 backend-readiness。當前端程式碼或行為在範圍內時,執行 frontend-readiness。將選定的模式和目標傳遞給每個子技能;如果兩者都適用,則合併它們的發現。對於變更審查,對受影響的行為套用檢查。對於發布,對關鍵流程和目標環境套用檢查。對於 full,評估儲存庫中所有適用的檢查。將每個適用的檢查標記為 PASS、FAIL、BLOCKED 或 N/A;為每個 PASS 附加當前證據,為每個 N/A 附加原因。
使用原始碼、自動化測試、本地運行環境、供應商沙箱和部署環境作為不同的證據層。建置證明建置。將不可用的憑證、基礎設施或環境記錄為 BLOCKED,並附上仍需要的確切證明。執行能夠驗證目標的聚焦檢查;不要僅憑原始碼就斷言運行時或發布行為。
當適用的檢查都有了狀態、失敗有原因和解決方案、並且每個就緒聲明都與其證據層相符時,即完成。
3. 報告與行動
回報模式和目標,然後按安全性、資料遺失、正確性和使用者影響的順序列出發現。每個發現都需指出位置或流程、證據、後果以及最簡潔的具體解決方案。包含執行的檢查及其確切結果,以及被阻擋或未驗證的項目。以 READY、NOT READY 或 UNVERIFIED 結束以表示所選目標的狀態:READY 要求沒有已知的阻擋性失敗,並且有適用門檻的證據;UNVERIFIED 表示缺少證據而無法做出該斷言。
使用此模板:
模式 / 目標:<模式、修訂版或差異、環境>
發現
| 嚴重性 | 位置或流程 | 證據 | 後果 | 解決方案 |
已執行的檢查
| 命令或測試 | 結果 |
被阻擋 / 未驗證
- <項目>:<仍需要的證明>
裁決:READY | NOT READY | UNVERIFIED
保持審查運行唯讀。如果使用者要求修復發現,請在受影響的程式碼中套用要求的修復,執行聚焦驗證,並回報剩餘風險。請勿從檢查就緒狀態的請求中推斷編輯授權。
當報告區分了已驗證行為與缺口,或要求的修復已套用並驗證時,即完成。