| description | codex auto-review (chatgpt-codex-connector[bot]) の reactions / reviews を polling して PASS / RETRY / BACK_FALLBACK を判定する。GitHub 限定。 |
| name | review-poll |
| exec_script | kaji_harness.scripts.review_poll_entry |
Review Poll
GitHub chatgpt-codex-connector[bot] (id 199175422) の auto-review シグナルを polling し、
verdict を出力する skill。review skill との二重起動を避け、auto-review クレジット不足時のみ
BACK_FALLBACK 経由で既存 review skill (codex agent) に fallback させる。
本 skill は LLM agent を起動しない deterministic skill であり、kaji_harness.scripts.review_poll_entry
module を直接 subprocess 実行する。entry module が env から PR 情報を解決し、polling 本体
kaji_harness.scripts.codex_review_poll に委譲する。
起動経路は 2 系統あり、いずれも同じ entry module に合流する:
- builtin workflow（
dev / dev-thorough / docs）:
各 YAML が exec: [kaji, pr, review-poll] で installed kaji CLI 経由で起動し、
CLI 側 (kaji pr review-poll) が同 entry module（review_poll_entry.main）へ委譲する。
dispatch の正本は YAML 側の exec step であり、agent / model / effort はスキーマレベルで
指定不可（指定すると kaji validate が reject）。対象 repo の Python 環境ではなく installed
kaji CLI 経由で起動するため可搬性が高い。
- skill 単体起動・再利用: frontmatter の
exec_script: kaji_harness.scripts.review_poll_entry
が契約となり、harness が同 entry module を python -m で subprocess 実行する。
どちらの経路でも、入力（env）/ verdict 仕様の正本は entry module（review_poll_entry）であり、
本ファイルの記述はその契約のミラーである。
いつ使うか
| タイミング | このスキル |
|---|
| PR 作成後、codex auto-review が走っている GitHub 環境 | ✅ 必須 |
provider.type='local' 配下 | ❌ ABORT verdict |
review-poll で BACK_FALLBACK を受けた場合 | 既存 review skill (codex agent) に進む |
ワークフロー内の位置: i-pr → [PR 作成] → review-poll（builtin workflow では exec step として起動）→ (PASS=close / RETRY=pr-fix / BACK_FALLBACK=review fallback)
入力（harness が env として注入）
| env 変数 | 必須 | 説明 |
|---|
KAJI_ISSUE_ID | ✅ | PR 解決の検索キー |
KAJI_PROVIDER_TYPE | ✅ | github 以外は ABORT |
KAJI_GIT_REMOTE | ✅ | owner/repo 解決 (git remote get-url) |
KAJI_WORKTREE_DIR | ✅ | git remote get-url 実行 cwd |
KAJI_PR_ID | 任意 | harness 側で解決済みの場合のみ。未設定なら kaji pr list で取得 |
これらの env は entry module（review_poll_entry）が正本として解釈する。builtin workflow の
exec step は agent / model / effort をスキーマで拒否するため、これらを指定する余地はない。
検出ロジック（仕様）
| 観測 | verdict |
|---|
bot による +1 reaction かつ +1.created_at >= head_committed_at (freshness guard) | PASS |
bot による COMMENTED review (body は body.lstrip().startswith("### 💡 Codex Review") で判定) かつ commit_id == head_sha | RETRY |
NO_REACTION_TIMEOUT_SEC (60s) 経過しても上記いずれも観測されず（stale +1 のみ存在も含む） | BACK_FALLBACK |
IN_PROGRESS_TIMEOUT_SEC (1800s) 経過しても結論が出ない、または GitHub API 連続失敗 | ABORT |
完了済み COMMENTED review は reactions API では検出できない（reactions は現在値のみ）が、
reviews API は履歴を返すため commit_id == head_sha で workflow 起動前の auto-review を
検出可能（PR #176 シナリオ）。
bot 識別は id 一致（199175422）を主、login を副チェックにする。
運用パラメータ
kaji_harness/scripts/codex_review_poll.py の定数:
| 名前 | 値 | 用途 |
|---|
POLL_INTERVAL_SEC | 10 | GitHub API 呼び出し間隔 |
NO_REACTION_TIMEOUT_SEC | 60 | bot reaction 無しのまま経過 → BACK_FALLBACK |
IN_PROGRESS_TIMEOUT_SEC | 1800 | eyes 観測後の全体 cap → ABORT |
EYES_GRACE_SEC | 10 | eyes 消失後の伝搬待ち |
Verdict 出力
entry module / polling 本体が ---VERDICT--- ブロックを stdout に出力する:
| status | 条件 |
|---|
| PASS | bot +1 reaction を観測 |
| RETRY | 現在 head に対する bot COMMENTED review を観測 |
| BACK_FALLBACK | timeout までいずれも観測されず → review step に fallback |
| ABORT | provider mismatch / PR 未解決 / head 情報欠落 / remote url parse 失敗 / GitHub API 連続失敗 / IN_PROGRESS_TIMEOUT 超過 |
deterministic script のため verdict 出力後は 必ず return 0 で終了する。catastrophic 失敗
（gh CLI 不在 / 通信不能等）は raise させ、harness が ScriptExecutionError で fail-loud
扱いとする（Issue #204 設計書 § exit code と verdict の優先順位）。
規約: 本 skill 出力に auto-close hazard pattern（Clos(e[sd]?|ing) /
Fix(e[sd]|ing)? / Resolv(e[sd]?|ing) / Implement(s|ing|ed)? の直後 #[0-9]）を
書かない。
