用途
该技能用于把当前 Cursor 工作区切换到另一个项目目录。当用户想要切换项目、打开另一个代码库,或把当前对话迁移到不同的工作区根目录时使用。
主要能力
- 在对话中途切换项目,无需打开新窗口。
- 通过 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 工具:
- 工具:move_agent_to_root
- 参数:{ "rootPath": "/Users/<username>/Documents/development/<project-name>" }
3. 在新项目中定位
切换后,简要描述所看到的内容:
- 读取项目的 package.json、README.md 或等效文件,以了解技术栈。
- 运行 git status 显示当前分支和状态。
- 列出顶层目录结构。
创建新项目
如果用户想要启动一个新项目并切换到它:
- 调用 create_project 并传入所需路径——这会创建目录并初始化 git 仓库。
- 调用 move_agent_to_root 切换到该目录。
- 开始搭建脚手架。
适用场景
- 用户要求切换项目、打开另一个代码库。
- 用户希望把当前对话迁移到不同的工作区根目录。
- 用户想新建项目并立即在其中开始工作。
限制
- 仅在 cursor-app-control MCP 服务器已启用时可用。
- 切换发生在当前对话中——不会打开新窗口。
- 后续工具调用中的所有文件路径都将相对于新的根目录解析。
- 可以用同样的方式切回原项目。