SuperAPI AI 工具集

switching-projects

编程与开发

查看项目

更新于 10-16 02:25

技能介绍

用途

该技能用于把当前 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 显示当前分支和状态。
  • 列出顶层目录结构。

创建新项目

如果用户想要启动一个新项目并切换到它:

  1. 调用 create_project 并传入所需路径——这会创建目录并初始化 git 仓库。
  2. 调用 move_agent_to_root 切换到该目录。
  3. 开始搭建脚手架。

适用场景

  • 用户要求切换项目、打开另一个代码库。
  • 用户希望把当前对话迁移到不同的工作区根目录。
  • 用户想新建项目并立即在其中开始工作。

限制

  • 仅在 cursor-app-control MCP 服务器已启用时可用。
  • 切换发生在当前对话中——不会打开新窗口。
  • 后续工具调用中的所有文件路径都将相对于新的根目录解析。
  • 可以用同样的方式切回原项目。