Rules
再利用可能でスコープ化された指示により、Agentモデルの動作を制御します。
Rulesは、AgentとInline Editにシステムレベルの指示を提供します。プロジェクトの永続的なコンテキスト、設定、またはワークフローとして考えてください。
Cursorは3種類のrulesをサポートしています：
プロバイダーやフレームワークから多くの例が利用可能です。コミュニティが貢献したルールは、オンラインのクラウドソーシングコレクションやリポジトリで見つけることができます。
プロジェクトルートの
Project Rules
.cursor/rulesに保存され、バージョン管理されてコードベースにスコープされます。User Rules
Cursor環境全体に適用されます。設定で定義され、常に適用されます。
.cursorrules (Legacy)
まだサポートされていますが、非推奨です。代わりにProject Rulesを使用してください。
ルールの仕組み
大規模言語モデルは、完了処理間でメモリを保持しません。ルールは、プロンプトレベルで永続的で再利用可能なコンテキストを提供します。 適用されると、ルールの内容がモデルコンテキストの開始時に含まれます。これにより、AIはコードの生成、編集の解釈、またはワークフローの支援において一貫したガイダンスを得ることができます。ルールはChatとInline
Editに適用されます。アクティブなルールはAgentサイドバーに表示されます。
プロジェクトルール
プロジェクトルールは.cursor/rulesに配置されます。各ルールはファイルであり、バージョン管理されます。パスパターンを使用してスコープを設定したり、手動で呼び出したり、関連性に基づいて含めたりできます。サブディレクトリには、そのフォルダにスコープされた独自の.cursor/rulesディレクトリを含めることができます。
プロジェクトルールの用途：
- コードベースに関するドメイン固有の知識をエンコードする
- プロジェクト固有のワークフローやテンプレートを自動化する
- スタイルやアーキテクチャの決定を標準化する
ルールの構造
各ルールファイルはMDC（.mdc）で記述されます。これはメタデータとコンテンツをサポートする形式です。タイプドロップダウンからルールの適用方法を制御でき、これによりdescription、globs、alwaysApplyのプロパティが変更されます。
| ルールタイプ | 説明 |
|---|---|
Always | 常にモデルコンテキストに含まれる |
Auto Attached | globパターンにマッチするファイルが参照されたときに含まれる |
Agent Requested | AIが利用可能で、含めるかどうかを決定する。説明を提供する必要がある |
Manual | @ruleNameを使用して明示的に言及された場合のみ含まれる |
@service-template.tsのような参照ファイルは、ルールがトリガーされたときに追加のコンテキストとして含まれます。
ネストされたルール
プロジェクト全体の.cursor/rulesディレクトリにルールを配置することで、ルールを整理できます。ネストされたルールは、そのディレクトリ内のファイルが参照されたときに自動的にアタッチされます。
ルールの作成
New Cursor Ruleコマンドを使用するか、Cursor Settings > Rulesに移動してルールを作成します。これにより.cursor/rulesに新しいルールファイルが作成されます。設定からすべてのルールとその状態を確認できます。
ルールの生成
/Generate Cursor Rulesコマンドを使用して、会話内で直接ルールを生成します。エージェントの動作について決定を下し、それらを再利用したい場合に便利です。
ベストプラクティス
良いルールは、焦点が絞られ、実行可能で、適切にスコープが設定されています。- ルールは500行以下に保つ
- 大きなルールは複数の組み合わせ可能なルールに分割する
- 具体的な例や参照ファイルを提供する
- 曖昧なガイダンスは避ける。明確な内部ドキュメントのようにルールを書く
- チャットでプロンプトを繰り返す際はルールを再利用する
例
フロントエンドコンポーネントとAPIバリデーションの標準
フロントエンドコンポーネントとAPIバリデーションの標準
このルールはフロントエンドコンポーネントの標準を提供します：componentsディレクトリで作業する際：
- スタイリングには常にTailwindを使用する
- アニメーションにはFramer Motionを使用する
- コンポーネントの命名規則に従う
- すべてのバリデーションにzodを使用する
- zodスキーマで戻り値の型を定義する
- スキーマから生成された型をエクスポートする
ExpressサービスとReactコンポーネントのテンプレート
ExpressサービスとReactコンポーネントのテンプレート
このルールはExpressサービスのテンプレートを提供します：Expressサービスを作成する際はこのテンプレートを使用：
- RESTfulの原則に従う
- エラーハンドリングミドルウェアを含める
- 適切なログ設定を行う
- 上部にPropsインターフェース
- 名前付きエクスポートとしてのコンポーネント
- 下部にスタイル
開発ワークフローとドキュメント生成の自動化
開発ワークフローとドキュメント生成の自動化
このルールはアプリ分析を自動化します：アプリの分析を求められた場合：
npm run devで開発サーバーを実行- コンソールからログを取得
- パフォーマンス改善を提案
- コードコメントの抽出
- README.mdの分析
- markdownドキュメントの生成
Cursorで新しい設定を追加する
Cursorで新しい設定を追加する
まずアプリで使用するには、reactiveStorageServiceをインポートしてプロパティを使用します：
@reactiveStorageTypes.tsでトグルするプロパティを作成します。@reactiveStorageService.tsxのINIT_APPLICATION_USER_PERSISTENT_STORAGEにデフォルト値を追加します。ベータ機能の場合は@settingsBetaTab.tsxにトグルを追加し、そうでなければ@settingsGeneralTab.tsxに追加します。一般的なチェックボックスには<SettingsSubSection>としてトグルを追加できます。例については、ファイルの他の部分を参照してください。ユーザールール
ユーザールールはCursor設定 → ルールで定義されるグローバル設定で、すべてのプロジェクトに適用されます。プレーンテキストで記述され、好みのコミュニケーションスタイルやコーディング規約を設定するのに最適です：.cursorrules (レガシー)
プロジェクトルートの .cursorrules ファイルは引き続きサポートされていますが、廃止予定です。より多くの制御、柔軟性、可視性を得るために、プロジェクトルールへの移行をお勧めします。
FAQ
ルールが適用されないのはなぜですか？
ルールが適用されないのはなぜですか？
ルールタイプを確認してください。
Agent Requestedの場合は、説明が定義されていることを確認してください。Auto Attachedの場合は、ファイルパターンが参照されるファイルと一致していることを確認してください。ルールは他のルールやファイルを参照できますか？
ルールは他のルールやファイルを参照できますか？
はい。
@filename.tsを使用して、ルールのコンテキストにファイルを含めることができます。チャットからルールを作成できますか？
チャットからルールを作成できますか？
はい。
/Generate Cursor Rulesコマンドを使用して、チャットからプロジェクトルールを生成できます。Memoriesが有効になっている場合、メモリは自動的に生成されます。ルールはCursor Tabやその他のAI機能に影響しますか？
ルールはCursor Tabやその他のAI機能に影響しますか？
いいえ。ルールはAgentとInline Editにのみ適用されます。