fix-github-issue reference
fix-github-issue は、既存 GitHub Issue 1 件を claim gate、read-only discovery、readiness gate、実装、検証、PR 前 simplify、必要な review、PR 作成まで進める入口である。
親 Issue の再分解や複数 Issue queue の展開は行わない。
詳細な gate と artifact の仕様は implementation readiness contract と claude/skills/fix-github-issue/SKILL.md を source of truth とし、この文書は利用者向けの引数早見表として扱う。
PR mode
| 引数 | 動作 |
|---|---|
pr=draft / draft |
Draft PR を作成する |
pr=create / create |
通常 PR を作成する |
pr=none / none |
commit と push まで行い、PR は作成しない |
| 未指定 | 作業開始前に PR mode を確認する |
PR を作成する場合は create-pr skill を使う。
pr=create / pr=draft で no-copilot-bot が明示されていない場合、完了報告前に最新 PR HEAD の Copilot bot review gate を確認する。
review mode
| 引数 | 動作 |
|---|---|
review=simplify |
PR 前 simplify だけを実行し、multi-review phases は実行しない |
review=once |
PR 前 simplify と通常検証後、Codex one-shot reviewer を 1 回実行する |
review=on / multi-review |
multi-review を実行する |
review=off / no-review |
review=simplify の alias。PR 前 simplify は skip しない |
| 未指定 | review 系 option がなければ review=simplify に正規化する |
agents=、pause=、per-agent-timeout=、quiescence=、force-copilot-request、no-copilot-bot のいずれかが指定され、review mode が未指定の場合は review=on に正規化する。
review=once で指定できる reviewer selector は agents=codex だけである。
ask-user 単独は multi-review を有効化しない。
local reviewer と Copilot bot
| 引数 | 動作 |
|---|---|
agents=codex |
Codex local reviewer を使う |
agents=claude |
Claude local reviewer を使う |
agents=copilot |
GitHub Copilot CLI local reviewer を使う |
agents=codex,copilot |
複数 local reviewer を使う |
agents=none |
local reviewer を起動しない明示指定 |
no-copilot-bot |
PR target の Copilot bot review を起動しない明示 override |
force-copilot-request |
Copilot bot review を強制再依頼する |
allow-disable-copilot-bot |
既存 coverage から Copilot bot を外す downgrade を明示許可する |
disable-copilot-bot-reason=<text> |
Copilot bot を無効化する理由を渡す |
agents= は local reviewer の選択であり、GitHub PR 上の copilot-pull-request-reviewer ではない。
PR mode では review=simplify / review=once / review=on のどれでも、ユーザーが no-copilot-bot を明示しない限り Copilot bot review を完了条件にする。
agents=none は PR mode では PR 前 local phase を起動せず、PR target phase で Copilot bot review だけを期待する。
allow-disable-copilot-bot と disable-copilot-bot-reason=<text> は no-copilot-bot と組み合わせる coverage downgrade 用 option で、指定する場合は両方をそろえる。
timeout / wait option
| 引数 | 動作 |
|---|---|
pause=15m |
PR target の Copilot bot wait に渡す |
per-agent-timeout=15m |
local reviewer ごとの timeout に渡す |
quiescence=8m |
Copilot bot activity の quiet period に渡す |
これらはユーザーが明示した場合だけ渡す。
外側 Agent が既定値を推測して explicit option に変換しない。
review=once では pause=、per-agent-timeout=、quiescence=、force-copilot-request を消費できないため停止する。
pr=none の standalone local mode では pause=、quiescence=、force-copilot-request、allow-disable-copilot-bot、disable-copilot-bot-reason= は使えない。
ask-user
ask-user は review finding の採否や返信方針の前にユーザー確認を挟む marker である。
Issue 不明点の初期確認は ask-user の有無に関係なく必ず行う。
ask-user がない場合、妥当な finding は自動で修正し、誤検出や scope 外は理由付きで rejected / nit として記録する。
E2E option
| 引数 | 動作 |
|---|---|
e2e=auto |
read-only discovery と readiness brief 作成後に evaluator で resolved mode を決める |
e2e=off |
E2E を実行しない |
e2e=pre-review |
実装、通常検証、PR 前 simplify 後、review に渡す前に E2E gate を実行する |
e2e=final |
review 収束後、完了報告前に E2E gate を実行する |
e2e=both |
pre-review と final の両方で E2E gate を実行する |
| 未指定 | requested_e2e_mode=auto として扱う |
auto は既存の e2e_mode に入れず、successful plan の resolved_e2e_mode だけを実行 gate に渡す。
E2E gate が needs_user_decision を返した場合は、ユーザー確認なしに実装、commit、push、PR 作成、完了報告へ進まない。
worktree option
| 引数 | 動作 |
|---|---|
worktree=on |
readiness gate 通過後に専用 git worktree を作成し、その worktree で branch 作成、実装、検証、commit、push、PR 作成を行う |
worktree=off |
明示された場合だけ current cwd で branch 作成と実装を行う |
| 未指定 | worktree=on として扱う |
worktree=on でも claim gate、read-only discovery、readiness gate が implement を返すまでは worktree を作らない。
github-issue-breakdown handoff artifact に worktree_mode がある場合は、直接指定された worktree=on|off と同じ正規化・停止条件で扱う。
停止する代表例
| 入力 | 停止理由 |
|---|---|
pr=none review=on agents=none |
PR も Copilot bot もなく、実行可能な review path がない |
pr=create agents=none no-copilot-bot / pr=draft agents=none no-copilot-bot |
local reviewer と Copilot bot の両方を無効化している |
review=simplify agents=codex |
review=simplify では agents=codex を消費できない |
review=once agents=claude |
one-shot reviewer MVP は agents=codex だけを許可する |
review=once agents=copilot |
one-shot reviewer MVP は agents=codex だけを許可する |
review=once agents=none |
one-shot reviewer selector と local reviewer skip intent が矛盾する |
review=once pause=15m |
pause= は one-shot reviewer では消費できない |
allow-disable-copilot-bot のみ |
no-copilot-bot がないため override の消費先がない |
no-copilot-bot allow-disable-copilot-bot |
downgrade 理由の disable-copilot-bot-reason=<text> がない |
no-copilot-bot disable-copilot-bot-reason=... |
downgrade 許可の allow-disable-copilot-bot がない |
review=simplify agents=none は冗長な local reviewer skip 指定として許可される。
no-copilot-bot は PR 後 Copilot bot gate の明示 opt-out として許可される。
review=once no-copilot-bot は PR 後 Copilot bot gate の明示 opt-out として許可する。
実行例
| 入力 | 何が起きるか |
|---|---|
/fix-github-issue 123 pr=create |
通常 PR を作成し、review mode は review=simplify 相当になる |
/fix-github-issue 123 pr=create agents=codex |
review=on に正規化し、Codex local reviewer と Copilot bot review を使う |
/fix-github-issue 123 pr=create agents=none |
local reviewer を使わず、PR target の Copilot bot review だけを期待する |
/fix-github-issue 123 pr=none agents=codex |
standalone local multi-review を使い、PR は作成しない |
/fix-github-issue 123 pr=create review=once e2e=final |
PR 前 simplify、Codex one-shot reviewer、PR 作成、Copilot bot review、final E2E の順に進む |
/fix-github-issue 123 pr=create worktree=off |
readiness gate 後も current cwd で実装する |