メインコンテンツへスキップ

概要

コードレビューの開始と終了時に Kody が送信するメッセージをカスタマイズします。この機能により、コミュニケーションスタイルをパーソナライズし、チームに特定のコンテキストや指示を追加できます。

デフォルトの動作

メッセージをカスタマイズしていない場合、Kody は以下のように動作します:
  1. 初期メッセージ:Kody は標準的なレビュー開始メッセージを送信します
  2. サジェスト:Kody はすべてのコードレビューサジェストを提供します
  3. 最終メッセージ:Kody はレビューの概要で初期メッセージを更新します

カスタムメッセージの動作

レビュー開始または終了メッセージのいずれかを初めて編集すると、Kody の動作が以下のように変わります:
  1. 初期メッセージ:Kody はカスタムレビュー開始メッセージを送信します
  2. サジェスト:Kody はすべてのコードレビューサジェストを提供します
  3. 最終メッセージ:Kody はカスタムレビュー終了メッセージを送信します(初期メッセージは更新されません)
これにより完全なタイムラインが作成されます:初期メッセージ → サジェスト → 最終メッセージ

メッセージ設定オプション

メッセージの動作

メッセージの動作ドロップダウンを使用して、Kody がカスタムの開始・終了メッセージをいつ投稿するかを決定します:
  • 重要: メッセージはレビューが実際に実行されるときのみ送信されます。
    レビューの頻度が手動の場合、メッセージは誰かが @kody start-review を実行したときのみ投稿されます。
  • 毎プッシュ時:Kody はプルリクエストが開かれたときに開始メッセージを投稿し、レビューをトリガーする新しいプッシュごとに開始/終了ペアを繰り返します。これは頻度が自動または自動一時停止の場合にのみ自動的に発生します。
  • 開かれたときのみ:Kody は最初のレビュー実行後に一度だけ開始・終了メッセージを送信します。頻度が手動の場合、最初のレビュー実行は @kody start-review を呼び出したときです。将来のプッシュはレビューサジェストと通常のリアクションだけを追加し、作者はレビューが再実行されたことを知ります。
  • オフ:カスタムメッセージは無効です。Kody は引き続きレビューを実行してサジェストを投稿しますが、開始・終了メッセージは送信されません。
動作が 毎プッシュ時 または 開かれたときのみ の場合、Kody は入力したテンプレートを使用します。開始メッセージのみをカスタマイズした場合、そのメッセージのみが送信されます。終了メッセージも同様です。これにより、動作がメッセージの投稿を許可する場合はいつでも、初期メッセージ → サジェスト → 最終メッセージというおなじみのタイムラインが維持されます。 例(手動の頻度)
PR が開かれる → まだメッセージなし
@kody start-review → 開始メッセージ → サジェスト → 終了メッセージ

動的コンテキスト

コンテキストを追加ボタンを使用して、動的コンテキストでカスタムメッセージを拡張できます。以下を含めることができます:

changedFiles

ファイルごとの追加と削除を示す変更ファイルの概要。プルリクエストで変更された内容の詳細な内訳を提供します。

changedSummary

プルリクエストのすべての変更の包括的な概要。変更範囲全体の概観を提供します。

reviewOptions

チームが設定したレビュー設定の反映。レビューでどの分析タイプが有効または無効かを示します。

reviewCadence

最初の自動レビュー後に何が起こるかを作者が知ることができるよう、正確なフォローアップレビューポリシーを提供します:
  • 自動:Kody はプッシュがあるたびにすぐに再レビューします。
  • 自動一時停止:Kody は自動的にプッシュを再レビューしますが、「プッシュバースト」を検出した場合(例:設定されたしきい値に基づいて 15 分以内に 3 回のプッシュ)、フォローアップレビューを再開するまで一時停止します。頻度コンテキストには、チームが一時停止がいつトリガーされるかを知ることができるよう、プッシュと時間の制限が含まれます。
  • 手動:Kody は誰かが @kody start-review を実行するまで次のパスを待ちます。
これらのコンテキスト変数は、Kody がメッセージを送信する際に プルリクエストの実際のデータで自動的に入力されます。
両方のカスタムメッセージを無効にするか、メッセージコンテンツをクリアすることで、 いつでもデフォルトの動作に戻すことができます。