cursorrules 「v5」

🇯🇵 日本語版ドキュメント

🌏 トップページに戻る | 🇬🇧 English

このリポジトリは、Cursor用のカスタムインストラクションを管理するためのものです。

前提

• このv5は、Cursor Agent に最適化されたカスタムインストラクションです
• Cursor Agent が自走（人の介入を受けずに自律処理）ができる前提として、Auto-Run の設定が適切に行われている必要があります。
• 最新の更新内容については更新履歴を参照してください。

概要

• Cursor のエージェント機能がリリースされてから、様々なパターンの処理を通して感じたのが「分析力の不足」でした。そのため、モデル（当時のClaude 3.5 Sonnet）が本来持っている分析能力を引き出せるように工夫し始めたのが、私のカスタムインストラクション作成の始まりです。

• 当初のテーマは、分析能力向上と自走力を高めることがでしたが、その後、モジュールやリソースの重複生成、意図せぬ、AIによるデザインの変更、エラー処理の無限ループなどの防止にも取り組み、モデルの刷新と性能向上と相まって、それなりの成果を残せたように思います。

• このバージョンアップグレードのフォーカスは GPT-5.1 最適化です：

  1. チェックリスト式の実装計画を立ててから着手。実行後はチェックリストごとに完了を確認することで、より計画性の高いタスク遂行が可能になっています。
  2. タスクを軽量・標準・重要の3段階に分類し、軽量タスクでは1〜2文の簡潔な報告にとどめ、重いタスクほど手順と検証を厚くするようになっています。
  3. 並行処理できるタスクは並行処理を行うことで、処理速度が向上します。

• さらに、read_file や apply_patch、run_terminal_cmd などのツール利用ポリシーを明文化し、常に安全な手順・権限でタスクを進めるワークフローを整備しています。

• v5 は、初期にAnthropic Prompt Generatorで作成、それ以降、その時期の最新モデルによる評価、実践による改善を繰り返してきました。カスタマイズの際も、お使いになるAIによる評価を行うことを推奨します。

• 詳細な更新内容（タスク分類、エラー処理の段階化、ツール利用ポリシーなど）についてはCHANGELOG.mdを参照してください。

• また、本リポジトリ自体がベストプラクティス例として、コミットメッセージ／PRメッセージのルールファイルおよびコミット・プッシュ・PR作成のワークフローコマンドのサンプルを含んでいます。

使用方法

1. .cursor/rules がまだ存在しない場合は、フォルダを作成してください。
2. パスが存在する場合は、ja/.cursor/rules/v5.mdc（日本語）または en/.cursor/rules/v5.mdc（英語）をコピーして配置してください（通常は v5.mdc として保存します）。
3. テスト方針ルールを有効にしたい場合は、同じフォルダに ja/.cursor/rules/test-strategy.mdc（日本語）または en/.cursor/rules/test-strategy.mdc（英語）をコピーしてください。
4. コミットメッセージ規約を有効にしたい場合は、同じフォルダに ja/.cursor/rules/commit-message-format.mdc（日本語）または en/.cursor/rules/commit-message-format.mdc（英語）をコピーしてください。
5. PR メッセージ規約を有効にしたい場合は、同じフォルダに ja/.cursor/rules/pr-message-format.mdc（日本語）または en/.cursor/rules/pr-message-format.mdc（英語）をコピーしてください。

• これらのテスト方針ルールの適用条件はデフォルトで「always」となっているため、所定のパスに存在していれば、それ以降のチャットで自動的に参照されます。
• 日本語版・英語版の両方で alwaysApply: true が設定されているため、利用したい言語やテストルールをデフォルトで有効にするかどうかに応じて、この設定を調整してください。
• これらを有効にすると、テストコードの実装・修正タスクでは、本リポジトリで定義した等価分割・境界値分析やカバレッジ要件などのテスト方針ルールが自動的に適用されます。

ルールファイル（.cursor/rules/*.mdc）とワークフローコマンド（.cursor/commands/*.md）の役割分担と使い方については、doc/rules-and-workflows.md を参照してください。

ガードレール関連ファイル

• ja/.cursor/rules/commit-message-format.mdc / en/.cursor/rules/commit-message-format.mdc

  • 役割: コミットメッセージのフォーマット（Prefix、サマリ、箇条書き本文など）と禁止事項を定義するファイルです。
  • 特徴: Conventional Commits をベースにしつつ、language による言語指定や差分ベースのメッセージ生成といった、このリポジトリ向けのガイドラインを含みます。

• ja/.cursor/rules/pr-message-format.mdc / en/.cursor/rules/pr-message-format.mdc

  • 役割: PR タイトルおよび本文のフォーマット（Prefix 付きタイトル、構造化された「概要」「変更内容」「テスト内容」など）と禁止事項を定義するファイルです。
  • 特徴: コミットメッセージ規約と整合する形で PR メッセージを構造化し、レビューや変更意図の把握をしやすくするためのガイドラインを提供します。

• ja/.cursor/rules/test-strategy.mdc / en/.cursor/rules/test-strategy.mdc

  • 役割: テストコードの実装・修正タスク向けに、等価分割・境界値分析やカバレッジ要件などのテスト方針ルールを定義するファイルです。
  • 特徴: 本番コードに意味のある変更が入る場合は対応する自動テストの追加・更新を求めるなど、品質面のガードレールとして機能します。

• ja/.cursor/rules/prompt-injection-guard.mdc / en/.cursor/rules/prompt-injection-guard.mdc

  • 役割: 外部ソース（RAG、Web、ファイル、API応答等）からのコンテキストインジェクション攻撃 に対する防御ルールを定義するファイルです。
  • 内容: 外部データ由来の命令制限、Instruction Quarantine、SECURITY_ALERT のフォーマット、ユーザー偽装検出など、外部からの攻撃を防ぎつつユーザーの正当な操作は妨げないガードレールを記述しています。
  • 特徴: ユーザー自身の操作は制限せず、外部から注入された悪意ある命令のみを無効化します。
  • 注意: このファイルのメタデータには alwaysApply: true が設定されていますが、Cursor の UI 設定（Always Apply / Apply Intelligently / Apply Manually）でルールの適用タイミングを制御できます。誤検知への対処方法については運用ガイドを参照してください。

• doc/custom_instruction_plan_prompt_injection.md / en/doc/custom_instruction_plan_prompt_injection.md

  • 役割: 外部コンテキストインジェクション防御のための 設計・脅威分析ドキュメントです。
  • 内容: 外部ソース経由の攻撃カテゴリ（A-01〜A-09）、それに対応する防御要件（R-01〜R-08）、外部データ制御層の設計方針、検証・運用計画などを整理しています。
  • 更新: 2024年11月に外部ソース攻撃に特化した内容に全面改訂されました。

翻訳ガイド

カスタムインストラクションを他言語へ翻訳する際の推奨プロンプトについては、TRANSLATION_GUIDE.md を参照してください。

注意事項

• User Rules、Memories に v5 と矛盾する指示が存在すると、モデルが混乱して、効果が減少します。それぞれの内容を十分にご確認ください。

ライセンス

MITライセンスの下で公開されています。詳細についてはLICENSEファイルを参照してください。

サポート

• このリポジトリのサポートはありませんが、フィードバックは歓迎いたします。また、Cursor関連情報をX（Twitter）で発信しているので、ご興味あればご覧ください。 X（Twitter）