agent-dotfiles skill reference
agent-dotfiles の issue / review / PR 作業で使う主要 skill の入口、代表入力、停止条件、関連 docs を確認するための索引です。
詳細な実行 contract は agent-dotfiles repo の各 skill と review-orchestrator の stdout JSON / artifact を source of truth とします。
このページは agent-dotfiles/docs/issue-workflow-skills.md と
agent-dotfiles/docs/skills/*.md の要点を docs site 用に整理したものです。
skill 本体や source docs の不足修正はこのページでは扱いません。
個別 reference pages
使い分け
| やりたいこと | 使う skill | 代表入力 |
|---|---|---|
| 要求を Issue 化する | github-issue-breakdown |
/github-issue-breakdown agent=codex |
| Issue 作成後に first fix target まで進める | github-issue-breakdown -> fix-github-issue |
/github-issue-breakdown agent=codex continue-to-fix |
| 既存 Issue 1 件を実装する | fix-github-issue |
/fix-github-issue 123 pr=create review=on agents=codex |
| GitHub Issue なしで local plan から実装する | implement-from-plan |
/implement-from-plan pr=draft review=simplify |
| PR または local diff の review を収束させる | multi-review |
/multi-review 123 agents=codex |
| PR を作成する | create-pr |
pr=create または「PR を作成して」 |
| PR 本文を最新結果へ更新する | update-pr |
/update-pr 123 |
| E2E 実行可否と証跡を決める | e2e-workflow-gate |
e2e=final を実装系 skill に渡す |
共通の判断境界
agents=は local reviewer runtime の選択であり、GitHub PR 上のcopilot-pull-request-reviewerではありません。agents=copilotは GitHub Copilot CLI reviewer であり、Copilot bot review とは別経路です。no-copilot-botはユーザーが明示した場合だけ使う coverage override です。- 自然言語の要約だけで gate を通過扱いにせず、
review-orchestratorの stdout JSON、artifact、evidence manifest を判定根拠にします。 gates.review.required_actions、gates.validation.required_actions、gates.conflict.required_actionsが残る場合は未収束です。
fix-github-issue
既存 GitHub Issue 1 件を claim gate、read-only discovery、readiness gate、実装、検証、PR 前 simplify、必要な review、PR 作成まで進める入口です。
| 領域 | 代表引数 | 動作 |
|---|---|---|
| PR mode | pr=draft / pr=create / pr=none |
Draft PR、通常 PR、PR なし push を選ぶ |
| review mode | review=simplify / review=once / review=on |
PR 前 simplify、one-shot reviewer、multi-review を選ぶ |
| reviewer | agents=codex / agents=claude / agents=copilot |
local reviewer runtime を選ぶ |
| reviewer | agents=none |
local reviewer を起動しない |
| Copilot bot | no-copilot-bot |
PR target の Copilot bot review を起動しない |
| E2E | e2e=pre-review / e2e=final / e2e=both |
指定 timing で E2E gate を実行する |
停止する代表例:
pr=none review=on agents=none: PR も Copilot bot もなく、実行可能な review path がありません。pr=create 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だけを許可します。allow-disable-copilot-botのみ:no-copilot-botがないため override の消費先がありません。
github-issue-breakdown
要求を GitHub Issue として実装可能な粒度へ整理して起票する入口です。fix / continue-to-fix / implement が明示されない限り、実装へは進みません。
| 領域 | 代表引数 | 動作 |
|---|---|---|
| 起票前 validation | agent=auto / agent=codex / agent=claude / agent=copilot |
起票前 validation agent を選ぶ |
| 実装移行 | fix / continue-to-fix / implement |
Issue 作成後に first fix target を選び、実装へ進む |
| review handoff | review=simplify / review=once / review=on |
後続実装 skill へ review mode を渡す |
| E2E handoff | e2e=auto / e2e=off / e2e=final |
後続実装 skill へ E2E intent を渡す |
first fix target が複数または不明な場合、needs_human_selection として停止します。
review=off fix や multi-review continue-to-fix は handoff option として受け付けません。
implement-from-plan
GitHub Issue を作らず、local plan artifact を authoritative input として実装へ進む入口です。dummy Issue や hidden Issue は作りません。
| 観点 | fix-github-issue |
implement-from-plan |
|---|---|---|
| 入力 | GitHub Issue 1 件 | local plan artifact |
| claim gate | review-orchestrator issue prepare |
なし |
| readiness | issue readiness |
plan readiness |
| checkpoint | issue readiness-checkpoint |
plan readiness-checkpoint |
| 受け入れ条件 | Issue 本文 | plan JSON |
skip-validation を使っても、read-only discovery、plan JSON 作成、plan readiness、plan readiness-checkpoint は省略しません。
multi-review
PR または local diff を対象に、local reviewer、Copilot bot、validation、conflict、CI follow-up を gate として収束させる review workflow です。
| target | 入口 | 主な終了条件 |
|---|---|---|
| PR target | /multi-review 123 agents=codex |
Copilot bot、local reviewer、thread drain、CI follow-up、conflict gate が収束 |
| local target | /multi-review local agents=codex validation-command="go test ./..." |
local validation、local reviewer、conflict gate が収束 |
| pre-pr local target | 実装系 skill の review=on から呼ばれる |
PR 作成前または PR 後 push 前の local validation と local reviewer が収束 |
| 引数 | 意味 |
|---|---|
agents=codex / agents=claude / agents=copilot |
local reviewer を選ぶ |
agents=none |
PR target では Copilot bot review だけを期待する |
simplify=auto / simplify=full / simplify=off |
review loop 内の simplify coverage を制御する |
validation-command=<cmd> |
local validation command を明示する |
validation-profile=<path> |
repo-local validation profile を使う |
pre-pr local target では validation-command または validation-profile が必要です。
e2e-workflow-gate
E2E を実行するか、どの timing で実行するか、どの artifact を証跡にするかを決める gate です。
| 指定 | 意味 |
|---|---|
e2e=off / no-e2e |
E2E を実行しない |
e2e=auto |
auto policy evaluator に requested mode として渡す |
e2e=pre-review |
実装、通常 validation、PR 前 simplify 後、review に渡す前に実行する |
e2e=final / e2e=on / e2e |
review 収束後、完了直前に実行する |
e2e=both |
pre-review と final の両方で実行する |
local server、fixed port、simulator、external service、host-wide installed skill / config などの影響範囲が一意に決まらない場合は needs_user_decision として停止します。
create-pr
PR 作成時に必ず使う入口です。gh pr create --fill は使わず、diff とコミット履歴から reviewer が判断できる背景、判断、期待状態を書いてから PR を作成します。
PR 本文に含める要点:
- 変更前に何が困っていたか。
- この PR でどの状態になったか。
- reviewer が判断に迷いそうな設計判断や残リスク。
- 実行済みの検証、未実施の E2E、CI の状態。
pr-writing-review=auto|codex|claude|copilot|off は PR 本文 reviewer gate の指定であり、Issue validation の agent= や multi-review の agents= とは別物です。
update-pr
既存 PR のタイトルと本文を、現在の diff、commit、CI / review / E2E / 検証結果に合わせて更新する入口です。
更新が必要な例:
- PR 作成後に CI、review、E2E、追加検証の結果が確定した。
- 追加 commit により既存本文の背景、期待状態、検証欄が stale になった。
CI 未確認、review pending、これから確認しますのような暫定表現が残っている。