doc-review-external

name	doc-review-external
argument-hint	[--claude|--codex|--gemini] [-a|--adversarial] <file_path>
description	user invoke only
summary	ユーザが明示的に呼び出します。外部プロセスを使用してドキュメントをレビューし、タスクを作成します。

指定されたファイルを外部プロセス（codex または claude または gemini）を使ってレビューし、レビュー結果を評価してください。修正の必要があれば、タスク化してください。

【重要】 引数 {{args}} を解析し、使用するツール（デフォルトは codex）と対象ファイルを特定してください。

【手順】

1. 引数の解析とファイルの確認:

   • ツールの特定:
     • {{args}} に --claude が含まれる場合は claude を使用します。
     • {{args}} に --gemini が含まれる場合は gemini を使用します。
     • {{args}} に --codex が含まれる場合、またはどちらも指定されていない場合は codex を使用します。
   • モードの判定:
     • {{args}} に -a または --adversarial が含まれる場合は Adversarial Review モードとします。
   • 対象ファイルの特定:
     • {{args}} からオプションフラグ（--claude, --codex, --gemini, -a, --adversarial）を除いた部分をファイルパスとします。
     • 指定されたファイルが存在することを確認してください。

2. 外部レビューの実行:

   • 位置づけの特定: レビュー対象ドキュメントの位置づけ（探索メモ / 調査レポート / 設計書 / 実装インプット / 公開文書 等）・読者・次工程を、依頼コンテキストから特定してください。不明な場合はユーザに確認してください。位置づけを渡さないと、レビュアーが「実装インプットとしての完全性」等の想定外の基準で重大度を判定し、ブロック判定が過剰・過小になります。

   • 特定したツール（codex または claude または gemini）を使用して、以下の指示でレビューを実行してください。

   • 指示内容:

     以下のドキュメントを [判定したモードに応じて "Adversarial Review" または "レビュー"] してください。
     
     【ドキュメントの位置づけ】
     [目的・読者・ライフサイクル・次工程を1〜3行で記載。例: 「リファクタ候補選定のための探索メモ。直接の実装インプットではなく、採用候補は別途設計書を作る」]
     重大度（ブロック/非ブロック）は、この位置づけにおける採用可否を基準に判定してください。
     
     【重点確認項目】
     1. 技術的レビュー（Technical accuracy）: 技術的な内容が正確か、論理展開が適切か。
     2. 分かりやすさ（Tone/Style）: 読者（特にAI）にとって意図が明確に伝わるトーン＆マナーになっているか。
     3. 網羅性: 上記の位置づけで想定される読者・次工程にとって、必要な情報（前提条件、制約、期待する出力など）が不足なく網羅されているか。
     
     【出力要件】
     - 総合的な評価（数行）
     - 修正・追記すべき具体的な問題点のリスト（箇条書きで明確に）。各項目には重大度として「ブロック」（このドキュメントの採用を差し止めるべき重大な問題）か「非ブロック」（改善提案レベル）かを必ず明記してください。
     - ブロックに該当する問題点が一つも無い場合は「ブロックレベルの指摘なし」と明記してください。
     

   • 実行コマンド例:

     • Codex の場合: codex exec "[指示内容]" < "[FILE_PATH]"
     • Claude の場合: claude -p "[指示内容]" < "[FILE_PATH]"
     • Gemini の場合: gemini -p "[指示内容]" < "[FILE_PATH]"

3. 結果の処理:

   • 外部プロセスの出力を分析し、総合的な評価をユーザーに報告してください。
   • ブロックレベルの指摘の明示: レビュー結果の中に、このドキュメントの採用（公開・実装への引き渡し）を差し止めるべき重大な指摘（ブロックレベル）が含まれていたかを、報告の冒頭で必ず yes/no で明示してください。yes の場合は該当する指摘内容も併記してください。なかった場合も「ブロックレベルの指摘なし」と明示してください。
   • 具体的な問題点については、タスクとして管理してください。
     • Gemini CLIのタスク管理ツール（write_todos や tracker_create_task）が利用可能な場合はそれを使用してください。
     • 利用できない場合は、ファイル内のTODOセクションに追記するか、新しいMarkdownファイルを作成してタスクをリストアップしてください。

【注意】

• パスにスペースが含まれる可能性があるため、適切にクォートしてください。
• 実行前に、なぜそのコマンドを実行するか簡潔に説明してください。
• codex は trusted directory（リポジトリ内の cwd）から実行してください。scratchpad 等リポジトリ外の cwd では "Not inside a trusted directory" で即失敗します（exit 1。; echo 等のラッパーを挟むと exit 0 に見えるため、出力が数行ならこのエラーを疑う）。対象ファイル自体はリポジトリ外でも構いません。