---
name: improve-document
description: レビューと修正を繰り返すループの中で、重要度の高い問題（問題）を解決し、ドキュメントを自動的に改善します。
argument-hint: "改善対象のドキュメントの相対パス"
---

`review-document` スキルを使って重要度の高い問題（**問題**）を見つけて修正することで、対象ドキュメントのレビューと改善を繰り返します。

## 実行手順

1.  **対象ファイルの特定**:

    -   引数としてファイルパスが指定されている場合は、それを対象とします。
    -   引数がない場合は、ユーザーにファイルパスを入力するように促します。

2.  **最初のレビューの確認または実行**:

    -   プロジェクトルートからの相対パスで、`.review/[対象ドキュメントの相対パス]` にすでにレビューレポートがあるか確認します（例：対象が `docs/AGENTS.md` の場合は `.review/docs/AGENTS.md` を探します）。
    -   ファイルが存在する場合は、その内容を読み込みます。
    -   存在しない（または空の）場合は、[review-document](../review-document/SKILL.md) スキルを実行して、新しいレポートを作成します。

3.  **解析と解決の繰り返し（最大3回）**:

    -   最大3回まで、以下の作業を繰り返します。
        -   最新のレビューレポートファイルを読み込み、**🔴 問題 (High Severity)** のセクションにある指摘事項を解析します。
        -   **🔴 問題** の下に指摘事項がない（または件数が `0`）場合：
            -   繰り返しループを終了します。重要度の高い問題はすべて解決しました。
        -   **🔴 問題** の指摘事項がある場合：
            -   それぞれの指摘について、場所、元のテキスト、推奨する対応を分析します。
            -   問題を修正するために、対象ドキュメントに必要な部分だけ（ピンポイントで）編集を行います。関係のない部分は変更しないようにしてください。
            -   更新した対象ドキュメントを保存します。
            -   対象ドキュメントに対して [review-document](../review-document/SKILL.md) スキルを実行し、レビューレポートファイルを最新の分析内容で上書きします。
            -   更新されたレビューレポートを再度読み込んで解析します。

4.  **最終要約**:

    -   ループが終了したとき：
        -   各繰り返しで、どの重要度の高い問題が解決されたかをまとめます。
        -   3回繰り返しても解決しなかった問題があれば、それを記載します。
        -   更新されたドキュメントと、最新のレビューレポートへのパス／リンクを提示します。
