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

仕組み

  • ソースとして振る舞う接続済みリポジトリを選択します。
  • Kodus は各ソースリポジトリを、ルールファイル検出 と同じパターン(CLAUDE.mdAGENTS.md.cursor/rules/**.kody/rules/** など)でスキャンします。
  • 見つかった各ルールファイルはグローバルスコープにインポートされ、取得元のソースリポジトリのタグが付きます。
  • 任意のリポジトリのコードレビュー時に、これらのグローバルルールがそのリポジトリ自身のルールと併せて適用されます(継承 に従います)。
グローバルソースとして使えるのは、git 設定で既に接続済みのリポジトリだけです。これにより接続済みリポジトリの信頼できる情報源が 1 つに保たれ、下記の Pull Request トリガーによってインポート済みルールが最新に保たれます。

セットアップ

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

ルールを最新に保つ

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

ソースの削除

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

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

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

プラン別の提供状況

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

関連