plan-execute

Plan Execute スキル

目的

ユーザーが /plan-execute {plan-file-path} を実行すると、「オーケストレーションによる計画実行」ワークフローを開始します。

1. 私（Claude Code）が Codex に計画に沿ってコードを実装するよう依頼します。
2. Codex の作業完了後、生成されたコードをレビューします。
3. reviews/ ディレクトリにレビューを書き込み、Codex に問題を調査して修正するよう依頼します。
4. コード品質の基準を満たすまで繰り返します。

基本原則：私はコードを自分で書いたり編集したりしません。行うのはコードのレビューと Codex のオーケストレーションだけです。実装や修正を含むすべてのコード変更は、Codex が行います。

使用方法

/plan-execute plans/my-feature-plan.md

セッションの再利用

Codex を呼び出すたびに、スクリプトの出力から session_id=xxx を抽出し、現在のタスクのセッション ID として保存します。同じタスクで後から Codex を呼び出す際は --session <id> を渡してコンテキストを再利用し、Codex がコードベース全体を毎回読み直さずに、過去の実装や修正の履歴を把握できるようにします。

私のワークフロー（Claude Code）

ステップ 1：計画を読み、実行手順に分割する

指定された計画ファイルを読み、以下を把握します。

• 計画の全体的な目標と範囲
• 作成または変更するファイルの一覧
• 実装手順の順序
• 関連するプロジェクト規約、特に CLAUDE.md の内容

計画にチェックリスト（- [ ] / - [x]）が含まれている場合は、その項目を実行単位として使用します。 明確な手順が定義されていない場合は、1 バッチあたりのファイル変更数が 5 件以下になるよう、妥当な単位に作業を分割します。

ステップ 2：Codex にコードの実装を依頼する

/codex スキルを使用し、以下の指示を Codex に伝えます。

Implement the code according to the plan in {plan-file-path}.

Current execution scope: {specific step or batch description}

Requirements:
- Follow the design in the plan exactly. Do not improvise beyond it.
- Obey the Code Quality Hard Limits defined in `CLAUDE.md`.
- Single file <= 800 lines, single function <= 50 lines, nesting <= 3 levels
- Run `pnpm build` after implementation to confirm compilation succeeds
- If the plan includes a checklist, mark completed steps as `[x]`

After implementation, list all changed files and provide a summary of each change.

ステップ 3：Codex の出力をレビューする（私の主な責任）

Codex の作業完了後、コードレビューを行います。重要：コードを読み、レビューを書くことだけを行います。ソースファイルを直接変更することはありません。

1. 変更されたすべてのファイルを読み、1 つずつレビューします。
2. 計画と照らし合わせ、実装が意図された設計に合っていることを確認します。
3. 以下を含め、コード品質を確認します。
   • コード品質の厳格な制限に違反していないか
   • セキュリティリスクが生じていないか
   • エラーハンドリングが不足していないか
   • 命名や構成が明確か
   • 既存のプロジェクトパターンに従っているか
4. pnpm build を実行し、コンパイル状況を確認します。

ステップ 4：レビューを書き、修正を Codex に依頼する

レビューを reviews/{topic}-review.md に追記します（plan-review と共有）。

---

## Code Review Round {N} — {YYYY-MM-DD}

**Scope**: {code scope covered in this review}
**Build Status**: PASS / FAIL

### Issues

#### Issue 1 ({severity}): {title}
**File**: {file-path:line}
{issue description}
**Fix**: {specific fix recommendation}

...

### Verdict: NEEDS_FIX / APPROVED

Verdict: NEEDS_FIX の場合、自分で編集するのではなく、/codex を呼び出して Codex に問題を修正させます。

Read the latest Code Review round in {review-file-path}.
Check each issue one by one. Fix the valid issues, and explain why any disputed item is not actually a problem.
After making fixes, run `pnpm build` to confirm compilation succeeds.
List the issues that were fixed and the corresponding code changes.

Verdict: APPROVED の場合は、ステップ 6 に進みます。

ステップ 5：修正を確認し、繰り返す

Codex が修正を適用した後も、コードを直接編集せず、再度レビューします。

• 各問題が実際に修正されたか確認します
• 修正によって新たな問題が生じていないか確認します
• 問題が残っている場合は、新しいレビューを作成して Codex に再度修正を依頼します（ステップ 4 を繰り返します）
• すべて問題がなければ、レビューを Verdict: APPROVED とします

ステップ 6：計画の進捗を更新する

各バッチが完了したら、計画ファイルのチェックリストを更新する（- [ ] -> - [x]）よう Codex に依頼します。 未完了の手順が残っている場合は、次のバッチに進むためステップ 2 に戻ります。 すべての作業が完了したら、締めくくりに進みます。

ステップ 7：締めくくり

以下の内容をユーザーに報告します。

• 完了した手順
• 必要だったコードレビューの回数
• 修正した主な問題
• 最終的なビルド状況
• 変更したファイルの一覧
• レビューログファイルのパス

レビューの重要度レベル

レベル	意味	修正必須
重大	実行時エラーまたはセキュリティ上の脆弱性を引き起こします	はい
高	プロジェクトの規約に違反する、または明らかな設計上の欠陥があります	はい
中	改善すべきコード品質の問題です	推奨
低	スタイルまたは好みに関する問題です	任意
提案	最適化に関する提案です	任意

判定ルール：

• 重大または高の問題が1つでもある場合 -> NEEDS_FIX
• すべての問題が中以下の場合 -> 任意の改善メモを添えて APPROVED

ファイル規約

• plan-review と同じレビュー用ファイルを共有します：reviews/{topic}-review.md
• {topic} は、プランファイル名から .md を除いたものです
• プランレビューとコードレビューの両方のラウンドを同じファイルに追記します
• 見出しで区別します：プランレビューには ## Round {N}、コードレビューには ## Code Review Round {N} を使用します