codex-plan-review

Files (1)

• SKILL.md

SKILL.md (first lines)

# Codex CLIを使ったplanファイルレビュー

planファイルの実現可能性、技術的妥当性、抜け漏れやリスクについて、Codex CLIを使って客観的にレビューします。

## 実行手順

<important>

- レビューループ（最大5回）によりコンテキストが大きくなる場合があります。コンテキスト使用量に注意してください。

</important>

<procedure>

### 1. 開発日誌の取得（コンテキストにある場合）

会話のコンテキスト内にesa URLの開発日誌が言及されている場合、以下の手順で取得してください：

#### 1.1 post番号の抽出

esa URLからpost番号を抽出（例：`https://yasuhisa.esa.io/posts/1234` → `1234`）

#### 1.2 YAMLの直接取得

`esa-llm-scoped-guard fetch` コマンドでYAMLを直接取得：

```bash
esa-llm-scoped-guard fetch -post <post_number> | tee .claude_work/dev_diary.yaml
```

**成功の場合**: YAMLが `.claude_work/dev_diary.yaml` に保存されるので、次のステップへ進む

**失敗の場合**: エラーメッセージをユーザーに報告し、このステップをスキップ

開発日誌がコンテキストにない場合は、このステップ全体をスキップしてください。

### 2. planファイルの特定と最新化

#### 2.1 planファイルの取得

`.claude_work/plans/`配下からplanファイルを取得してください：

```bash
ls .claude_work/plans/*.md
```

git worktree運用のため、単一のplanファイルが存在する前提です。

このファイルパスを以下のように定義します：

<plan-file>

```
<取得したplanファイルのパス>
```

</plan-file>

#### 2.2 planファイルの最新化チェック

**重要**: Codexはplanファイルに基づいてレビューするため、planファイルが最新でないと意味がない

1. planファイルを読み取る

2. 会話コンテキスト（開発日誌が取得されている場合はその内容も含む）と比較し、以下の観点で確認：
   - **前提条件**: ユーザーとの会話や開発日誌で決まった技術選択・制約がplanに含まれているか
   - **仕様変更**: 当初の要件から変更された点がplanに反映されているか
   - **新規決定事項**: 会話中や開発日誌に記載された実装方針・アプローチがplanに含まれているか
   - **削除された要件**: もはや不要になった要件がplanから削除されているか

3. **差分がある場合**:
   - 差分内容（追加・修正・削除すべき箇所）を具体的にユーザーに提示
   - 修正可否を確認し、ユーザー承認後にplanファイルを修正（Editツール使用）

4. **差分がない場合**: 次のステップへ進む

#### 2.3 ユーザー発言ログとの整合性確認

`.claude_work/user_prompts.txt` が存在する場合、planファイルのユーザー発言ログセクションに書き漏れがないか確認する：

1. `.claude_work/user_prompts.txt` を読み取る
2. planファイルの「ユーザー発言」セクション（生ログ・要約）と突き合わせる
3. 以下の観点で確認：
   - ユーザーが明示的に要件・制約として述べた内容がplanに反映されているか
   - ユーザーの意図や方針決定が漏れていないか
4. **書き漏れがある場合**: 漏れている内容を具体的にユーザーに提示し、planへの反映要否を確認

### 3. Codex CLIでのレビュー実行

Bash経由で`copilot --model gpt-5.3-codex`を使ってレビューを実行してください。

**重要**:
- コマンドはリポジトリルートで実行すること（相対パスが前提）
- **プロンプトは必ず `Edit`ツールで `.claude_work/review_prompt.md` に書き出してから `cat` でパイプすること**

<example>

**開発日誌がない場合の例：**

1. `Edit`ツールで `.claude_work/review_prompt.md` を作成：

```markdown
以下のplanファイルを日本語でレビューしてください。

## レビュー対象
- planファイル: <plan-fileタグで定義されたパス>
- ユーザー発言ログ: .claude_work/user_prompts.txt（存在する場合）

## レビュー方針
- **時間をかけてコードベースを徹底的に読むこと**
- planファイルで言及されているファイルや関連ファイルはすべて確認すること
- 網羅的にレビューし、指摘漏れがないようにすること
- 各観点について具体的なコード箇所を参照しながらレビューすること
- **レビュー結果が網羅的で一度に多くなっても構わない**（指摘は詳細かつ具体的に）

## レビューの観点

### 1. 実現可能性・技術的妥当性
- planで述べられている実装方針は技術的に実現可能か

From syou6162/agent-skills, MIT.

More from syou6162/agent-skills