---
name: brush-up
description: ドキュメントやスキルに対してレビューと改善を繰り返し、簡潔で過不足のない、洗練された内容に仕上げます。
argument-hint: "<topic>"
---

# Brush Up

指定されたドキュメント、セクション、またはスキルに対して、レビューと改善を繰り返します。レビューで問題がなくなるまで継続してください。

## Quick Start

`<topic>` にはレビュー対象を指定します。ファイルパス、ドキュメント名、セクション名、スキル名など何でも指定できます。

```sh
/brush-up docs/AGENTS.md の Knowledge Bundles セクション
/brush-up IRIS.md
/brush-up .agents/skills/brush-up/SKILL-ja.md
```

## ワークフロー

1.  次の観点でレビューを行います。
    -   正確性：事実と異なる記述、矛盾がないか
    -   明確性：読んで一意に解釈できるか。曖昧な言葉・定義されていない用語がないか
    -   一貫性：同じ概念を複数の言葉で表していないか。表記ゆれがないか
    -   完全性：必要な情報（前提条件やパラメータなど）がすべて揃っているか
    -   簡潔性：冗長な記述を排除し、よりシンプルで分かりやすい表現に書き換えられないか
    -   表記・表現：誤字・脱字はないか。不自然な日本語や不適切な表現はないか
    -   適切さ：ドキュメントの目的やスコープに沿った内容か。他ドキュメントの役割と重複していないか
2.  問題点や改善点が見つかった場合、それらを内部で保持し、**ユーザーには1つずつ提示して処理させます**。一度にすべての確認事項を一覧で提示しないでください。
3.  提示する確認事項について、確認レベルを 🔴（重大）、🟡（問題）、🟢（軽微）に分類し、`<確認レベル> <概要>` を見出しとして提示した上で、具体的な改善案を提案します。改善案を適用した場合の予測差分（diff）は、提案の直下に表示してください。その後、ユーザーにどのように対処するか確認します。
4.  ユーザーからの回答に応じて現在の確認事項が処理（適用、スキップ、または修正）されたら、次の確認事項に進み、ステップ 3 を繰り返します。
5.  洗い出したすべての確認事項が処理されるまで、このプロセスを繰り返します。すべての確認事項が処理されるまで、このブラッシュアップのプロセスを終了（完了報告）してはなりません。
6.  すべての確認事項の処理が完了したら、ステップ 1 に戻って更新されたドキュメントを再度レビューし、新たな問題が見つからなくなるまで繰り返します。

## ノート

-   ユーザーが意見を求めた場合は明確な推奨や見解を示す。「どちらでもよい」などの曖昧な回答は避けること
-   ユーザーの提案や判断に明確な問題（事実誤認やルール違反など）がない限り、その意向を尊重すること
