Skip to main content
カテゴリの指示と Kody のパーソナリティ（旧 Custom Prompts）により、Kody がコードを分析し、結果を伝達する方法を完全に制御できます。各レビューカテゴリで AI が何を探すか、チームの基準とコミュニケーションスタイルに合わせてサジェストをどのように提示するかをカスタマイズします。 旧 Custom Prompts ページはナビゲーションからなくなりました。その 2 つの部分は現在、サイドバーの Code review グループの 2 つのページにあります：

カテゴリの指示

Code review → What to review：Bug、Performance、Security の各行にある Instructions エディター

Kody のパーソナリティ

Code review → What Kody writes：Personality instructions エディター

​
カスタムプロンプトを使用する理由

チーム固有の基準

Kody のレビューをチームのユニークなコーディング標準、アーキテクチャパターン、ベストプラクティスに合わせます

モデルの最適化

BYOK 使用時に特定の AI モデルの強みに最適化されたプロンプトを作成します

フォーカス制御

プロジェクトにとって最も重要な問題に Kody の注意を向け、ノイズを減らします

コミュニケーションスタイル

重大な問題には詳細に、軽微な問題には簡潔に — Kody のサジェストの提示方法をカスタマイズします

​
カスタムプロンプトの仕組み

カスタムプロンプトは 2 つのレベルで動作します：

​
カテゴリの指示（What to review）

各レビューカテゴリで Kody が何を探すかを定義します。Code review → What to review では、有効になっている Bug、Performance、Security の各行に Instructions ボタンがあり、エディター（What counts as a bug issue など）を 展開します。変更するまでは Kody のデフォルトが表示されます — チップには Kody’s default または Custom と表示され — Reset to default で元に戻せます。カテゴリがオフの間はエディターは表示されず、Business Logic には指示がありません。
フォーカス： コードの正確性と実行上の問題デフォルトのカバレッジ：
  • 実行エラー（未処理の例外）
  • 誤った結果（不正な出力）
  • リソースリーク（ファイル、接続、メモリ）
  • 状態の破損（無効なオブジェクト/データ状態）
  • ロジックエラー（不正な制御フロー）
  • 競合状態（並行アクセスの問題）
最大長： 2000 文字

​
Kody のパーソナリティ（What Kody writes）

旧 Suggestion Prompts のベース指示です。Code review → What Kody writes の Kody’s personality セクションに Personality instructions エディター（最大 2000 文字、Reset to default あり）があります： すべてのサジェストで Kody がどのような口調になるかを決めます。各カテゴリの指示の上に適用されます。 Kody が各サジェストを伝達する方法を制御します。これにより、PR コメントに表示されるメッセージの形式とトーンがカスタマイズされます：
カスタムプロンプトは、Kody にサジェストメッセージの書き方を指示します。プロンプトは重大度レベル、問題の説明、提案されたコード、および Kody ルール違反かどうかについてのコンテキストを受け取ります。Kody はこのコンテキストとプロンプトを使用して各サジェストに適切なメッセージを生成します。 チームのニーズに基づいて、重大な問題には詳細な説明を、軽微な問題には簡潔なフィードバックなど、トーン、詳細レベル、コミュニケーションスタイルをカスタマイズできます。

​
kodus-config.yml で設定する

同じ 4 つのフィールドが v2PromptOverrides キーの下で利用できます：
この 4 つは Web UI が公開しているもので、それぞれ上限は 2000 文字です。Business Logic カテゴリにプロンプトの override はありません。 設定ファイルは、Web UI のどのページでも編集できないグループをもう 1 つ受け付けます — 設定ファイル 専用です。これは Kody が検出結果を分類するための重大度ルーブリックです：
これは Kody の表現だけでなく分類そのものを変えます — ルーブリックを誤ると、すべての レビューで重大度が静かに下げられたり、逆に膨らんだりします。出荷時のデフォルトである default-kodus-config.yml を起点にし、ルーブリックをゼロから書き起こさないでください。
同梱の default-kodus-config.yml には v2PromptOverrides.level グループも含まれています。 後方互換のため受け付けられ続けますが、エンジンはもう読みません — 設定しても何も変わりません。 レビューに届くのは categories.descriptions、severity.flags、generation.main だけです。
このファイルは kodusConfigFileOverridesWebPreferences を有効にして初めて読み込まれます （一般設定 を参照）。

​
外部参照

すべてのカスタムプロンプト（カテゴリの指示、パーソナリティの指示、PR サマリーの指示）は、Kody がアクセスできるコードベースの実際のファイルへの参照をサポートします。更新を保存すると、Kody は自動的に外部参照を検出し、将来のレビューのために解決します。
  • 編集中のリポジトリのファイルを指定するには @file:path/to/file.ts を使用します。Kody はまずローカルでパスを見つけようとします。
  • 別のリポジトリのファイルを参照する場合やグローバルレベルでプロンプトを編集する場合は @repo:org/project を含めます。
  • モデルが確実に正しいファイルを見つけられるように、プレースホルダーではなく正確な blob スタイルのパスを優先してください。
  • 保存後、Kody はバックグラウンドで参照を処理します。解決が完了したことを確認するために、プロンプトエディタ横のステータスインジケーターを確認してください。

​
ベストプラクティス

​
コンテキストに特化する

良い例：コンテキスト特化

悪い例：汎用的すぎる

​
プロンプト間の冗長性を避ける

各カテゴリは明確なフォーカスを持つべきです。異なるプロンプト間で同じ指示を繰り返さないでください。
バグカテゴリ： Java サービスの実行の正確性、ヌルポインタ例外、リソースのクリーンアップに焦点を当てます。セキュリティカテゴリ： API エンドポイントの SQL インジェクション、XSS、CSRF に焦点を当てます。入力のサニタイズとパラメータ化クエリを検証します。パフォーマンスカテゴリ： データ処理での N+1 クエリ、データベースインデックスの欠如、非効率なループに焦点を当てます。結果： 各プロンプトは明確で重複しないフォーカスを持っています。
バグカテゴリ： ヌルポインタ、SQL インジェクション、遅いクエリを確認します。セキュリティカテゴリ： SQL インジェクション、ヌルポインタ、パフォーマンス問題を探します。パフォーマンスカテゴリ： 遅いクエリ、ヌルポインタ、セキュリティの脆弱性を見つけます。問題： すべてのプロンプトが重複しており、モデルを混乱させてレビュー品質を低下させます。

​
例の使用に注意する

これはパターンを広く説明し、複数のバリエーションを捕捉します。

​
サジェストをスキャンしやすくする

サジェストプロンプトでは、開発者が一度に多くをレビューするため、メッセージをスキャンしやすくします：
明確な階層、重要な情報を最初に

​
コンテキストを有意義に使用する

本当の理由がある場合にのみサジェスト形式を差別化します：
明確な区別：ルールは要件、サジェストは推奨

​
ユースケース

シナリオ： HIPAA コンプライアンス要件を持つ医療アプリケーションカスタムセキュリティプロンプト：
メリット： Kody は一般的なセキュリティレビューが見逃す可能性のあるコンプライアンス固有の問題を捕捉します。
シナリオ： 特定のパターンを持つ React/Node.js アプリケーションカスタムバグプロンプト：
メリット： レビューはスタック固有の落とし穴にレーザーフォーカスされます。
シナリオ： コスト最適化のために BYOK 経由で Gemini 2.5 Flash を使用カスタムパフォーマンスプロンプト：
メリット： Gemini が非常に得意とする構造化された出力形式で、レビュー品質が向上します。
シナリオ： クリティカルな問題には詳細な説明を、軽微な問題には簡潔なフィードバックを望むカスタムサジェストプロンプト：
メリット： クリティカルな問題は追加のコンテキストを得て、軽微な問題は簡潔に保たれ、レビュー効率が向上します。
シナリオ： チームは最小限のアクション可能なフィードバックを好むカスタムサジェストプロンプト：
メリット： すべてのサジェストが短く、要点を押さえています。
シナリオ： ジュニア開発者は詳細な説明から恩恵を受けるカスタムサジェストプロンプト：
メリット： すべてのサジェストに重要性についての教育的なコンテキストが含まれます。
シナリオ： Kody ルールは厳格な要件、サジェストは推奨カスタムサジェストプロンプト：
メリット： 必須ルールとオプションのサジェストを明確に区別します。

​
トラブルシューティング

症状： カスタマイズ後に低価値のサジェストが多すぎる解決策：
  • プロンプトをより具体的でフォーカスしたものにする
  • 無視したいパターンに対して除外を追加する
  • What to review で Minimum severity to post を上げる（重大度しきい値を参照）
  • カテゴリプロンプト間の冗長性を確認する
症状： Kody が検出すべき問題を検出しない解決策：
  • プロンプトが狭すぎたり例に特化しすぎていないか確認する
  • カスタマイズしなかったカテゴリに問題が該当するか確認する
  • デフォルトにリセットして問題が検出されるか試す
  • 問題が異なる重大度で分類されている可能性を検討する
症状： 同じタイプの問題が時々フラグされ、時々されない解決策：
  • プロンプトが明確で曖昧でないことを確認する
  • 異なるプロンプト間の矛盾する指示を取り除く
  • 特定しすぎた例を使用していないか確認する
  • プライマリ/フォールバックの異なるモデルが異なる能力を持つかどうかを検討する
症状： カスタムプロンプトを使用したいが、どこから始めればよいかわからない解決策：
  • まず 1 週間デフォルトのレビューを実行する
  • 誤検知または見逃した問題のパターンに注目する
  • それらのパターンに関連する特定のプロンプトのみをカスタマイズする
  • 明確なニーズが見えるまで他のプロンプトはデフォルトのままにする

​
よくある質問

設定した場所によって異なります：
  • グローバル設定： 組織内のすべてのリポジトリに適用されます
  • リポジトリごとの設定： そのリポジトリのグローバル設定をオーバーライドします
これにより、必要に応じてリポジトリ固有のオーバーライドを使用しながら、組織全体の標準を持つことができます。
はい。各エディターは変更するまで Kody のデフォルトを表示し、Reset to default で元に戻せます。
変更は新しいレビューにのみ影響します。@kody start-review で再実行して新しいプロンプトを既存の PR に適用します。
はい、v2PromptOverrides キーの下で設定できます — 上記の「kodus-config.yml で設定する」を参照してください。このファイルは kodusConfigFileOverridesWebPreferences を有効にして初めて読み込まれます。
明確で具体的なニーズがあるプロンプトのみカスタマイズしてください。改善の恩恵を受けるために他はデフォルトのままにしてください。1〜2 個のプロンプトから始めてください。
シームレスに機能します。モデルの強みに合わせてプロンプトを調整してください。プライマリとフォールバックの両方が同じカスタムプロンプトを使用します。
カテゴリの指示（旧カテゴリプロンプト、What to review にあります）は各レビューカテゴリで Kody が何を分析するかを制御します。パーソナリティの指示（旧サジェストプロンプト、What Kody writes にあります）は Kody がチームに結果をどのように提示するかを制御します。両方を独立してカスタマイズできます。
はい。サジェストプロンプトは太字、斜体、コードブロック、リンクを含む標準的なマークダウン形式をサポートします。
Kody はデフォルトのサジェスト形式にフォールバックし、設定でエラーを通知します。
はい。isKodyRule 変数を使用して、同じプロンプト内でルールとサジェストに対して異なるメッセージを作成します。