---
name: review-document
description: 3段階の重要度チェックリスト（問題、要確認、提案）を使って、ドキュメントの内容をレビューします。
argument-hint: "レビュー対象のドキュメントの相対パス"
---

ワークスペース内にある対象ドキュメントを読み込み、3段階の重要度（問題、要確認、提案）に分かれたチェックリストを使って、内容をレビュー（確認）します。

## レビューのチェックリスト

### 1. 問題 (Issue/Problem - 重要度：高)

すぐに直す必要がある、致命的な間違いや論理的なおかしい部分、抜け漏れです。

-   **矛盾・論理の破綻**: ドキュメントの中で内容が矛盾していたり、指示がぶつかっていたり、論理的におかしい部分。
-   **致命的な記述漏れ・不明瞭さ**: 必要不可欠な詳細、前提条件、パラメータなどが抜けている、または言葉があいまいすぎて理解できない部分。
-   **参照・リンク切れ**: 存在しない、または間違っているファイル、ディレクトリ、コードのシンボル、URLへのリンクや参照。
-   **事実誤認**: 技術的な前提の単純な間違い、間違ったバージョン番号、正しくない主張。

### 2. 要確認 (Needs Confirmation/Clarification - 重要度：中)

ユーザーや関係者に確認したり、はっきりさせたりする必要がある項目です。

-   **前提条件の妥当性**: はっきりと書かれていない、またはあいまいな前提（例：OS、バージョン、APIのアクセス権などについての暗黙の依存関係や動作環境、前提条件など、確認した方がよいもの）。
-   **用語の不整合・定義不足**: 用語の揺れ（同じものを違う言葉で書いていること）や、はっきりとした説明なしに使われている専門用語。
-   **技術的実現性・リスク**: あまりにも複雑すぎたり、リスクが高すぎたり、互換性がないかもしれない要件や実装方法。
-   **構造・構成の乱れ**: レイアウト、箇条書きの番号、見出しレベル、スタイルの統一感がなく、読みにくくなっている部分。

### 3. 提案 (Suggestion/Recommendation - 重要度：低)

分かりやすさ、見た目の美しさ、使いやすさを良くするための前向きな提案です。

-   **可読性・明瞭性の向上**: 複雑な文を分かりやすくする、長い文章を箇条書きや表にする、図（Mermaid など）を追加する。
-   **体裁・構成の改善**: 適切な Markdown の記法（コードブロック、アラートブロック、きれいなリンクなど）を使った見た目の調整。
-   **ベストプラクティスの適用**: 一般的な標準用語、標準的なフォーマットのガイドライン、またはリポジトリ固有のルールに合わせること。

---

## 実行手順

1.  **対象ファイルの特定**:
    -   引数としてファイルパスが指定されている場合は、それを対象とします。
    -   引数がない場合は、ユーザーにファイルパスを入力するように促します。
2.  **内容の読み込み**:
    -   ファイルの内容を読み込みます。
3.  **レビューの実施**:
    -   チェックリストに沿って、ドキュメントを行ごと、またはセクションごとに分析します。
4.  **レポートのファイル保存**:
    -   フォーマットされたレビューレポートを、プロジェクトルートからの相対パスで `.review/[対象ドキュメントの相対パス]` に保存します（例：対象が `docs/AGENTS.md` の場合は `.review/docs/AGENTS.md` に、対象が `GEMINI-jp.md` の場合は `.review/GEMINI-jp.md` に保存します）。
    -   `.review/` 内のフォルダが存在しない場合は、自動的に作成されるようにします。
    -   すでにレポートファイルが存在する場合は、新しいレビュー内容で上書きします。
5.  **レポートの出力**:
    -   チャットで構造化されたレビューレポートを表示し、保存したファイルのパスをユーザーに伝えます。

---

## 出力レポートのフォーマット

以下の構成を使ってレビューレポートを出力します。

```markdown
# ドキュメントレビューレポート: [ファイル名]

レビュー対象: `[ファイルへの相対パス]`

## 概要 (Executive Summary)

| 重要度 | 件数 | 主な注目点 |
| --- | --- | --- |
| 🔴 問題 (High) | 0 | すぐに修正が必要な致命的な問題 |
| 🟡 要確認 (Medium) | 0 | ユーザーの確認や認識合わせが必要な項目 |
| 🟢 提案 (Low) | 0 | 読みやすさや品質向上のための提案 |

---

## 詳細な検出事項 (Detailed Findings)

### 🔴 問題 (High Severity)
*致命的な問題をリストアップします。*

- **[問題の短い要約]**
  - **場所 (Location)**: X-Y 行目 / セクション名
  - **元のテキスト (Original Text)**: `[元のテキスト]`
  - **説明 (Description)**: [なぜ問題なのか]
  - **推奨する対応 (Recommended Action)**: [具体的で実行可能な修正案]

### 🟡 要確認 (Medium Severity)
*確認が必要な項目をリストアップします。*

- **[要約]**
  - **場所 (Location)**: X-Y 行目 / セクション名
  - **元のテキスト (Original Text)**: `[元のテキスト]`
  - **説明 (Description)**: [何を確認する必要があるかと、その理由]
  - **推奨する対応 (Recommended Action)**: [具体的な質問内容や選択肢]

### 🟢 提案 (Low Severity)
*提案事項をリストアップします。*

- **[要約]**
  - **場所 (Location)**: X-Y 行目 / セクション名
  - **元のテキスト (Original Text)**: `[元のテキスト]`
  - **説明 (Description)**: [どのように改善できるか]
  - **推奨する対応 (Recommended Action)**: [具体的な提案テキストや構成案]
```
