概要
コードレビューの開始と終了時に Kody が送信するメッセージをカスタマイズします。この機能により、コミュニケーションスタイルをパーソナライズし、チームに特定のコンテキストや指示を追加できます。 サイドバーで Code review → What Kody writes を開きます。メッセージは Comments during the review セクションにあり、メッセージごとに Review starts、Review ends、Review fails のタブがあります。各タブには Message ボックスと Reset to… メニュー(継承されたメッセージ、または Global ではデフォルトのメッセージに戻す)があります。デフォルトの動作
メッセージをカスタマイズしていない場合、Kody は以下のように動作します:- 初期メッセージ:Kody は標準的なレビュー開始メッセージを送信します
- サジェスト:Kody はすべてのコードレビューサジェストを提供します
- 最終メッセージ:Kody はレビューの概要で初期メッセージを更新します
カスタムメッセージの動作
レビュー開始または終了メッセージのいずれかを初めて編集すると、Kody の動作が以下のように変わります:- 初期メッセージ:Kody はカスタムレビュー開始メッセージを送信します
- サジェスト:Kody はすべてのコードレビューサジェストを提供します
- 最終メッセージ:Kody はカスタムレビュー終了メッセージを送信します(初期メッセージは更新されません)
メッセージ設定オプション
Post this message
Review starts タブと Review ends タブで、Post this message セレクトを使用して、Kody がそのメッセージをいつ投稿するかを決定します(メッセージごとに個別の設定があります):-
重要: メッセージはレビューが実際に実行されるときのみ送信されます。
レビューの頻度が手動の場合、メッセージは誰かが@kody start-reviewを実行したときのみ投稿されます。 -
On every push(
every_push):プルリクエストが開かれたときに投稿され、レビューをトリガーする新しいプッシュごとに再度投稿されます。これは頻度が自動または自動一時停止の場合にのみ自動的に発生します。 -
Only when the PR opens(
only_when_opened):最初のレビュー実行後に一度だけ投稿されます。頻度が手動の場合、最初のレビュー実行は@kody start-reviewを呼び出したときです。将来のプッシュはレビューサジェストと通常のリアクションだけを追加し、作者はレビューが再実行されたことを知ります。 -
Never(
off):メッセージは投稿されません。テキストは後で使えるよう保持されます。Kody は引き続きレビューを実行してサジェストを投稿します。
PR が開かれる → まだメッセージなし
@kody start-review → 開始メッセージ → サジェスト → 終了メッセージ
動的コンテキスト
Message の横にある Add context メニュー(Review starts タブと Review ends タブ)を使用して、動的コンテキストでカスタムメッセージを拡張できます。以下を含めることができます:changedFiles
ファイルごとの追加と削除を示す変更ファイルの概要。プルリクエストで変更された内容の詳細な内訳を提供します。changeSummary
プルリクエストのすべての変更の包括的な概要。変更範囲全体の概観を提供します。reviewOptions
チームが設定したレビュー設定の反映。レビューでどのレビューカテゴリが有効または無効かを示します。reviewCadence
最初の自動レビュー後に何が起こるかを作者が知ることができるよう、正確なフォローアップレビューポリシーを提供します:- 自動:Kody はプッシュがあるたびにすぐに再レビューします。
- 自動一時停止:Kody は自動的にプッシュを再レビューしますが、「プッシュバースト」を検出した場合(例:設定されたしきい値に基づいて 15 分以内に 3 回のプッシュ)、フォローアップレビューを再開するまで一時停止します。頻度コンテキストには、チームが一時停止がいつトリガーされるかを知ることができるよう、プッシュと時間の制限が含まれます。
- 手動:Kody は誰かが
@kody start-reviewを実行するまで次のパスを待ちます。
reviewScope
このプルリクエストのレビューにどの設定レベル(グローバル・リポジトリ・ディレクトリ)が 適用されたかを表示し、作者がどの設定が使われたかを把握できるようにします。agentPrompt
レビュー終了メッセージ専用。
レビューの行コメントの提案をまとめたものです。これらの提案はレビューが実行されるまで
存在しないため、開始メッセージでは提供されません。
これらのコンテキスト変数は、Kody がメッセージを送信する際に
プルリクエストの実際のデータで自動的に入力されます。
kodus-config.yml では、これらのトークンは @ プレフィックス付きで書きます —
@changedFiles、@changeSummary、@reviewOptions、@reviewCadence、@reviewScope、
@agentPrompt — メッセージの content 内のどこにでも置けます。Web UI の
Add context メニューは同じトークンを挿入します。エラーメッセージ
開始/終了メッセージとは別に、レビューが失敗したときに Kody が投稿するコメントへ独自の テキストを追記できます。たとえば BYOK プロバイダーが未設定のとき、プロバイダーがリクエストを 拒否したときなどです。Review fails タブで記入します。 このメッセージにはオン/オフの設定はありません。テキスト自体がスイッチです。- 空(デフォルト)— Kody は標準のエラーコメントをそのまま投稿します。
- 入力あり — 標準のエラーコメントの下にあなたのテキストが追記されます。
content を空のままにすると、デフォルトのエラーメッセージは変更されません。
コメントの表示(グローバル設定)
カスタムメッセージだけでなく、Kody のすべてのコメントに適用される 2 つのトグルです。What Kody writes の Comment visibility セクションにあります:両方のカスタムメッセージを無効にするか、メッセージコンテンツをクリアすることで、
いつでもデフォルトの動作に戻すことができます。