CorsurのProject Rulesで発生している問題の対処法 ※v0.47
この記事の対象者
この記事は以下のような方を対象としています：
- Cursorの最新バージョン（v0.47）を使用している
- CursorでProject Rulesを設定したものの、適用されなくて困っている
- AgentにProject Rulesファイルを作成させたら、空のファイルになって困っている -> 3/22追記 現在は一部解決済み
Project Rules（知っている人は読み飛ばし推奨）
v0.45から追加された機能で、プロジェクトごとにAgentの動作をカスタムするためのルールを設定できる機能です。
プロジェクトのルートディレクトリに.cursor/rulesディレクトリを作成し、ルールを記述した.mdcファイルを配置することで使用できます。
ルール定義ファイル（.mdc）の構成
以下のfrontmatter部分と、markdown形式で記述したルールコンテキストで構成されます。
---
`description`: ルールが適用される条件の説明
`globs`: ルールが適用されるファイル/フォルダのglobパターンを記述(ex. src/**/*)
`alwaysApply`: 常にルールを適用するかどうかのbool値
---
Rule Type
v0.47.5から、Project RulesにRule Typeが追加されました。
これにより、作成したProject Rulesがいつ適用されるかを明確に指定できるようになりました。
使用できるルールタイプ
-
Always Apply: ルールを常時適用する -
Auto Attached: 指定したglobパターンに一致するファイルが参照された時に自動的にルールが適用される -
Manual Reference: ルールファイルを明示的に参照した場合に適用 -
Semantic Selectio: Agentがdescriptionを読んで、現在のタスクに関連すると判断した場合に適用
現バージョンで発生している問題
主に以下の2つの問題が発生しているみたいです。
- 「Auto Attached」の自動参照が機能しない
- Agentにルール定義ファイル(.mdc)を作成させると中身が空になる -> 3/22追記 現在は一部解決済み
「Auto Attached」の自動参照が機能しない問題について
ルールタイプにAuto Attachedを選択した場合、File pattern matchesに適切なglobパターンを入力することで、本来は対象ファイルが参照されているAgentとのチャットでは自動でルールが適用されます。しかし、現状はこれが正常に機能していないようです。
実際、以下のようにtest.mdcを作成して
Agentにてtestフォルダを参照して
「現在、あなたにはどのようなルールが適用されていますか？」
と質問してみましたが、test.mdcの内容は参照されていないようです。
この問題は以下のCursorのフォーラムでも言及されています。
原因
Auto Attached選択時、UI上にdescriptionフィールドが表示されないにもかかわらず、必須のため
です。
なかなかひどい話だと思うのですが、最新のv0.47ではルールタイプにAuto Attachedを選択した場合は、Descriptionの入力欄が表示されないにもかかわらず、これがないとシステムがルール定義ファイルを認識できないようです。
(推測ですが、システムがルールファイルをインデックス化または認識する際に、Descriptionフィールドを利用していると思われます)
対策
メモ帳で編集してDescriptionの内容を追加する
Cursorで.mdcファイルを開くと、自動でルール定義ファイル用のUIが開かれてしまうため、メモ帳などのテキスト編集アプリを使用して、frontmatterにDescriptionを追加することで、システムが認識できるようになります。
さっそくやってみましょう。
.cursor/rules/test.mdcをメモ帳で開いて、descriptionに説明を追加します。
改めてAgentに現在適用されているルールを質問します。
テストルールについて言及されましたね。以上です。
Agentにルール定義ファイル(.mdc)を作成させると中身が空になる問題について
Project Rulesを使用していると、以下のようなニーズからルール定義ファイルをAgent自身に作成させたいといったニーズが出てくるかと思います。
- Agentにそこまでのチャットの作業手順をルール化して保存させたい
- 使用するライブラリについて、使い方をルール化して保存させたい
参考：
しかし、現在のバージョンでこれを行うとAgentに作成させたルール定義ファイル(.mdc)の中身が空になってしまうという問題があるようです。
この件は以下のフォーラムでも言及されています。
原因
これについては今のところ明確な原因は判明していません。
いくつかのフォーラムで以下のように考察されています。
- ルール定義ファイルを作成する際にドキュメントで言及されていない何らかの要件がある
- Agentが誤って編集して保存することを避けるために
.mdcファイルの保存権限を持たない
これについては以下の対策に効果があることを考えると、後者が原因のような気はします。
対策
対策の一つとして、以下のフォーラムの内容が有効らしいです。
手順：
- Agentで
.cursor/rules/に新しい空のルール定義ファイル(.mdc)ファイルを作成する - Agentで作成した空のファイルを参照し、ルール内容を追加する
- Cursorを完全に閉じようとする
- 「保存されていない変更があります」という警告メッセージが出る
- 「上書きする」をクリックして保存する
- 再度Cursorを開くと、ルール定義ファイルに変更が保存されている
追記 3/22
今朝試してみたら、問題なくAgentから作成できるようになっているようになっていました。パッチにも特に記載はないようですが。。
ただし、Agentから作成した場合は、frontmatter部分が認識されない問題があり、作成した後に手動で直す必要はあるみたいです。早く解決してくれると嬉しいですね。
このやり方で解決した！という方がいたら是非ご教示いただけると幸いです。以上。
Discussion