SuperAPI AI 工具集

cursor-multi-repo

通用与其它

查看项目

更新于 10-15 22:42

技能介绍

用途:在 Cursor 中同时处理多个仓库或 monorepo,通过多根工作区让 Cursor 只看到任务所需的仓库与文件,保留仓库归属与上下文边界。

主要能力:多根工作区(File > Add Folder to Workspace、保存为 .code-workspace,用 cursor mywork.code-workspace 打开);每个根独立索引,@Codebase 跨所有打开的根搜索,@Files 路径带根名前缀;关闭文件夹即从索引移除。monorepo 支持整体打开、只打开单个包,或用 .cursorignore 白名单式选择性索引(如 packages/*/ 加 !packages/api/)。跨项目上下文可用根名前缀引用文件,并通过 .cursor/rules 约定共享类型导入。规则继承方面,monorepo 中根规则对所有文件生效、包级规则仅作用于该包文件,两者匹配时同时进入上下文;多根工作区中各根规则相互独立、不跨根生效。

使用方式:先从一个仓库开始,仅为明确的跨仓库任务添加第二个根,完成后移除;使用各仓库自己的规则与 ignore 文件,提问跨仓库问题前先确认索引范围;改动按仓库分开,走各仓库正常的评审与测试流程。性能上建议减少打开的根、积极使用 .cursorignore、只打开具体包而非根目录、切换包时新建对话、跨包引用用 @Files 而非 @Codebase。

适用场景:修改 API 契约及其客户端时只打开这两个仓库,显式附加契约文件并分别提交;monorepo 中聚焦单个包开发。

限制与注意:需对每个仓库有明确授权并做共享根的数据分类审查;多根工作区受文件系统权限约束,无法索引用户不可读的仓库;打开共享盘或网络挂载可能较慢;根之间规则冲突时采用最严格的相关规则并由仓库负责人解决;索引变慢时应关闭不活跃的根,而非关闭 ignore 或安全控制。

前提条件:每个仓库的明确授权、共享根的数据分类审查、各根中已审查的规则与 ignore 文件,以及仅授予必要的文件系统权限。

官方文档与更多细节暂未提供。