Claude Opusが作成した実装計画をCodex CLIに委譲し、GPT-5.4による計画レビュー→GPT-5.4-miniによる実装（複雑部分はGPT-5.4）→GPT-5.4によるテスト→Claude Opusによる最終チェックの多段パイプラインで実行するスキル。単一セッション版とcmux分割版の2モードを提供。個々のエラーに対して最大3回リトライ。トリガー：「実装委譲」「Codexで実装」「codex impl」「GPTで実装」「実装を任せて」「コード生成」「impl delegate」「パイプライン実装」。research-plan-implementで計画完了後の実装フェーズで自動適用を推奨。
Claude Opus が作成した実装計画を Codex CLI に委譲し、GPT-5.4 / GPT-5.4-mini によるコスト最適な多段パイプラインで実装を完結させるスキル。
1つのターミナルで全フローを実行。シンプルに使いたい場合に推奨。
run_pipeline.sh # 全フロー実行
run_pipeline.sh --approved # 人間チェック済みで即実行
3つのターミナルで役割を分担。各セッションの出力が見やすく、手動介入しやすい。
# ターミナル1: Planner（Opus PM）
run_pipeline.sh --mode planner
# ターミナル2: Engineer（Codex）
run_pipeline.sh --mode engineer
# ターミナル3: Reviewer（Opus Review）
run_pipeline.sh --mode reviewer
セッション間は .ai/ ディレクトリ内のファイルとシグナルで自動連携。
| 役割 | AI | 担当範囲 |
|---|---|---|
| PM | Claude Opus | 計画作成（初回のみ）+ 最終レビュー |
| Senior Engineer | GPT-5.4 | 計画レビュー + 複雑タスク + テスト |
| Junior Engineer | GPT-5.4-mini | 単純タスクの並列実装 |
| Human | ユーザー | 計画の承認（対話的修正可） |
--max-retries で変更可）--max-iterations で変更可）Opus計画作成 → 人間承認 → Codex実装 → Opusレビュー
↓ NEEDS_WORK
フィードバック生成
↓
Codex再実装 → Opusレビュー (max 3回)
[Planner] [Engineer] [Reviewer]
計画作成 待機中... 待機中...
人間承認
→ .ai/plan.md
→ signal: plan-ready
plan-ready検出
Codex実装
→ .ai/impl-report.md
→ signal: impl-ready-1
impl-ready-1検出
Opusレビュー
→ APPROVED → signal: review-done-1
→ NEEDS_WORK
→ .ai/codex-feedback-1.md
→ signal: feedback-ready-1
feedback-ready-1検出
Codex再実装
...（最大3回ループ）
codex コマンドがインストール済み（npm install -g @openai/codex）codex login で OpenAI アカウント認証済みclaude CLI がインストール済みgh CLI のインストールと認証が必要.ai/ 引き継ぎディレクトリ作成plan.md の内容を人間が確認。4つの選択肢:
| 選択 | 動作 |
|---|---|
y | 承認して続行 |
e | エディタで手動編集 |
c | Claude Opus に対話的に修正を依頼（最大5ラウンド） |
n | 中止 |
--approved フラグで人間チェックをスキップ可能。
- [ ] ...）を解析--worktree 有効時は各タスクを独立した git worktree で実行claude -p で非対話的に実行（Opus トークンは呼び出し時のみ消費）PIPELINE_REVIEW: APPROVED or PIPELINE_REVIEW: NEEDS_WORKREWORK_TASK 行でタスクごとの修正指示を出力.ai/pipeline-summary.md）.ai/ ディレクトリ）| ファイル | 方向 | 内容 |
|---|---|---|
plan.md | Opus → Codex | 実装計画（人間承認済み） |
impl-report.md | Codex → Opus | 実装結果レポート |
review-feedback-N.md | Opus → Codex | レビュー結果（N=イテレーション番号） |
codex-feedback-N.md | Opus → Codex | Codex用に構造化したフィードバック |
pipeline-summary.md | 最終出力 | パイプライン完了サマリ |
failure-report.md | エラー時 | 失敗レポート（人間向け） |
.signal-* | セッション間 | cmuxモードのシグナルファイル |
# 基本（plan.md を使って全フロー実行）
bash <skill-path>/scripts/run_pipeline.sh
# plan.md を指定して即実行（人間チェック済み）
bash <skill-path>/scripts/run_pipeline.sh --plan my-plan.md --approved
# ドライラン
bash <skill-path>/scripts/run_pipeline.sh --dry-run
# テストスキップ、リトライ上限変更
bash <skill-path>/scripts/run_pipeline.sh --skip-test --max-retries 5
# 3つのターミナルでそれぞれ起動
bash <skill-path>/scripts/run_pipeline.sh --mode planner
bash <skill-path>/scripts/run_pipeline.sh --mode engineer
bash <skill-path>/scripts/run_pipeline.sh --mode reviewer
# ポーリング間隔とタイムアウトを調整
bash <skill-path>/scripts/run_pipeline.sh --mode engineer --poll-interval 10 --poll-timeout 7200
# run_codex_impl.sh を直接使う（パイプラインなしで実装のみ）
bash <skill-path>/scripts/run_codex_impl.sh --plan plan.md
bash <skill-path>/scripts/run_codex_impl.sh --plan plan.md --skip-review --worktree
bash <skill-path>/scripts/run_codex_impl.sh --prompt "src/auth.ts にJWT検証を追加" --dry-run
--mode <mode> 実行モード: all(デフォルト), planner, engineer, reviewer
--plan <file> plan.md パス (デフォルト: .ai/plan.md)
--handoff-dir <dir> 引き継ぎディレクトリ (デフォルト: .ai)
--max-iterations <N> フィードバックループ最大回数 (デフォルト: 3)
--max-retries <N> 個々のエラーの最大リトライ回数 (デフォルト: 3)
--approved 人間チェック済みとしてスキップ
--skip-plan-review 計画レビューをスキップ
--skip-test テストをスキップ
--impl-model <model> 実装モデル (デフォルト: gpt-5.4-mini)
--review-model <model> レビューモデル (デフォルト: gpt-5.4)
--test-model <model> テストモデル (デフォルト: gpt-5.4)
--claude-model <model> Claude CLI モデル (デフォルト: opus)
--allow-dirty ダーティ状態を許可
--auto-escalate 自動エスカレーション
--no-worktree worktree を使わない
--dry-run プロンプト確認のみ
--poll-interval <secs> cmuxモードのポーリング間隔 (デフォルト: 5)
--poll-timeout <secs> cmuxモードのタイムアウト (デフォルト: 3600)
| スキル | 役割 | 連携タイミング |
|---|---|---|
| research-plan-implement | 実装計画の作成 | plan.md の入力ソース |
| codex-test-delegate | テスト実行 | Phase 2（Codex実装）内でテスト実行 |
| git-ops | コミット・PR作成 | パイプライン完了後 |
| implementation-rules | コーディング規約 | 実装プロンプトに規約を付与 |
--full-auto モードはサンドボックス内で実行されるが、ワークスペースへの書き込みは有効git stash または git commit でバックアップを取ることを推奨.ai/ ディレクトリを参照するため、同じ Git リポジトリ内で起動すること