社内開発勉強会 - 俺のCursorルール / My Cursor Rules

Transcript

1. 社内開発勉強会 - 生成AI 〜 俺のCursorルール By 今村 〜 株式会社Goals 今村 光希
2. 本日の目的 2 ショートカットエイリアスが SREの今村にとって、イケてる挙動してくれてそう ＆ Cursorに限らず、生成AI関連のルールって 思っているより気軽に追加して良いと思うよ
3. アジェンダ 3 • ショートカットエイリアスとは • How to ショートカットエイリアス • Cursorルールの書き方
4. はじめに 4 PRを出したことある人
5. はじめに 5 インフラリソースに新規作成/既存修正の PRを出したことある人
6. はじめに 6 インフラリソース ≒ 普段触らないリソースへのPRで Descriptionが十分に書けている人
7. はじめに 7 インフラリソース ≒ 普段触らないリソースへのPRで Descriptionが十分に書けている人 この中に入れていない人は ぜひ参考にして欲しい！！
8. ショートカットエイリアスとは 8 Cursorルールに定義している 俺ルール
9. ショートカットエイリアスとは 9 Cursorに同じことを聞く（依頼する）場合、 エイリアスとして定義して、簡単に呼び出そう
10. ショートカットエイリアスとは 10 Cursorルールとして定義してしまえば、 同一の挙動をある程度は担保できる
11. ショートカットエイリアスとは 11 実際に設定しているCursorルールの ショートカットエイリアス抜粋 ## ショートカットエイリアス - `/prdoc`: 修正差分を確認し、XXXX/.github/pull_request_template.md のテンプレートファ イルに従って、PRのコメントをMarkdown形式で提供してください。レスポンスは直接コピー可 能なコードブロック（```）で囲んで出力し、追加の説明は含めないでください。テンプレートに 沿った内容を埋め、具体的な実装内容と修正前後の比較をエビデンスとして含めてください。 - `/ask`: ユーザーがポリシーに関する相談を求めている場合。多角的な分析を含む積極的な回答を 提供してください。明確な指示がない限り、相談中にタスクを実行しないでください。 …etc
12. ショートカットエイリアスとは 12 実際に設定しているCursorルールの ショートカットエイリアス抜粋 ## ショートカットエイリアス - `/prdoc`: 修正差分を確認し、XXXX/.github/pull_request_template.md のテンプレートファ イルに従って、PRのコメントをMarkdown形式で提供してください。レスポンスは直接コピー可 能なコードブロック（```）で囲んで出力し、追加の説明は含めないでください。テンプレートに 沿った内容を埋め、具体的な実装内容と修正前後の比較をエビデンスとして含めてください。 - `/ask`: ユーザーがポリシーに関する相談を求めている場合。多角的な分析を含む積極的な回答 を提供してください。明確な指示がない限り、相談中にタスクを実行しないでください。 …etc
13. How to ショートカットエイリアス /prdoc 13 修正差分をCursorに確認させたうえ、 PRのDescriptionを自動生成させる
14. How to ショートカットエイリアス /prdoc 14 コード修正完了後〜 Git Pushする前に /prdoc と打つだけ
15. How to ショートカットエイリアス /prdoc 15 普段触らないコード箇所こそ PRのDescriptionは丁寧に！ ↓ ただ、Descriptionの作成自体は Cursor（生成AI）にぶん投げよう！
16. How to ショートカットエイリアス /ask 16 Agentモードでも、 疑似Askモードとして動かす
17. How to ショートカットエイリアス /ask 17 Cursorはどのモードで 使うことが多いですか？
18. How to ショートカットエイリアス /ask 18 私はAgentモードでしか動かしていません
19. How to ショートカットエイリアス /ask 19 でも、CursorにAskモード的に動いて欲しい時はある... • まずは、修正内容を提案だけして欲しい時 • コードを読み取って、質問だけしたい時 ※機能や、コードの構造等を把握だけしたいなど
20. How to ショートカットエイリアス /ask 20 Agentモードだと 「提案して」と聞いても 修正される可能性あり 右の例では、これだけで 数十行も修正されてしまった
21. How to ショートカットエイリアス /ask 21 Askモード使いたい時、 毎回マウスを動かして モードを変更するの？ ショートカットキーの 「cmd+.」で変更するの？
22. How to ショートカットエイリアス /ask 22 Askモード使いたい時、 毎回マウスを動かして モードを変更するの？ ショートカットキーの 「cmd+.」で変更するの？
23. How to ショートカットエイリアス /ask 23 Cursorに聞く時に /ask と打つだけ
24. How to ショートカットエイリアス /ask 24 CursorのAgent/Ask/(Manual)の モード変更は有効活用しよう！ ↓ ただ、モード変更はマウス使わず ショートカットキーを忘れてても エイリアスで疑似的に使える！
25. Cursorルールの書き方 25 Markdown(.md)ファイルではなく、 Cursorルール定義用の.mdcファイルを使おう
26. Cursorルールの書き方 26 .mdcファイルとは... • Cursor専用のルールファイル ◦ CursorエディタのAIアシスタント機能のための設定 ◦ プロジェクト固有のコーディングルールやガイドラインを定義 • Markdownベースの記法 ◦ 通常のMarkdown記法で書ける ◦ YAMLフロントマターでメタデータを定義
27. Cursorルールの書き方 27 何が良いの？ • 自動化 - 手動操作不要でルールが適用される ◦ リポジトリにコミットすれば全員に自動適用 ◦ コンテキストとして常に考慮される • 専用機能 - Cursorの機能を最大限活用 ◦ alwaysApply: true で常に適用 ◦ globs で特定ファイルタイプに限定可能
28. Cursorルールの書き方 28 特定のファイル/階層のみに ルールを適用できる ↓ 特に自分がドメインオーナー （コードオーナー）の範囲は ガンガン定義していこう！
29. 参考ドキュメント （2025年07月16日時点閲覧） 29 • 私のシンプルCursor活用方法 https://note.com/nike_cha_n/n/nd0f7566019ae • cursor使い始めてみた https://zenn.dev/nakajima_hello/scraps/0a64d9cd7a2ea5 • Cursorで使う.mdcファイルとは https://zenn.dev/channnnsm/articles/0df0ea29d63be3 • .clinerulesから.mdcファイルへ：初心者にもわかる完全ガイド https://note.com/unikoukokun/n/n3977a603633c