> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kodus.io/llms.txt
> Use this file to discover all available pages before exploring further.

# レビューの方向付け（フォーカス）

> PR コメントまたは CLI から、単発のレビューディレクティブでプルリクエストの特定領域に Kody の注意を向けます

**レビューディレクティブ**を使うと、その 1 回のレビューで Kody がどこを最も深く分析すべきかを指示できます。設定を変更する代わりに、レビューを起動するときに短い指示を添えます — 例えば「認証とセッションのロジックに集中して」— すると Kody は該当する変更コードに最も厳しい分析を集中させます。

<Note>
  ディレクティブは**一時的**です。その 1 回のレビュー実行にのみ適用され、設定には保存されず、今後のレビューには影響しません。Kody の挙動を恒久的に変えたい場合は、[Custom Prompts](/how_to_use/ja/code_review/configs/custom_prompts) または [Kody Rules](/how_to_use/ja/code_review/configs/kody_rules) を使ってください。
</Note>

## いつ使うか

* PR が多数のファイルに触れているが、特にリスクの高い 1 領域（認証、決済、マイグレーション）が気になるとき。
* 特定の変更の呼び出し元・呼び出し先を Kody に辿らせ、より厳しく精査させたいとき。
* レビューを再実行する際、設定を編集せずに注意を向けたいとき。

## フィルターではなく優先度

これが最も重要なポイントです：

<Warning>
  ディレクティブは**フィルターではなく優先度**を設定します。Kody はフォーカス領域を優先しますが、diff の**他の箇所**で気づいた具体的なバグ・セキュリティ・パフォーマンスの問題も引き続き報告します。フォーカス外の指摘を握りつぶすことはなく、PR の残りを未確認のまま承認することもありません。
</Warning>

ディレクティブは *「ここを最も重点的に見て」* と伝えるものであり、*「ここだけ見て」* ではありません。

## 起動方法

<Tabs>
  <Tab title="PR / MR コメント">
    プルリクエストのコメントで、レビューコマンドの直後にフォーカステキストを書きます：

    ```text theme={null}
    @kody review 認証とセッションのロジックに集中して
    ```

    `start-review` も使え、`--force` と組み合わせられます：

    ```text theme={null}
    @kody start-review 新しいデータベースマイグレーションに集中して
    @kody review --force webhook パーサーのエラー処理に集中して
    ```

    <Note>
      ディレクティブとして使われるのはコマンドの後の**最初の 1 行のみ**です。以降の行は無視されるため、フォーカスは 1 行にまとめてください。
    </Note>

    GitHub、GitLab、Azure DevOps、Bitbucket、Forgejo で動作します。
  </Tab>

  <Tab title="CLI">
    レビュー実行時に `--focus` フラグを渡します：

    ```bash theme={null}
    kodus review --focus "認証とセッションのロジック"
    ```

    コマンド全体は [CLI コマンドリファレンス](/how_to_use/ja/cli/commands) を参照してください。
  </Tab>
</Tabs>

## 良いディレクティブの書き方

* **判定ではなく領域を具体的に。**「バグを見つけて」より「キューコンシューマの並行処理に集中して」の方が有効です。
* **結果ではなくコードを名指しする。** モジュール・フロー・関心事を指し示します（「リトライロジック」「レポートサービスの SQL」）。
* **短く。** ディレクティブは**最大 500 文字**で、コメントの最初の 1 行のみが読まれます。

<AccordionGroup>
  <Accordion title="良い例">
    - `@kody review 認証とトークンリフレッシュのフローに集中して`
    - `@kody review 新しい Stripe webhook 処理に集中して`
    - `kodus review --focus "バックグラウンドワーカーの競合状態"`
  </Accordion>

  <Accordion title="弱い例">
    * `@kody review しっかり見て` — 優先すべき領域がありません。
    * `@kody review ファイル X だけコメントして` — ディレクティブはフィルターではありません。ファイルを絞るには[無視パス](/how_to_use/ja/code_review/configs/general)を使ってください。
  </Accordion>
</AccordionGroup>

## 注意点と制限

* **長さ：** ディレクティブは 500 文字で切り詰められます。
* **最初の 1 行のみ：** PR コメントでは、コマンド後の最初の 1 行だけがディレクティブになります。
* **設計上、信頼しない：** PR にコメントできる人なら誰でもディレクティブを渡せるため、使用前にテキストはサニタイズされます（制御文字と山括弧を除去）。これはフォーカスを変えるものではなく、テキストが Kody の内部プロンプトを改ざんするのを防ぐだけです。
* **保存されない：** リポジトリや組織の設定には何も書き込まれません。