Skip to content
cccskills
FreePublished on GitHub

plan-review

Codex、Gemini、Claude の3つの AI で Plan ファイルを並列レビュー。実装計画の妥当性、抜け漏れ、リスクを分析する。Plan 作成後に呼び出す。

The English summary is being prepared. Showing the original description.

Works withGemini
See how to install

Files included (6)

  • SKILL.md6.3 KB
  • .gitignore9 B
  • scripts/claude-plan-review.sh1.9 KB
  • scripts/codex-plan-review.sh1.9 KB
  • scripts/gemini-plan-review.sh1.9 KB
  • scripts/run-plan-review.sh3.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Plan Review

Codex、Gemini、Claude を使って Plan ファイルを並列レビューし、実装前に計画の品質を確認する。

呼び出し方法

/plan-review <plan_file_path>

または Plan モード終了直後に:

/plan-review

(直前に作成した Plan ファイルを自動検出)

実行手順(Claude Code が実行)

  1. Plan ファイルを特定

    • 引数でパスが指定されていればそれを使用
    • 指定がなければ docs/plans/ から最新のファイルを使用
  2. Codex + Gemini を並列実行

    .claude/skills/plan-review/scripts/run-plan-review.sh <plan_file>
    
  3. Claude レビューを並列実行

    • Task ツールで Claude サブエージェントを起動
    • 結果を results/<timestamp>/claude_review.md に保存
  4. 結果を読み取り・統合レポート生成

    • 3つの AI のレビュー結果を読み取り
    • 統合レポートを results/<timestamp>/report.md に保存
    • ユーザーに結果を報告

スクリプト一覧

スクリプト説明
scripts/run-plan-review.shCodex + Gemini を並列実行(メイン)
scripts/codex-plan-review.shCodex 単体で Plan レビュー
scripts/gemini-plan-review.shGemini 単体で Plan レビュー

Claude レビュー(Task ツール使用)

Claude Code の Task ツールでサブエージェントを起動:

Task tool パラメータ:
- subagent_type: "general-purpose"
- prompt: |
    以下の実装計画(Plan)をレビューしてください。

    対象ファイル: <plan_file_path>

    ## レビュー観点

    ### 1. 実装計画の妥当性
    - 要件に対して計画が適切か
    - 技術選定は妥当か
    - アーキテクチャ設計に問題はないか

    ### 2. 抜け漏れ
    - 考慮すべきエッジケースはないか
    - エラーハンドリングは考慮されているか
    - テスト計画は十分か

    ### 3. リスク
    - 実装上のリスクはないか
    - パフォーマンスへの影響はないか
    - セキュリティ上の懸念はないか

    ### 4. 改善提案
    - より良いアプローチはないか
    - 既存コードとの整合性は取れているか

    ## 出力形式

    ### 計画の妥当性
    [評価とコメント]

    ### 抜け漏れ・懸念点
    - [項目1]: 説明

    ### リスク
    - [リスク1]: 説明と対策案

    ### 改善提案
    - [提案1]: 説明

    ### 総合評価
    [S/A/B/C/D の5段階評価と理由]

重要: Task ツールの結果を claude_review.md に Write ツールで保存すること。

コマンドオプション

オプション説明例
-c, --codex-onlyCodex のみ実行--codex-only plan.md
-g, --gemini-onlyGemini のみ実行--gemini-only plan.md
-n, --name NAMEディレクトリ名を指定--name my-feature
-h, --helpヘルプを表示

出力先

.claude/skills/plan-review/results/
└── 20250205_120000/
    ├── codex_review.md   # Codex のレビュー結果
    ├── gemini_review.md  # Gemini のレビュー結果
    ├── claude_review.md  # Claude のレビュー結果(Claude Code が生成)
    └── report.md         # 統合レポート(Claude Code が生成)

レビュー観点

3つの AI は以下の観点で Plan をレビューする:

1. 実装計画の妥当性

  • 要件に対して計画が適切か
  • 技術選定は妥当か
  • アーキテクチャ設計に問題はないか

2. 抜け漏れ

  • 考慮すべきエッジケースはないか
  • エラーハンドリングは考慮されているか
  • テスト計画は十分か

3. リスク

  • 実装上のリスクはないか
  • パフォーマンスへの影響はないか
  • セキュリティ上の懸念はないか

4. 改善提案

  • より良いアプローチはないか
  • 既存コードとの整合性は取れているか

統合レポートの生成

Claude Code が以下の形式で統合レポートを生成し、必ずファイルに保存する:

出力先: .claude/skills/plan-review/results/<timestamp>/report.md

# Plan Review Report

## 概要
- **対象 Plan**: [ファイルパス]
- **レビュー AI**: Codex, Gemini, Claude
- **日時**: [YYYY-MM-DD HH:MM]

## 評価サマリー

| AI | 総合評価 | 主な指摘 |
|----|---------|---------|
| Codex | [S/A/B/C/D] | [1行サマリー] |
| Gemini | [S/A/B/C/D] | [1行サマリー] |
| Claude | [S/A/B/C/D] | [1行サマリー] |

## 共通して指摘された懸念点
[3つの AI が共通して指摘した問題]

## AI 固有の視点

| AI | 独自の指摘 |
|----|-----------|
| Codex | [Codex 独自の視点] |
| Gemini | [Gemini 独自の視点] |
| Claude | [Claude 独自の視点] |

## 改善提案の優先度(統合)

| 優先度 | 改善項目 | 指摘 AI |
|--------|---------|--------|
| 高 | [項目] | Codex, Gemini, Claude |
| 中 | [項目] | Gemini, Claude |
| 低 | [項目] | Codex |

## 推奨アクション
1. [最優先で対応すべき項目]
2. [次に対応すべき項目]
3. [余裕があれば対応する項目]

使用例

# 基本: Plan ファイルを3つの AI でレビュー
/plan-review docs/plans/my-feature.md

# Codex + Gemini のみ(スクリプト直接実行)
.claude/skills/plan-review/scripts/run-plan-review.sh docs/plans/my-feature.md

# Codex のみ
.claude/skills/plan-review/scripts/run-plan-review.sh --codex-only docs/plans/my-feature.md

# Gemini のみ
.claude/skills/plan-review/scripts/run-plan-review.sh --gemini-only docs/plans/my-feature.md

注意事項

  1. 並列実行: Codex と Gemini はスクリプトで並列実行、Claude は Task ツールで実行
  2. 認証: Codex、Gemini は事前にログイン済みであること
  3. 結果保存: Claude レビュー結果は Write ツールでファイル保存が必要
  4. results/ は .gitignore に追加済み

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

This skill should be used when the user asks to "create a team", "spawn agents", "parallel execution", "delegate tasks to agents", "use a swarm", "team workflow", "split work across agents", "run tasks in parallel", or mentions wanting multiple agents to collaborate on a complex task.

The English summary is being prepared. Showing the original description.

sean-sunagaku/claude-code-plugin38Updated Jul 30, 2026

Agent Teams スキルを設計・構築するためのベストプラクティスガイド。 サブエージェント定義、SendMessage 通信プロトコル、タスク依存管理、 PostToolUse Hook によるログ、MCP ツール統合、コンテキストファイル設計を網羅。 7つの実績あるチームスキル(app-naming, ui-review, logo-design, persona-creation, skill-creator-team, ui-variations, aso-optimize)から抽出したパターン集。 Use when: Agent Teams を使ったスキルを新規作成したい、 既存のチームスキルの品質を改善したい、エージェント間通信のデバッグ、 チームスキルの設計パターンを知りたい。 Triggers: "agent team", "チームスキル", "エージェントチーム", "サブエージェント定義", "SendMessage パターン", "チーム設計", "エージェント間通信", "team skill", "swarm pattern"

The English summary is being prepared. Showing the original description.

sean-sunagaku/claude-code-plugin38Updated Jul 30, 2026

アプリ名・サービス名の命名を、5つの専門エージェントチームで多角的に評価・決定するスキル。 ブランディング、商標/法的リスク、デジタルプレゼンス(SEO/ASO/SNS)、国際展開(多言語/発音)の 4観点から候補を提案・調査・議論し、コンテキストファイルと議事録で次回セッションへ引き継ぐ。 Use when: アプリ名を決めたい、サービス名を変更したい、プロダクト名を検討したい、 ネーミングブレスト、名前の商標チェック、アプリ名のリネーム。 Triggers: "アプリ名", "サービス名", "プロダクト名", "ネーミング", "名前を決め", "リネーム", "rename", "app name", "naming", "ブランド名", "商標チェック"

The English summary is being prepared. Showing the original description.

sean-sunagaku/claude-code-plugin38Updated Jul 30, 2026

App Store プレビュー動画を Remotion (React) で生成する Agent Team スキル。 video-director が構成を設計し、script-writer がナレーション台本を作成し、 motion-designer が Remotion コードを実装し、preview-reviewer がコードレビューし、 frame-inspector がレンダリング結果を目視検証する。 Use when: App Store プレビュー動画を作りたい、アプリのプロモーション動画を作りたい、 Remotion で動画を生成したい。 Triggers: "プレビュー動画", "App Store 動画", "アプリ動画", "preview movie", "Remotion", "動画作成", "app preview"

The English summary is being prepared. Showing the original description.

sean-sunagaku/claude-code-plugin38Updated Jul 30, 2026

アプリのトーン&マナー(トンマナ)を8名のエージェントチームで設計するスキル。 ブランドアーキタイプ・パーソナリティ定義から、カラー・タイポグラフィ・ビジュアルスタイル・ トーン・オブ・ボイスまでを一貫設計し、Pencil (.pen) + Markdown で成果物を出力する。 「デザインテンション」(矛盾ペア)を核に、AIっぽくない独自のブランドアイデンティティを生成する。

The English summary is being prepared. Showing the original description.

sean-sunagaku/claude-code-plugin38Updated Jul 30, 2026

仕様書・要件定義からソフトウェアアーキテクチャを設計するスキル。 5人の専門エージェント(Architecture Lead・Module Designer・Dependency Analyst・ Platform Expert・Devil's Advocate)が協議しながら、 モジュール分割・依存関係・データフロー・インターフェース設計を行う。 成果物は構造化されたアーキテクチャ設計書(Markdown)。 Use when: 仕様書からどう設計するか迷っている時、モジュール分割の方針を決めたい時、 技術スタックに合ったアーキテクチャパターンを選びたい時、 設計書を作成したい時。 Triggers: "アーキテクチャ設計", "arch design", "仕様書から設計", "モジュール分割", "設計書を作りたい", "アーキテクチャを考えて", "コンポーネント設計", "依存関係を設計", "どう設計する", "design the architecture", "design from spec"

The English summary is being prepared. Showing the original description.

sean-sunagaku/claude-code-plugin38Updated Jul 30, 2026

See all skills by sean-sunagaku

Report a problem with this skill