implement-from-plan reference
implement-from-plan は、GitHub Issue を作らず local plan artifact を authoritative input として実装へ進む入口である。
Issue 作成だけを省略し、read-only discovery、plan validation、readiness gate、re-plan checkpoint、実装、PR 前 simplify、必要な review、PR 作成の gate は維持する。
詳細な plan schema と gate は no-Issue implementation flow contract と claude/skills/implement-from-plan/SKILL.md を source of truth とし、この文書は利用者向けの引数早見表として扱う。
fix-github-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 |
| Issue 更新 | 必要に応じて Issue 側へ戻す | plan 更新またはユーザー確認へ戻す |
implement-from-plan は dummy Issue や hidden Issue を作らない。
fix-github-issue を内部的に呼ぶ入口でもない。
plan validation
| 引数 | 動作 |
|---|---|
agent=auto |
plan validation agent を自動選択する |
agent=codex / agent=claude / agent=copilot |
plan validation agent を明示する |
config=<path> |
validation agent の設定を渡す |
worker-mode=one-shot / worker-mode=prefer |
validation worker の起動方式を選ぶ |
worker-helper=<path> |
validation worker helper を明示する |
worker-project-path=<path> |
validation worker の作業 repo path を明示する |
claude-mcp=off / claude-mcp=on |
Claude validation で MCP を使うかを指定する |
skip-validation |
別 Agent validation だけを省略する。readiness gate は省略しない |
skip-validation を使っても read-only discovery、plan JSON 作成、plan readiness、plan readiness-checkpoint は省略しない。
shared implementation options
PR mode、review mode、local reviewer / Copilot bot、timeout / wait、ask-user、E2E option の基本解釈は fix-github-issue reference と同じである。
この skill 固有の差分だけを以下に示す。
| 領域 | implement-from-plan 固有の差分 |
|---|---|
| PR body | plan、plan readiness、検証、simplify、必要な review / E2E の結果を reviewer 向けに要約する |
| E2E auto | plan JSON 作成後に evaluator を呼び、successful plan の resolved_e2e_mode だけを実行 gate に渡す |
| worktree | 未指定時は worktree=on。plan readiness 通過後に専用 git worktree を作成し、worktree=off 明示時だけ current cwd で作業する |
ask-user |
review finding の採否 marker であり、plan の不明点や readiness gate の ask_user とは別扱い |
| readiness stop | readiness が ask_user の場合、plan 更新またはユーザー確認なしに実装へ進めない |
実行例
| 入力 | 何が起きるか |
|---|---|
/implement-from-plan pr=draft |
local plan を作り、validation と readiness 後に Draft PR を作成する |
/implement-from-plan skip-validation pr=create review=simplify |
別 Agent validation だけを省略し、readiness と PR 前 simplify は実行する |
/implement-from-plan pr=create agents=codex,copilot |
review=on に正規化し、複数 local reviewer と Copilot bot review を使う |
/implement-from-plan pr=create agents=none |
local reviewer を使わず、PR target の Copilot bot review だけを期待する |
/implement-from-plan pr=none agents=codex e2e=off |
PR なしで local multi-review を使い、E2E は実行しない |
/implement-from-plan pr=create worktree=off |
readiness 後も current cwd で実装する |