写在前面
上一篇里我分享过：怎么用脚本从团队的 AI 工具仓库拉取共用的 prompt、command。用起来能跑，但对同事来说还是多一步——能不能直接做成 Cursor 插件，开箱即用？
答案是能。这次我完全用 Cursor 自带的 Plan 模式搭了一版插件，从拆任务到改 bug，大部分流程都在 IDE 里闭环完成。本文记录过程里 Plan 模式怎么用、哪里容易踩坑、以及如果你也想「让 AI 先写需求再写代码」可以怎么套同一套方法。
如果你只想用插件、不关心实现细节，可以直接跳到文末的下载与安装说明。
环境准备
| 项 | 说明 |
|---|---|
| IDE | Cursor 最新版（文中环境示例：2.5.0-pre.36.patch.0，以你本机为准） |
| 模型 | 个人体验：Sonnet 4.5 在规划与改扩展代码上比较稳 |
Plan 模式是什么？
Cursor Plan 可以理解为一种「先规划、后执行」的工作流：
- 你把目标说清楚（最好带上现有脚本或上下文）。
- Cursor 把大目标拆成若干步骤，并生成一份可勾选的执行计划（通常会落在 Markdown 里）。
- 你勾选要执行的步骤后，会新开 Agent 会话按步骤实现。
核心收益是：大任务被结构化，减少「一句话需求 → 模型乱改一通」的情况；同时计划文档本身也是可迭代的需求说明。
实战：我是怎么从脚本走到插件的
1. 把「脚本能力」说清楚
我先把现有脚本和诉求喂给 Cursor：希望做成「每次打开项目都会触发」的 Cursor 扩展，并问「需要怎么做」。
2. 让 Plan 拆步骤、勾选执行
模型会拆解步骤，把计划写进 md；我用全选勾选，确认后 Cursor 会新开 Agent 页面执行这些任务。
3. 生成物要人工验收
执行过程中它会尝试构建、补文件，但生成结果不保证一次可用——需要你在本机安装、跑一遍，发现问题就明确指出现象，让它修。
最终目录与说明文档类似下图（具体以你仓库为准）：
它也会顺带给出安装、维护、怎么通知团队等说明。
4. 按文档安装后自测
我按提示装好「新鲜出炉」的扩展后开始体验，却发现：并不是一打开 Cursor 就会在左下角提示要同步仓库——和预期不一致。
踩坑记录：往往是「扩展配置没配」
排查后发现：扩展侧配置没有填。
用 Ctrl + ,（Mac 上为 Cmd + ,）打开设置，搜索 cursor sync，把基础项配好。
配好后再打开 Cursor，就能看到预期的提示；在「已安装的扩展」里也能看到使用说明。
小结：VS Code / Cursor 扩展很多能力都挂在 contributes.configuration 和用户设置上；「能装上」≠「能按你想象工作」，第一次集成一定要走一遍「默认配置 → 空值行为」的检查。
可复制的方法：用一份「规范需求」喂给 Plan
如果你也想自己用 Cursor 跑一遍，建议准备一份结构清晰的需求文档再开 Plan。
- 把触发时机（如 workspace 打开）、要同步的资源、失败时要怎么提示写死；
- 把配置项名称、默认值列出来，减少模型猜配置 id；
- 需要的话附上现有脚本入口，让实现和团队习惯对齐。
团队怎么用：下载与安装
资源
.vsix直链：cursor-sync-1.0.0.vsix- 源码仓库：ApolloNaco/cursor-sync
- 详细安装说明：INSTALL.md
命令行安装示例
Windows（可在 Git Bash 中执行）：
cursor --install-extension "d:\project\aitools\cursor-sync-extension\cursor-sync-extension-1.0.0.vsix"
卸载旧版（把发布者 id 换成你本机实际值）：
cursor --uninstall-extension your-publisher-name.cursor-sync-extension
macOS / Linux： 请使用 Cursor 自带的 CLI（与 VS Code 类似，命令一般为 cursor），例如：
cursor --install-extension "/Users/你的用户名/路径/cursor-sync-1.0.0.vsix"
若本机未把 cursor 加入 PATH，可在 Cursor 命令面板中搜索 Shell Command: Install 'cursor' command in PATH 先安装命令行入口。
（原稿里用 code --install-extension 会装到 VS Code，与 Cursor 不是同一套扩展目录，团队统一 Cursor 时建议改用 cursor。）
插件市场
该扩展也已上架市场，可直接在 Cursor 扩展视图里搜索安装。
结语：Plan 很强，但有两件事它替你做不了
Plan + Agent 很适合搭骨架、补脚手架、反复修编译错误；但落到真实业务，仍要人肉把关。 做好自测。
欢迎在评论区反馈使用中的问题或需求，我会视情况迭代；也欢迎基于开源仓库二次开发。
本文基于个人实践整理，Cursor 版本与模型以官方更新为准。
