カスタムルール

カスタムルールは、プロジェクト固有の動作や制約を定義し、VJSP AIエージェント全体で一貫性を確保するための強力な方法を提供します。カスタムルールを使用することで、一貫したフォーマットを強制したり、機密ファイルへのアクセスを制限したり、コーディング規約を適用したり、AIの動作をプロジェクトの特定のニーズに合わせて調整できます。

概要

カスタムルールにより、すべてのAIモデルがプロジェクトとやり取りする際に従うテキスト形式の指示を作成できます。これらのルールはガードレールおよび規約として機能し、コードベースとのすべてのやり取りにおいて一貫して適用されます。ルールはファイルシステム経由または組み込みUIインターフェースを通じて管理できます。

ルールの形式

カスタムルールはプレーンテキストで記述可能ですが、AIモデルによるより良い整理と理解のためにMarkdown形式の使用を推奨します。Markdownの構造化された性質により、モデルがルールをより効果的に解析・理解できるようになります。

ルールカテゴリの定義にはMarkdown見出し（#、##など）を使用
具体的な項目や制約の列挙にはリスト（-、*）を使用
必要に応じてコード例を含めるにはコードブロック（```）を使用

ルールの種類

VJSPは以下の2種類のカスタムルールをサポートしています：

プロジェクトルール：現在のプロジェクトワークスペースにのみ適用
グローバルルール：すべてのプロジェクトおよびワークスペースに適用

UIサポートについて

組み込みのルール管理インターフェースは汎用ルールのみをサポートしています。モード固有のルールはファイルシステム経由でのみ設定可能です。

ルールの保存場所

プロジェクトルール

カスタムルールは主に.vjsp/rules/ディレクトリから読み込まれます。これはプロジェクトレベルのルールを整理するための推奨アプローチです。通常、各ルールを説明的な名前を持つ個別のMarkdownファイルに保存することをお勧めします。ディレクトリ構造の例：

plaintext

project/
├── .vjsp/
│   ├── rules/
│   │   ├── formatting.md
│   │   ├── restricted_files.md
│   │   └── naming_conventions.md
├── src/
└── ...

グローバルルール

グローバルルールはユーザーのホームディレクトリに保存され、すべてのプロジェクトに適用されます。ディレクトリ構造の例：

plaintext

~/.vjsp/
├── rules/
│   ├── coding_standards.md
│   ├── security_guidelines.md
│   └── documentation_style.md

UIによるルール管理

VJSPには、.vjsp/rules/ディレクトリ内のファイルを手動で編集せずにカスタムルールを管理できる組み込みインターフェースが備わっています。VJSPウィンドウの右下隅にあるアイコンをクリックすると、ルール管理インターフェースが開きます。

このインターフェースでは以下の操作が可能です：

有効なすべてのルール（プロジェクトルールおよびグローバルルールを含む）を表示
ルールを削除せずにオン／オフを切り替え
インターフェース内で直接ルールを作成・編集
カテゴリおよび優先度でルールを整理

ルールの読み込み優先順位

汎用ルール（すべてのモードで有効）

ルールは以下の優先順位で読み込まれます：

グローバルルール（~/.vjsp/rules/から読み込み）
プロジェクトルール（.vjsp/rules/から読み込み）

グローバルルールとプロジェクトルールの間に競合が生じた場合、プロジェクトルールが優先されます。

ⓘ 注意

ルールファイルは.vjsp/rules/ディレクトリ内に配置することを強く推奨します。この構造化されたアプローチにより、細かい粒度でのルール管理が可能になり、責任の明確な分離が保たれ、将来のバージョンにおけるベストプラクティスにも適合します。

モード固有ルール

システムはモード固有ルールもサポートしており、これらは.vjsp/rules-${mode}/ディレクトリから独立して読み込まれます。

現在、モード固有ルールはプロジェクトレベルの設定のみをサポートしています。汎用ルールとモード固有ルールの両方が存在する場合、実行時にはモード固有ルールがより高い優先順位を持ちます。