switching-projects

プロジェクトの切り替え

ユーザーが別のプロジェクトに切り替えたい、別のコードベースを開きたい、または現在の会話を別のワークスペースルートに移したい場合に、このスキルを使用します。

仕組み

Cursor には cursor-app-control という組み込みの MCP サーバーがあり、エージェントのアクティブなワークスペースディレクトリを変更する move_agent_to_root というツールがあります。これを使うと、新しいウィンドウを開かずに会話の途中でプロジェクトを切り替えられます。

手順

1. 切り替え先のプロジェクトを尋ねるか推測します — ユーザーが「my-app に切り替えて」と言った場合は、そのプロジェクトを検索します。よくあるプロジェクトの場所は次のとおりです。

   • ~/Documents/development/
   • ~/projects/
   • ~/code/
   • ~/repos/

   親フォルダーのディレクトリを一覧表示して、プロジェクトを探します。

   ls ~/Documents/development/
   

   特定できない場合は、どのプロジェクトを指しているのかユーザーに確認します。

2. ワークスペースを切り替えます — cursor-app-control MCP ツールを呼び出します。

   Tool: move_agent_to_root
   Arguments: { "rootPath": "/Users/<username>/Documents/development/<project-name>" }
   

   これにより、以降のすべてのコマンドで、表示されるワークスペース、ファイルツリー、デフォルトの作業ディレクトリが更新されます。

3. 新しいプロジェクトの概要を把握します — 切り替えた後、見えている内容を簡潔に説明します。

   • プロジェクトの package.json、README.md、または同等のファイルを読み、技術スタックを把握します。
   • git status を実行して、現在のブランチと状態を確認します。
   • トップレベルのディレクトリ構成を一覧表示します。

新しいプロジェクトの作成

ユーザーが新しいプロジェクトを開始して切り替えたい場合は、次の手順に従います。

1. 希望するパスを指定して create_project を呼び出します。これにより、ディレクトリが作成され、git リポジトリが初期化されます。
2. move_agent_to_root を呼び出して、そのプロジェクトに切り替えます。
3. 雛形の作成を開始します。

注意事項

• cursor-app-control MCP サーバーが有効な場合にのみ機能します。
• 切り替えは現在の会話内で行われ、新しいウィンドウは開きません。
• 以降のツール呼び出しで指定するすべてのファイルパスは、新しいルートを基準に解決されます。
• 同じ方法で元のプロジェクトに戻すこともできます。