Acceptance Orchestrator
概要
コーディング作業を状態機械としてオーケストレーションし、受け入れ基準が証拠をもって検証されるか、タスクが明示的にエスカレーションされた場合にのみ終了します。
コアルール: 「コード変更」のために最適化するのではなく、「DoDの証明」のために最適化すること。
使用する場合
- タスクにすでに課題や明確な受け入れ基準があり、最小限の人間の再介入でエンドツーエンドに実行する必要がある場合。
- 実装、レビュー、デプロイ、最終検証の間に構造化された引き継ぎが必要な場合。
- 暗黙の部分完了ではなく、明示的な停止条件とエスカレーションを希望する場合。
必要なサブスキル
create-issue-gateclosed-loop-deliveryverification-before-completion
オプションの補助スキル:
deploy-devpr-watchpr-review-autopilotgit-ship
入力
以下の入力を必須とします:
- 課題IDまたは課題本文
- 課題ステータス
- 受け入れ基準(DoD)
- ターゲット環境(デフォルトは
dev)
固定デフォルト値:
- 最大反復ラウンド数 =
2 - PRレビュー待機時間 =
3m -> 6m -> 10m
状態機械
intake(取り込み)issue-gated(課題ゲート通過)executing(実行中)review-loop(レビューループ)deploy-verify(デプロイ検証)accepted(受け入れ済み)escalated(エスカレーション済み)
ワークフロー
-
Intake(取り込み)
- 課題を読み込み、タスク目標とDoDを抽出する。
-
Issue gate(課題ゲート)
create-issue-gateロジックを使用する。- 課題が
readyでない、または実行ゲートがallowedでない場合は、直ちに停止する。 - 課題が
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が失敗する
- 不足しているシークレット/権限/外部依存関係が進行を妨げる
- タスクに本番環境での操作や破壊的操作の承認が必要
- レビュー指示が矛盾しており、両方を満たせない
人間による確認ゲート
以下の場合、常に人間の確認のために停止する:
- 合意された範囲を超えたプロダクション/ステージング環境へのデプロイ
- 破壊的なgit/データ操作
- 課金やセキュリティポスチャの変更
- ユーザーが提供した受け入れ基準の欠落
出力契約
ステータスを報告する際は、常に以下を含める:
Status: intake / executing / accepted / escalatedAcceptance Criteria: 合格/不合格チェックリストEvidence: コマンド、ログ、API結果、またはランタイムの証明Open Risks: まだ不確かなことNeed Human Input: ブロックされている場合の最小の次の判断
ステータスが accepted でない限り、「完了」と報告してはならない。
制限事項
- このスキルは、タスクが上記の範囲に明確に一致する場合にのみ使用すること。
- 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないこと。
- 必須の入力、権限、安全上の境界、または成功基準が欠落している場合は、停止して明確化を求めること。