驗收協調器
概述
將編碼工作協調為一個狀態機,只有在驗收標準有證據支持或任務被明確升級時才會結束。
核心規則:不要優化「程式碼已變更」;要優化「DoD 已證明」。
使用時機
- 任務已具備 issue 或明確的驗收標準,應從頭到尾自動運行,將人工重新介入降到最低。
- 你需要結構化的交接,涵蓋實施、審查、部署和最終驗證。
- 你想要明確的停止條件與升級機制,而非無聲的部分完成。
必要子技能
create-issue-gateclosed-loop-deliveryverification-before-completion
可選支援技能:
deploy-devpr-watchpr-review-autopilotgit-ship
輸入
需要以下輸入:
- issue ID 或 issue 內容
- issue 狀態
- 驗收標準(DoD)
- 目標環境(預設為
dev)
固定預設值:
- 最大迭代輪數 =
2 - PR 審查輪詢 =
3m -> 6m -> 10m
狀態機
intakeissue-gatedexecutingreview-loopdeploy-verifyacceptedescalated
工作流程
-
接收(Intake)
- 讀取 issue 並提取任務目標和 DoD。
-
Issue 閘門(Issue gate)
- 使用
create-issue-gate邏輯。 - 如果 issue 不是
ready狀態或執行閘門不允許,立即停止。 - 當 issue 仍處於
draft狀態時,不要實作任何內容。
- 使用
-
執行(Execute)
- 移交給
closed-loop-delivery進行實作和本地驗證。
- 移交給
-
審查循環(Review loop)
- 如果 PR 回饋相關,批次輪詢視窗為:
- 等待
3m - 然後
6m - 然後
10m
- 等待
- 經過
10m輪次後,停止等待並一起處理所有可見的評論。
- 如果 PR 回饋相關,批次輪詢視窗為:
-
部署與運行時驗證(Deploy and runtime verification)
- 如果 DoD 依賴於運行時行為,預設只部署到
dev。 - 使用真實的日誌/API/Lambda 行為進行驗證,而不是假設。
- 如果 DoD 依賴於運行時行為,預設只部署到
-
完成閘門(Completion gate)
- 在任何聲稱完成之前,需要
verification-before-completion。 - 沒有新鮮證據,不得聲稱成功。
- 在任何聲稱完成之前,需要
停止條件
只有當每個驗收標準都有匹配的證據時,才轉入 accepted。
當發生以下任何情況時,轉入 escalated:
- 在
2輪完整迭代後 DoD 仍未通過 - 缺少的 secrets/權限/外部依賴阻礙了進度
- 任務需要生產環境操作或破壞性操作批准
- 審查指令衝突且無法同時滿足
人工閘門
在以下情況始終停止以等待人工確認:
- 超出約定範圍的 production/stage 部署
- 破壞性 git/資料操作
- 帳單或安全態勢的變更
- 缺少使用者提供的驗收標準
輸出合約
報告狀態時,始終包含:
狀態:intake / executing / accepted / escalated驗收標準:通過/失敗核對清單證據:指令、日誌、API 結果或運行時證明開放風險:任何仍不確定的事項需要人工輸入:如果受阻,下一個最小的決策
除非狀態是 accepted,否則不要報告「完成」。
限制
- 僅在任務明確符合上述範圍時使用此技能。
- 不要將輸出視為環境特定驗證、測試或專家審查的替代品。
- 如果缺少必要的輸入、權限、安全邊界或成功標準,請停止並要求澄清。