Autonomous PR Gates

本文件是 tachigo 的 Autonomous Worker Profiles v2 evidence discipline。它補足 AGENTS.md、docs/ai/codex-autonomous-workflow.md、.github/PULL_REQUEST_TEMPLATE.md 與 PR Scope Police 之間的共同語彙。

若是從新對話或新任務啟動 Hybrid AWP with Explicit Fallback Gate，先讀 docs/ai/autonomous-bootstrap.md。本文件是 evidence gate 與 spec-injector local-only 細節，不是單一啟動入口。

成本感知分派

• ops_spark / Spark：GitHub issue / PR metadata、CI / check readback、duplicate PR / branch 檢查、review-thread / CodeRabbit / connector 狀態讀回。
• GPT-5.4 worker：窄範圍 docs、template、workflow、tests、一般實作；需在 bounded write set 內完成。
• GPT-5.5 controller：scope、架構、review decision、final merge gate。controller 不應長期承擔 routine GitHub / CI / readback。

Delegation Execution Log 的 spawn directive 必須可讀出 profile=, model=, reasoning=, controller_fallback=。若 controller_fallback=allowed，同一行必須有非空 fallback_reason= 或 controller_fallback_reason=。ops_spark 類任務不得使用高階 controller model，除非同一行留下 fallback reason。

Delegation Threshold

0-3 分鐘、單一 read-only trivial check 可由 controller 直接做，但必須記錄 controller_fallback_reason。以下任務預設委派給 Spark / 低成本 worker：

• GitHub issue / PR / branch duplicate readback。
• CI / Scope Police / review-thread / CodeRabbit / connector readback。
• PR body、issue checklist、metadata-only repair 的資料蒐集。

涉及 schema、auth、wallet、金流、points ledger、merge decision、review finding 採納與否時，controller 保留 final decision。

PR Initial Body And Final Closeout

PR body 一開始就要完整合規，包含 Source of truth、Depends on PR、本 PR 明確不做、Delegation Execution Log、Review conversation closeout、Final merge gate。開 PR 時尚未穩定的欄位可填 pending with reason 或 n/a，但 ready-to-merge closeout 不可留下裸 pending。

final closeout 只在 merge 前狀態穩定後更新一次，避免每個 CI tick 都修改 PR body。final closeout 至少讀回 latest head SHA、CI / Scope Police、review threads、CodeRabbit、chatgpt-codex-connector、每個 finding 的採納或不採納狀態。

Review Fallback Policy

• CodeRabbit skipped / rate limit：不得對同一 head 重複要求 review；改由 controller self-review，並留下 rate-limit / skipped 證據與驗證結果。
• chatgpt-codex-connector timeout：先讀 comment / review / reaction；reaction-only 可視為 fallback evidence，但需記錄 latest head。
• 所有 review finding 必須修正並回覆/resolve，或留下技術理由後 resolve。

Review Triage Discipline

• review finding 不能照單全收；總控必須先做 necessity assessment，確認它是否真的是 blocker、是否仍對最新 head 成立、以及是否會把 PR 擴成超出原 issue 的 patch。
• review follow-up 必須以 latest head SHA 為批次單位處理；同一 head 上的 duplicate finding 要 collapse 成同一筆 triage，不得把同義 comment 當成多個獨立工作項目。
• 若 finding 指向舊 diff、舊 head、或已被後續 commit 覆蓋，先做 outdated finding re-check；沒有 latest-head 佐證的舊 finding，不得直接轉成新 patch。
• 同一區塊、同一概念、或同一 state transition 第 2 次再出現 edge-case finding 時，必須升級成 root-cause / state-model 檢查，而不是只補第 2 個局部 patch。
• parser / gate / workflow 類 follow-up 預設先做 matrix-first 或 table-driven regression tests，再補最小修正，避免一個 finding 換來另一個 parser 分支洞。
• 若 review follow-up patch 預估超過原 PR diff 的約 25-30%，應停下來做 split assessment；能拆成 follow-up issue/PR 就不要繼續在原 PR 無限加碼。
• final closeout 要對每個 finding 留下 adopted、partial、rejected、deferred 其中一種 disposition，並提供對應 evidence ref 或 comment/thread URL。
• PR body 只需要薄接線：review_triage_ref、root_cause_gate_ref、finding_disposition_ref 三個 evidence ref。完整 triage matrix、root-cause notes、或 spec-injector output 可以留在 issue / PR comment / local-only spec evidence，不必整份塞進 PR body。
• Scope Police 只檢查這三個 ref 是否存在與 pending marker；剛開 PR 可用 pending with reason，但 bare pending 與 ready-to-merge closeout 的任何 pending ref 都會被擋下。tachigo 不解析完整 review triage schema/checker。
• review triage schema/checker 的 source of truth 在 Erick52106/spec-injector#232、#233、#234、#235；tachigo 只保存 evidence refs 與 lightweight gate。

spec workflow-check Gates

spec-injector 對 tachigo 是 local-only 輔助，不是不用此工具者的硬性門檻。tachigo 這側只做 thin wiring：PR template 與 policy docs 保留 status + ref evidence slot，真正的 spec workflow-check phase parser、local artifact 檢查與穩定輸出格式由 Erick52106/spec-injector#242 之後的 CLI 提供。

Capability check

Autonomous work 開始前先確認 CLI 支援 #242 gates：

spec workflow-check --help

help output 必須包含 --finding-disposition、--threshold-evidence、--pr。若全域 spec 太舊，依 docs/ai/autonomous-bootstrap.md 使用 SPEC_INJECTOR_DIR local runner；若仍不可用，將 tool_gap=spec-injector #242 workflow-check unavailable 記入 evidence，改走 manual checklist fallback。

Start gate

使用者要求或任務適用時，本機執行：

spec plan <issue> --repo . --dry-run --format prompt --verbose
spec workflow-check --repo . --phase start --issue <issue>

Start gate 用來產生 bounded context、檢查 spec config、分類 Hybrid AWP routing，並要求先留下 routing/fallback evidence。不得把 classifier、guardrail 或 auto-discovered reference 解讀成擴 scope 授權。

Commit gate

commit 前本機執行：

spec workflow-check --repo . --phase commit --pr-body <path-to-pr-body> \
  --routing-evidence <path-to-routing-evidence.json> \
  --finding-disposition <path-to-finding-disposition.json> \
  --threshold-evidence <path-to-threshold-evidence.json>
git diff --check

Commit gate 檢查 PR body status/ref evidence、routing/fallback 對齊、review finding disposition evidence、threshold evidence，以及 staged .spec-injector/ / generated output / private context。若本 PR 尚未收到 review finding，finding-disposition 可記錄 status=not_applicable 與原因；不得留裸 pending。

Merge gate

merge 前 fresh readback latest PR head SHA 後本機執行：

spec workflow-check --repo . --phase merge --pr-body <path-to-pr-body> \
  --head-sha <latest-head-sha> \
  --pr <number-or-url> \
  --routing-evidence <path-to-routing-evidence.json> \
  --finding-disposition <path-to-finding-disposition.json> \
  --threshold-evidence <path-to-threshold-evidence.json>

--pr 只做 read-only closeout readback，用來比對 draft 狀態、human review decision、checks、review thread summary 與 PR body closeout。它不得 comment、resolve、merge、加 label 或修改遠端狀態。

不得 commit .spec-injector/、spec output、private context、或工具產生的 task package。未使用 spec-injector 的 PR 可在 template 填人工 checklist / n/a。

PR body 只應留下 gate 狀態與可讀回的 evidence ref，例如本機 spec validate 通過、人工 checklist、或含三段 gate 摘要的 PR / issue comment URL。完整三段細節不應塞進 PR body，也不應由 tachigo 的 Scope Police 重新解析。

Threshold Calibration Ledger

Threshold 校正是暫時性的 autonomous workflow 分析資料，不是 tachigo product contract。校正紀錄集中留在 #664 的 long-lived issue comment，PR body 只需在 workflow friction / final closeout 裡放 #664 comment URL 或 n/a。

不要把 spawn_count、CI rerun、review-thread count、threshold decision 等 metrics 加進 PR template，也不要讓 Scope Police 依賴這些 metrics。等 autonomous workflow 門檻穩定後，#664 可封存或停止新增紀錄，而不需要修改專案結構。

Scope Police Contract

Autonomous evidence gate 只對 autonomous PR 嚴格啟用。判定方式包含 Delegation Execution Log 有正式欄位內容，或 label / branch / body 明確標示 autonomous / codex workflow。

Scope Police sticky comment 應顯示 Autonomous evidence snapshot，讓 reviewer 快速看見 delegation log、spawn directives、controller fallback、review closeout、final merge gate 與 pending 是否清乾淨。