Documentation Index
Fetch the complete documentation index at: https://docs.kodus.io/llms.txt
Use this file to discover all available pages before exploring further.
概要
デフォルトでは、Kody ルールは階層に沿って継承されます： グローバル → リポジトリ → ディレクトリ 各レベルの有効なルールセットは：- そのレベルで定義されたルール、プラス
- 親レベルから継承されたルール、マイナス
- そのレベルで明示的に除外されたルール。
デフォルトの動作
- グローバルルールはデフォルトですべてのリポジトリとディレクトリに適用されます。
- リポジトリルールはすべてのグローバルルールと、そのリポジトリに特定的に定義されたルールを継承します。
- ディレクトリルールはリポジトリのすべてのルールと、そのディレクトリに特定的に定義されたルールを継承します。
継承の中断
ルールが継承されないようにする方法は 2 つあります：1) 作成時にルールを非継承可能としてマークする
任意のレベル（グローバル、リポジトリ、ディレクトリ）でルールを作成する際に、「非継承可能」としてマークできます。 効果：- ルールは作成されたレベルのみで適用されます。
- 子レベルには表示されません。
2) 子レベルから親ルールを除外する
子設定（リポジトリまたはディレクトリ）から、そうでなければ親から継承されるルールを明示的に除外できます。 効果：- ルールはその正確な子レベルでは適用されません。
- 除外はさらにカスケードしません — 孫は、孫も除外しない限り（またはルールが非継承可能として作成されない限り）、親のルールを引き続き参照します。
例
リポジトリレベルでの除外
グローバルルール「新しいエンドポイントにテストを要求する」が存在するとします。リポジトリ「shop」では、リポジトリレベルでこのルールを除外します。 結果：- リポジトリレベルでは、ルールは適用されなくなります。
- 同じリポジトリ内に設定済みのディレクトリ（例：
apps/api）がある場合、そのディレクトリはグローバルルールを引き続き継承して適用します — ディレクトリレベルでも除外するか、元のグローバルルールが非継承可能として作成されていない限り。
非継承可能なグローバルルールの作成
グローバルルールを作成し、非継承可能としてマークします。 結果：- ルールはグローバルレベルのみで適用されます。
- リポジトリとディレクトリはそれを継承しません。
実践的なヒント
- すべてのリポジトリがデフォルトで恩恵を受けられるよう、グローバルレベルに基本的なルールを保持する。
- 子に影響を与えるべきでない非常に特定的なコンテキストには非継承可能ルールを使用する。
- 他のリポジトリやディレクトリに影響を与えずに対象を絞った例外を作るには子レベルの除外を使用する。
関連情報
- Kody ルール概要
- ディレクトリレベルの設定
- 設定の継承とオーバーライド
- 集中設定 — 1 つのリポジトリの
.kody-rules/下の YAML ファイルとしてルールを管理します。