155c08facf
* docs(#2197): drop --validate docs for /gsd-plan-phase and /gsd-execute-phase These two commands never parse --validate (silent no-op); the flag is real only for /gsd-quick. Remove the false flag-table rows and CLI examples across COMMANDS.md and the how-to guides (en + ja-JP/zh-CN/ ko-KR/pt-BR mirrors), and correct the manager.flags.execute example from --validate to --cross-ai (a flag execute-phase actually parses). /gsd-quick's real --validate docs are left untouched. Ref #2197 * docs(#2197): add changeset for --validate docs removal --------- Co-authored-by: CI Rebase Check <ci@gsd-redux>
4.7 KiB
フェーズの実行方法
目的: プランニング済みのフェーズをウェーブベースの並列実行で処理し、各プランをアトミックな git コミットとしてランディングさせます。
前提条件: フェーズに少なくとも 1 つの PLAN.md ファイルがあること。プランニングがまだ完了していない場合は、先に /gsd-plan-phase N を実行してください — フェーズのプランニング を参照。
フェーズ全体を実行する
/gsd-execute-phase 1
GSD はフェーズのプランファイルを読み込み、依存関係ウェーブにグループ化し、プランごとに新鮮なエグゼキュータエージェントを起動します。各エグゼキュータは次のウェーブが始まる前にアトミックにコミットします。
エージェントがディスパッチされる前に、GSD はウェーブテーブルを表示します:
## Execution Plan
Phase 1: Core middleware — 3 plans across 2 wave(s)
| Wave | Plans | What it builds |
|------|----------------|---------------------------|
| 1 | 01-01, 01-02 | Core validation function |
| 2 | 01-03 | Express middleware wrapper |
ウェーブ 1 のプランは並列実行されます（それぞれ独立した git ワークツリーで）。ウェーブ 2 はウェーブ 1 のすべてのコミットがマージされるまで待機します。
基礎となるエージェント調整モデルについては マルチエージェントオーケストレーション を参照してください。
単一ウェーブのみ実行する
ウェーブ 1 の出力を確認してからウェーブ 2 に進むなど、1 つのウェーブのみを実行したい場合は --wave N を使用します:
/gsd-execute-phase 1 --wave 2
GSD はウェーブ 2 のプランのみを実行します。実行前に前のウェーブがすべて完了しているか確認します。ウェーブ 1 のプランがまだ未完了の場合は、先に前のウェーブを完了するよう指示して停止します。
停止した実行を再開する
クォータエラー、ネットワーク切断、セッションのクラッシュなどで実行が途中停止した場合、ウェーブレベルの進捗は保持されています。GSD は各プランの SUMMARY.md ファイルを確認し、すでに存在するプランは再実行時に自動的にスキップされます:
/gsd-execute-phase 1
GSD は SUMMARY.md がすでに存在するプランをスキップし、最初の未完了プランから再開します。
コミットは存在するが SUMMARY.md がない場合（エグゼキュータはコミットしたが、セッションが終了する前にサマリーを書き込まなかった）、GSD はセーフ再開ゲートを表示し、3 つの選択肢を提示します:
close out manually— コミットを確認し、SUMMARY.mdを書き込んで再実行するre-execute from scratch— 部分的なコミットを差し戻すか上書きしてから新しいエグゼキュータをディスパッチするmark-and-skip— 異常を記録して次に進む（明示的な確認が必要）
体系的な障害診断については 実行失敗のデバッグ を参照してください。
出力の場所
すべてのウェーブが完了すると、フェーズディレクトリには以下が含まれます:
.planning/phases/01-<name>/
01-01-SUMMARY.md # プラン 01 が構築したもの、主要ファイル、逸脱
01-02-SUMMARY.md
01-03-SUMMARY.md
VERIFICATION.md # 要件ごとの合格/不合格状態
STATE.md と ROADMAP.md はすべてのウェーブが完了すると自動的に更新されます。VERIFICATION.md はフェーズが完全に完了した時のみ書き込まれます。
Git の履歴には、各エグゼキュータからのタスクごとのコミットと、オーケストレータからのトラッキングコミットが表示されます。
クロス AI 実行
workflow.cross_ai_command で設定された外部 AI CLI（Codex、Gemini など）に実行を委任するには:
/gsd-execute-phase 2 --cross-ai
設定でクロス AI が有効であってもローカル実行を強制するには:
/gsd-execute-phase 2 --no-cross-ai