メインコンテンツへスキップ
グローバルルールソースを使うと、1 つ以上の接続済みリポジトリを Kodus に指定し、そこにある Kody Rule ファイルをグローバル Kody Rules としてインポートできます。リポジトリルール(それが置かれたリポジトリにのみ適用)とは異なり、グローバルソースからインポートされたルールはコードレビュー時にすべてのリポジトリに適用されます。 チームがアーキテクチャとコーディング標準を専用の「standards」リポジトリで管理していて、各プロジェクトにルールファイルをコピーせずにその標準をどこでも適用したい場合に使います。

仕組み

  • ソースとして振る舞う接続済みリポジトリを選択します。
  • Kodus は各ソースリポジトリで、リポジトリルール と同じ場所とテンプレート(.kody/rules/**、rules/**/*.md など)の Kody Rule ファイルをスキャンします。
  • 見つかった各ルールファイルはグローバルスコープにインポートされ、取得元のソースリポジトリのタグが付きます。
  • コーディングエージェント向けに書かれた指示(CLAUDE.md、AGENTS.md、.cursor/rules/**)はインポートされません。この変更以前にそれらからインポートされたグローバルルールは残りますが、更新されなくなります。コーディングエージェント向け指示 を参照してください。
  • 任意のリポジトリのコードレビュー時に、これらのグローバルルールがそのリポジトリ自身のルールと併せて適用されます(継承 に従います)。
グローバルソースとして使えるのは、Repositories ページで既に接続済みのリポジトリだけです。これにより接続済みリポジトリの信頼できる情報源が 1 つに保たれ、下記の Pull Request トリガーによってインポート済みルールが最新に保たれます。

セットアップ

  1. サイドバーで、Code review グループ上部のスコープピッカーで Global を選択し、Kody Rules を開きます。
  2. Configuration をクリックしてサイドシートを開き、Global rule sources を探します。
  3. リポジトリピッカーをクリックし、接続済みリポジトリを 1 つ以上選択します。
  4. Import selected をクリックします。
インポートはバックグラウンドで実行されます。完了すると、インポートされたルールがグローバル Kody Rules の一覧に表示され、それぞれにソースリポジトリのラベルが付きます。
ソースリポジトリはいくつでも選択できます。Kodus はそれぞれで見つけたルールファイルをインポートします。

ルールを最新に保つ

インポートされたルールは自動およびオンデマンドで更新されます:
  • マージ時 — ソースリポジトリで Pull Request がマージされると、そのルールファイルが再スキャンされ、グローバルルールが更新されます。変更のないファイルはスキップされるため、コストは小さいです。
  • Resync now — Resync now ボタンで、設定済みのすべてのソースをオンデマンドで再スキャンします。ソースリポジトリのデフォルトブランチへ直接プッシュされた変更もこれでカバーされます。
ソースリポジトリのデフォルトブランチへ Pull Request を経ずに直接プッシュされた変更は、自動では検出されません。直接プッシュした後は Resync now で取り込んでください。

ソースの削除

ソース一覧からリポジトリを削除すると、そこからインポートされたグローバルルールも削除され、コードレビューで適用されなくなります。削除が反映される前に確認を求められます。他のソースからインポートしたルールや、手で作成したルールが影響を受けることはありません。

ソースリポジトリはレビューされません

グローバルルールのソースとしてのみ使われるリポジトリは、コードベースではなく設定用リポジトリとして扱われます。Kodus はグローバルルールソースで開かれた Pull Request のコードレビューをスキップします。集中設定リポジトリと同じ扱いです。

プラン別の提供状況

グローバルルールソースを利用できるかはプランによります:
Trial プランでは、インポート時に、選択したリポジトリ全体で最初に見つかった 5 件のルール(リポジトリのファイル順)がインポートされます。画面上のカウンターで 5 件のうち何件を使用済みかが分かり、インポート前に確認ダイアログで何件追加されるかが示されます。

関連

  • リポジトリルール — 単一リポジトリにスコープされたバージョン管理下のルール。
  • リポジトリルール — Kodus がインポートするルールファイルの場所とテンプレート。
  • ルールの継承 — グローバル・リポジトリ・ディレクトリのルールがレビュー時にどう組み合わさるか。