# Cursorの機能と実践的な使い方 🌐 「画面を見ながら直してほしい」を、AIエージェントがそのまま実行できます。CursorのBrowserツールは、エージェントにブラウザの操作権を渡し、E2Eテストからデザイン→コードまでを一気通貫でこなします。 🏷️ タイトル: ブラウザ操作 🔗 URL: 📘 概要 Browserツールは、CursorのエージェントがIDE内のブラウザを直接操作できるようにする機能です。URLの移動、クリック、フォーム入力、スクリーンショット取得、コンソールログやネットワーク通信の確認までをエージェント自身が行えます。視覚的な確認とコード修正を同じループの中で回せるのが特徴です。 ⚙️ 機能の説明 ブラウザはMCPサーバー拡張で制御される安全なWebビューとして動作し、エージェントは次のような操作ができます。 ・ナビゲーション: URLへ移動、リンク追跡、履歴の前後移動、リロード ・操作: クリック、ダブルクリック、右クリック、ホバー、フォーム入力と送信 ・視覚確認: スクリーンショットを画像として取得し、レイアウトやUIを目で確認 ・デバッグ: JavaScriptコンソールのログ・エラー、ネットワーク通信を参照 ログはファイルに書き出され、エージェントは関連する行だけを選んで読むため、出力が膨大でも効率的に扱えます。また開発サーバーの自動検出により、サーバーの二重起動を防ぎます。認証Cookieやlocalstorage、sessionStorage、IndexedDBは同一ワークスペース内のセッションをまたいで保持されるため、ログイン状態を維持したまま検証を続けられます。 🛠️ 実践的な使い方 デザインサイドバーを使うと、デザインとコーディングを同時に進められます。要素の配置やflex方向、整列、グリッド、幅・高さ・padding・margin、色やグラデーション、影、不透明度、角丸などをスライダーで視覚的に調整できます。意図どおりの見た目になったら `Apply` を押すと、エージェントが視覚的な変更を適切なコード変更へ翻訳します。複数要素を選択してホットリロードでまとめて反映することも可能です。実行の安全性は承認モードで制御でき、`手動承認`（推奨）、`許可リスト方式`、`自動実行`から選べます。 💡 ユースケース ・E2Eテスト: テストデータでフォームを埋め、エラーメッセージを検証し、スクリーンショットを撮ってビジュアルリグレッションを確認 ・デザイン→コード: Figmaやモックを取り込み、ピクセル単位でHTML/CSSへ変換 ・アクセシビリティ監査: コントラスト比、セマンティックHTML、ARIAラベル、キーボード操作などWCAG観点でチェック ⚠️ 注意点 オリジン許可リストは「ベストエフォートの保護」に過ぎず、許可ドメインからのリンク遷移やクライアントサイドのリダイレクトで許可外オリジンに到達する場合があります。ユーザー自身の手動ナビゲーションは許可リストの制限を回避します。信頼できないコードに対して `自動実行` を使うのは避け、許可リスト設定は定期的に見直してください。 #Cursor# #AIコーディング#

# Cursorの機能と実践的な使い方 🕵️ 調査やコマンド実行の大量ログでメインの会話が埋まっていませんか。CursorのSubagentsは、専門タスクを独立した文脈に逃がし、ノイズを隔離してくれます。 🏷️ タイトル: 独立コンテキストの専門エージェント 🔗 URL: 📘 概要 Subagentsは、メインのエージェントが作業を委譲できる専門アシスタントです。それぞれ独立したコンテキストウィンドウを持ち、特定種類のタスクを処理して結果だけを親へ返します。複雑な作業を分割でき、複数を並列実行することも可能です。 ⚙️ 機能の説明 最大の利点は隔離です。長い調査や探索の中間出力がメインの会話を圧迫しません。サブエージェントは過去の会話履歴を参照できないため、必要な文脈は最初のプロンプトで渡されます。組み込みのサブエージェントは3種類あります。 ・Explore: 高速モデルでコードベースを検索・分析。単一検索の時間で約10並列の検索が可能 ・Bash: シェルコマンドを実行し、冗長な出力を親から隔離 ・Browser: MCP経由でブラウザを操作し、ノイズの多いDOMを要約に整理 カスタム定義は `.cursor/agents/`(プロジェクト)または `~/.cursor/agents/`(ユーザー)にMarkdownを置きます。同名衝突時はプロジェクト側が優先されます。 🛠️ 実践的な使い方 読み取り専用のセキュリティ監査役なら、フロントマターに `name: security-auditor`、`description` に観点、`model: inherit`、`readonly: true` を書き、本文に「変更点をセキュリティ観点でレビューし、リスクと修正案を簡潔に報告して」と指示するだけです。 主なフィールドは `name` / `description`(委譲判断に使われる) / `model`(`inherit` か `composer-2` 等) / `readonly`(編集・状態変更を禁止) / `is_background`(親をブロックせず実行)です。呼び出しは自動委譲のほか、`/security-auditor 認証フローを確認して` のような明示指定や自然な言及で行えます。「APIの変更レビューとドキュメント更新を並行で」と頼めば複数を並列起動します。 💡 ユースケース 検証エージェントで「完了」と主張された実装が本当に動くか独立検証し、未完成を見逃さない。デバッガでスタックトレースから根本原因を特定し最小修正。テストランナーで変更後に自動テストし、意図を保ったまま失敗を修正、といった2〜3個の役割が定番です。バックグラウンド実行は状態を逐次書き出すため、後から再開できます。 ⚠️ 注意点 並列5個のサブエージェントはおおむね単体の5倍のトークンを消費し、単純なタスクは起動オーバーヘッドでかえって遅くなることがあります。指定モデルはチーム管理者やプラン制約で上書きされる場合があります。Cursor 2.5以降は子サブエージェントを生成できますが、Taskツールへのアクセスが必要で、フックやポリシーでブロックされ得ます。曖昧な説明の汎用エージェントを大量に作るのは避け、具体的な指示の2〜3個に絞りましょう。 #Cursor# #AIエージェント#

# Cursorの機能と実践的な使い方 🧩 「あの作業、毎回同じ手順なのにAIに毎回説明している」を卒業しませんか。CursorのSkillsは、定型ワークフローを部品化してエージェントに覚えさせる仕組みです。 🏷️ タイトル: 再利用ワークフロー(SKILL.md) 🔗 URL: 📘 概要 Skillsは、特定ドメインのタスクの手順をエージェントに教える、ポータブルでバージョン管理可能なパッケージです。スクリプト・テンプレート・参照資料をまとめ、エージェントがツール経由で実行します。Rulesの進化形にあたり、文脈に応じて自動適用したり、スラッシュコマンドとして明示的に呼び出したりできます。 ⚙️ 機能の説明 各スキルは `SKILL.md` を中心に構成され、先頭のYAMLフロントマターで挙動を定義します。 ・`name`: 親フォルダ名と一致する小文字の識別子(必須) ・`description`: 何のためのスキルかと適用場面。エージェントがこの説明を読んで使うか判断します(必須) ・`paths`: glob パターンで対象ファイル種別にスコープを限定(任意) ・`disable-model-invocation`: `true` にすると自動適用されず `/skill-name` でのみ呼び出されるスラッシュ専用に(任意) 配置場所は階層的で、プロジェクトは `.cursor/skills/`(または `.agents/skills/`)、ユーザー全体は `~/.cursor/skills/` です。ルートは再帰的に走査され、ネストしたサブディレクトリも発見されます。スキルフォルダには `scripts/`(実行コード)、`references/`(必要時に読む資料)、`assets/`(テンプレや画像)を同梱できます。 🛠️ 実践的な使い方 たとえば `.cursor/skills/api-endpoint/SKILL.md` のフロントマターに `name: api-endpoint`、適用場面を書いた `description`、対象を絞る `paths: "src/api/**/*.ts"` を置き、本文に「ルートを registry に登録」「入力は zod で検証」「テストを必ず追加」といった手順を箇条書きします。 自動適用させたくない場合は `disable-model-invocation: true` を足し、Agentチャットで `/api-endpoint` と打って明示的に呼び出します。 💡 ユースケース モノレポでは各アプリ配下に `.cursor/skills/` を置くと、そのディレクトリ内のファイルへ自動的にスコープされ、`paths` を書かずに済みます。リリース手順・移行スクリプト・コードレビュー観点などを共有し、チーム全員が同じワークフローで作業できます。既存資産は Cursor 2.4 同梱の `/migrate-to-skills` で変換でき、「Apply Intelligently」(`alwaysApply: false`)なルールはスキルへ、スラッシュコマンドは `disable-model-invocation: true` 付きスキルへ自動移行されます。 ⚠️ 注意点 スキルの識別名は `SKILL.md` を含むフォルダ名から決まり、親カテゴリ名ではありません。旧来の `globs` フィールドは非推奨で、今は `paths` を使います。`/migrate-to-skills` は `alwaysApply: true` のルールやユーザーレベルのルールは移行しないため、これらは手動対応が必要です。 #Cursor# #AIコーディング#

# Cursorの機能と実践的な使い方 📏 「APIは必ずzodで検証」——その方針、毎回プロンプトに書く必要はありません。CursorのRulesがAIに永続的な記憶を与えます。 🏷️ タイトル: 永続指示(Project/Team/AGENTS.md) 🔗 URL: 📘 概要 RulesはCursorのエージェントへ、システムレベルの永続的な指示を与える仕組みです。LLMは補完間で記憶を保持しないため、Rulesがプロンプトレベルで再利用可能な文脈を供給します。プロンプト・スクリプト・ガイダンスを束ね、チーム横断で再利用できます。 ⚙️ 機能の説明 Cursorは複数の種類のRulesをサポートします。 ・Project Rules: `.cursor/rules`配下の`.mdc`ファイル。バージョン管理され、コードベースにスコープされます。 ・User Rules: Cursor設定で定義する全プロジェクト共通の好み。 ・Team Rules: ダッシュボードで管理する組織全体のルール(Team/Enterpriseプラン)。 ・AGENTS.md: プロジェクトルートやサブディレクトリに置くプレーンなMarkalternative。フロントマター不要で、ネスト配置も可能(より具体的な指示が親より優先)。 Project Rulesのフロントマターは挙動を制御します。`alwaysApply: true`で全チャットに適用、`globs`指定+`alwaysApply: false`でマッチ時に自動添付、`description`のみならエージェントが関連時に賢く適用、いずれも無ければ`@`メンション時のみ適用されます。 🛠️ 実践的な使い方 ・globsでファイル種別にスコープします。例:`src/**/*.tsx`、複数指定はカンマ区切り。これで「APIは必ずzodで検証する」を該当ファイル編集時に自動適用できます。 ・ルール生成はチャットで`/create-rule`、または`Cursor Settings > Rules, Commands`の「+ Add Rule」から行います。 ・`.mdc`の例として、フロントマターに `globs: src/api/**/*.ts` と `alwaysApply: false` を書き、本文に「受信ペイロードは必ず zod スキーマで検証」「検証失敗時は 400 と統一エラー形を返す」といった規約を記します。 ・チームでは適用順「Team Rules → Project Rules → User Rules」を踏まえ、Team Rulesで全社的な規約を強制します。 💡 ユースケース 「APIはzod検証」「コミットはConventional Commits」「ログはJSON構造化」といった反復方針をRules化し、globsで該当ファイルだけに自動適用。Gitにチェックインすればチーム全員が同じ規約の恩恵を受けられます。 ⚠️ 注意点 ルールは1ファイル500行以内に保ち、大きければ分割します。スタイルガイドの丸写しは避け(リンターに任せる)、内容の重複より「ファイル参照」を優先します。まれなエッジケースより頻出パターンを狙いましょう。User RulesはAgent(チャット)にのみ効き、Inline Editやその他のAI機能、Cursor Tabには影響しない点に注意してください。 #Cursor# #AIコーディング#

# Cursorの機能と実践的な使い方 ✏️ チャットを開かず、選んだコードにその場で「async化して」。CursorのInline Editは局所修正の最短ルートです。 🏷️ タイトル: Cmd/Ctrl+K 🔗 URL: 📘 概要 Inline Editは、チャット画面を起動せずにエディタ内で焦点を絞ったコード修正を行う機能です。コードを選択して`Cmd+K`(Mac)/`Ctrl+K`(Windows/Linux)を押すと、その場で指示入力欄が開きます。素早くピンポイントな変更を回すのに向いています。 ⚙️ 機能の説明 ・選択コードに対し自然文で指示を出し、`Return`で適用します。例:「これをasync関数に変換して」。 ・追撃の編集にも対応し、続けて指示を出して順に反映できます。 ・質問モード: `Opt+Return`(Mac)/`Alt+Return`(Windows/Linux)で、選択コードを編集せずに質問できます。提案を実装したくなったら「do it」と打って確定すれば適用されます。 ・エージェントへの引き継ぎ: より大きな複数ファイルにまたがる変更は、コードを選択して`Cmd+L`(Mac)/`Ctrl+L`(Windows/Linux)で、選択コードを文脈としてAgentを開けます。 🛠️ 実践的な使い方 ・関数を選んで`Cmd+K`→「async化して」「型注釈を付けて」「この分岐をearly returnに」など、局所的な書き換えを高速に回します。 ・仕様が不明なときは`Opt+Return`で質問モードに切り替え、「この正規表現は何にマッチする?」と確認 → 必要なら「do it」で修正へ移行します。 ・修正が込み入って複数ファイルに波及し始めたら、`Cmd+L`で選択コードごとAgentに引き継ぎ、自律的な実装へエスカレーションします。 💡 ユースケース レビューで指摘された一関数だけを`Cmd+K`で素早く直す、挙動が不安な箇所を質問モードで確かめてから直す、影響範囲が広がったらAgentへ昇格する、という段階的な使い分けが効果的です。 ⚠️ 注意点 Inline Editはあくまで局所的・焦点を絞った編集向けです。広範囲の変更を無理に`Cmd+K`で押し進めるより、早めに`Cmd+L`でAgentへ引き継ぐほうが安全で確実です。なおUser Rulesは原則Agent(チャット)にのみ適用され、Inline Editには効かない点にも留意してください。 #Cursor# #AIコーディング#

# Cursorの機能と実践的な使い方 🧭 いきなり書かせるか、計画させるか、調べさせるか。Cursorのモードは`Shift+Tab`ひとつで切り替えられます。 🏷️ タイトル: 動作モード(Shift+Tab) 🔗 URL: 📘 概要 Cursorのエージェントは複数のモードを持ち、タスクの性質に応じて振る舞いを切り替えられます。チャット入力欄で`Shift+Tab`を押すとモードを順に巡回でき、モードピッカーのドロップダウンからも選択できます。複雑な作業を検知するとCursorが自動でPlanモードを提案することもあります。 ⚙️ 機能の説明 ・Agentモード: 標準の実装モード。素早い変更や勝手の分かったタスクで、そのままコードに着手するのに向きます。 ・Planモード: 実装前に計画を立てるモード。エージェントが要件を明確にする質問を投げ、コードベースを調査して文脈を集め、包括的な計画を生成します。流れは「質問 → 調査 → 計画作成 → レビュー/編集 → ビルド実行」です。 ・計画はチャット上でもMarkdownでも編集でき、満足してからビルド(実装)に進めます。計画は既定でホームディレクトリに保存されますが、チームで共有するためワークスペースに移すこともできます。 🛠️ 実践的な使い方 ・複数ファイルに波及する機能は、まずPlanモードで計画を生成 → 内容を承認してから実装に進めると、手戻りを抑えられます。 ・読み取り専用で調査だけしたいときは、編集を伴わないモードで「この認証フローはどう動いている?」と尋ね、現状把握に徹します。 ・エラーの調査では、スタックトレースやログを貼り付け、仮説生成 → 根本原因の特定 → 修正方針、という順で進めると診断が安定します。 ・`Shift+Tab`で素早くモードを巡回し、タスクの粒度に合わせて切り替えます。 💡 ユースケース 大規模リファクタの前にPlanで全体像を承認、調査フェーズは読み取り専用で安全に把握、バグはエラー貼付からの根本原因特定、と段階を分けることで、AIに任せる範囲をコントロールできます。 ⚠️ 注意点 公式ドキュメントが強調する原則として、エージェントの出力が意図とズレたときは、追撃プロンプトで直そうとするより、いったん変更を巻き戻して計画を練り直すほうが速いことが多いです。「何を変えるか」を固めることが本質で、実装はAgentに委ねましょう。 #Cursor# #AIコーディング#

# Cursorの機能と実践的な使い方 🤖 「authをJWTに置換して」と一言頼むだけで、検索から複数ファイルの編集、テスト実行まで一気に走る。それがCursorのAgentです。 🏷️ タイトル: 自律エージェント(Cmd+I) 🔗 URL: 📘 概要 AgentはCursorのAIアシスタントで、`Cmd+I`でサイドペインを開いて起動します。指示(プロンプト/ルール)・ツール・モデルの3要素を組み合わせ、コードベースを横断しながらタスクを自律的に進めます。Cursor側でフロンティアモデルごとにツールの使い方を最適化しているのが特徴です。 ⚙️ 機能の説明 Agentは多彩なツールを呼び出してタスクをこなします。ツール呼び出し回数に上限はありません。 ・セマンティック検索でインデックス済みコードを意味ベースで探索 ・ファイルの読み書き、ディレクトリ走査、キーワード検索 ・ターミナルコマンドの実行と出力の監視 ・Web検索、画像の読み取り(png/jpg/gif/webp/svg)、UIモックの画像生成 ・ブラウザ操作によるスクリーンショットや視覚的な動作確認 ・必要に応じてユーザーへ確認質問をしつつ作業を継続 🛠️ 実践的な使い方 ・`Cmd+I`でAgentを開き、自然文でゴールを伝えます。例:「認証をセッションからJWTに置き換えて、関連テストも通して」 ・作業中でも指示を積めます。`Enter`はキューに追加(現在のタスク完了後に実行)、`Cmd+Enter`はキューを飛ばして即時送信です。キューはドラッグで並べ替えできます。 ・大きな変更の前にチェックポイントが自動保存されます。チャットのタイムラインのチェックポイントをクリックするとその時点をプレビューでき、「Restore Checkpoint」で全変更ファイルを巻き戻せます。 ・ターミナルのプロファイルは`Cmd/Ctrl+Shift+P`の「Terminal: Select Default Profile」で指定します。 💡 ユースケース 「authをJWTに置換」と依頼し、Agentが検索で実装箇所を特定 → 複数ファイルを編集 → テストを実行して結果を確認、という一連を自走させる使い方が王道です。途中で「ログ出力も追加して」とキューに積んでおけば、現在の作業完了後に続けて処理してくれます。 ⚠️ 注意点 チェックポイントはローカル保存でGitとは別物です。あくまでAgentの変更を巻き戻す用途に限り、恒久的なバージョン管理は必ずGitで行ってください。ツール呼び出しに上限はないため、破壊的なターミナル操作には目視確認を挟むと安全です。 #Cursor# #AIコーディング#