> ## 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](/ja/how_to_use/code_review/configs/custom_prompts) または [Kody Rules](/ja/how_to_use/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>
      `--force` は、Kody が通常スキップする場合（「前回のレビュー以降に新しいコミットがない」）でもレビューを再実行します。フォーカスディレクティブの有無にかかわらず、前回の実行を失敗させた原因を修正した後に新しいレビューを実行したり、レビュー済みの PR に更新後の設定を適用したりする際に使ってください。
    </Note>

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

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

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

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

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

## Heavy mode

<Warning>
  **アルファ — 申請制です。** Heavy mode はどの組織でもデフォルトではオフです。試したい場合は、
  [Discord](https://discord.gg/TFZBRk9fT6) または [support@kodus.io](mailto:support@kodus.io)
  から、あなたの組織で有効化するようご依頼ください。それまでフラグは受け付けられますが効果は
  ありません — 下記の[提供状況](#提供状況)を参照してください。
</Warning>

フォーカスディレクティブは Kody に*どこを*重点的に見るかを伝えます。`--heavy` は*より長く*見る
ことを伝えます。finder が同じ diff に対して「見落としはないか？」という批評パスを追加で実行し、
レビューが遅くなり選別すべき候補が増える代わりに、実際の問題をより多く見つけます。

```text theme={null}
@kody review --heavy
@kody review --heavy focus on the payment reconciliation logic
kodus review --heavy
```

`--heavy` は行のどこに置いても構いません（フォーカステキストの前でも後でも）。いずれの場合も
ディレクティブからは取り除かれるため、`@kody review リトライ処理に注目 --heavy` は
「リトライ処理に注目」にフォーカスします。

<Warning>
  **`--force` と併用するときは `--force` を先に置いてください。** `--force` はコマンド直後に
  ある場合のみ認識されます。そのため `@kody review --force --heavy` は強制の heavy レビューに
  なりますが、`@kody review --heavy --force` は強制**されない** heavy レビューになります。
</Warning>

ダッシュは必須です。ダッシュなしの `heavy` はディレクティブのテキストとして読まれるため、
`@kody review heavy チェックアウト経路` はフラグを有効にせず「heavy チェックアウト経路」に
フォーカスします。

### 提供状況

Heavy mode は**アルファ**機能です。明示的に有効化した組織でのみ実行されます：

|            | ステータス                                                                    |
| ---------- | ------------------------------------------------------------------------ |
| **クラウド**   | 申請により利用可能 — 組織を `alpha` リリーストラックへ移行します。                                  |
| **セルフホスト** | まだ利用できません。アルファ機能は `BETA_FEATURES` に関係なくオフのままで、ベータに昇格した時点でセルフホストにも提供されます。 |

<Note>
  **フラグは静かにフォールバックします（エラーは出ません）。** 組織が有効化されていない場合、
  `--heavy` は受け付けられ、レビューは**通常どおり実行されます** — エラーも警告もなく、結果も
  変わりません。アクセスを申請したのに有効かどうか判断できない場合は、推測せずご連絡ください。
</Note>

アクセスをご希望の場合は、組織名を添えて [Discord](https://discord.gg/TFZBRk9fT6) または
[support@kodus.io](mailto:support@kodus.io) までご連絡ください。

<Tip>
  見落としのコストが高い変更 — マイグレーション、認証の変更、決済経路 — で使ってください。
  デフォルトにするものではありません。日常的な PR では、増えた候補はたいてい選別が必要な
  ノイズになります。
</Tip>

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

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

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

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

## 注意点と制限

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