doc-review-external

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

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

【重要】 外部プロセスを起動する前に external-agent-invocation スキルを読み、オプションの解釈・コマンドの形・落とし穴・重大度の書かせ方はそちらに従ってください。このスキルには、ドキュメントレビューに固有の部分だけを書いています。

• 重大度のラベル: 「ブロック」（このドキュメントの採用を差し止めるべき重大な問題）/「非ブロック」（改善提案レベル）
• 外部プロセスに修正はさせません。指摘を受け取り、タスク化するところまでがこのスキルの範囲です。

【手順】

1. 対象ファイルの確認:

   • {{args}} からオプションフラグを除いた部分をファイルパスとします。
   • 指定されたファイルが存在することを確認してください。

2. ドキュメントの位置づけの特定:

   • レビュー対象ドキュメントの位置づけ（探索メモ / 調査レポート / 設計書 / 実装インプット / 公開文書 等）・読者・次工程を、依頼コンテキストから特定してください。不明な場合はユーザに確認してください。

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

   • ファイル内容は stdin 経由で渡します（< "[FILE_PATH]"）。
   • 指示内容:

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

4. 結果の処理:

   • 外部プロセスの出力を分析し、総合的な評価をユーザーに報告してください。報告冒頭でのブロックレベルの明示は共通手順のとおりです。
   • 具体的な問題点については、タスクとして管理してください。
     • タスク管理ツールが利用可能な場合はそれを使用してください。
     • 利用できない場合は、ファイル内のTODOセクションに追記するか、新しいMarkdownファイルを作成してタスクをリストアップしてください。