switching-projects について
Cursor の会話を別のプロジェクトのワークスペースへ移すスキルです。プロジェクトの検索、切り替え後の確認に加え、新規プロジェクトの作成手順も案内します。
主な機能
- 01一般的なディレクトリからプロジェクトを検索
- 02move_agent_to_root でワークスペースを切り替え
- 03切り替え後にファイルと Git の状態を確認
- 04新規プロジェクトを作成して移動
活用シーン
- 01別のコードベースで会話を続ける
- 02指定されたプロジェクトを探して開く
- 03新規プロジェクトを作成して移動
MCP 対応
Cursor 内蔵の `cursor-app-control` MCP サーバーと `move_agent_to_root` ツールで、アクティブなワークスペースを変更します。新規プロジェクトの作成には `create_project` の呼び出しも必要です。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/switching-projectsを入力して読み込まれたか確認します。
詳細
プロジェクトの切り替え
ユーザーが別のプロジェクトに切り替えたい、別のコードベースを開きたい、または現在の会話を別のワークスペースルートに移したい場合に、このスキルを使用します。
仕組み
Cursor には cursor-app-control という組み込みの MCP サーバーがあり、エージェントのアクティブなワークスペースディレクトリを変更する move_agent_to_root というツールがあります。これを使うと、新しいウィンドウを開かずに会話の途中でプロジェクトを切り替えられます。
手順
-
切り替え先のプロジェクトを尋ねるか推測します — ユーザーが「my-app に切り替えて」と言った場合は、そのプロジェクトを検索します。よくあるプロジェクトの場所は次のとおりです。
~/Documents/development/~/projects/~/code/~/repos/
親フォルダーのディレクトリを一覧表示して、プロジェクトを探します。
ls ~/Documents/development/特定できない場合は、どのプロジェクトを指しているのかユーザーに確認します。
-
ワークスペースを切り替えます —
cursor-app-controlMCP ツールを呼び出します。Tool: move_agent_to_root Arguments: { "rootPath": "/Users/<username>/Documents/development/<project-name>" }これにより、以降のすべてのコマンドで、表示されるワークスペース、ファイルツリー、デフォルトの作業ディレクトリが更新されます。
-
新しいプロジェクトの概要を把握します — 切り替えた後、見えている内容を簡潔に説明します。
- プロジェクトの
package.json、README.md、または同等のファイルを読み、技術スタックを把握します。 git statusを実行して、現在のブランチと状態を確認します。- トップレベルのディレクトリ構成を一覧表示します。
- プロジェクトの
新しいプロジェクトの作成
ユーザーが新しいプロジェクトを開始して切り替えたい場合は、次の手順に従います。
- 希望するパスを指定して
create_projectを呼び出します。これにより、ディレクトリが作成され、git リポジトリが初期化されます。 move_agent_to_rootを呼び出して、そのプロジェクトに切り替えます。- 雛形の作成を開始します。
注意事項
cursor-app-controlMCP サーバーが有効な場合にのみ機能します。- 切り替えは現在の会話内で行われ、新しいウィンドウは開きません。
- 以降のツール呼び出しで指定するすべてのファイルパスは、新しいルートを基準に解決されます。
- 同じ方法で元のプロジェクトに戻すこともできます。