switching-projects

切换项目

当用户想要切换到其他项目、打开另一个代码库，或将当前对话移至其他工作区根目录时，使用此技能。

工作原理

Cursor 内置了一个名为 cursor-app-control 的 MCP 服务，其中包含名为 move_agent_to_root 的工具，可更改 Agent 当前使用的工作区目录。这样，你无需打开新窗口，就能在对话过程中切换项目。

步骤

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 服务后，此功能才可用。
• 切换操作在当前对话中进行——不会打开新窗口。
• 后续工具调用中的所有文件路径都将相对于新的根目录解析。
• 你可以用同样的方式切回原项目。