| name | cursor-cli-step-orchestrator |
| description | 用 Cursor Agent(agent.cmd)进行“分步指挥、逐步验收、失败续跑”的工程改造流程,适合最小侵入式需求落地。 |
Cursor CLI Step Orchestrator
适用场景
- 任务较大,不能一次性改完
- 需要“每一步完成后再下发下一步”
- 需要可回滚、可验证(编译/检查)
- 需要超时后继续不中断
固定执行器(Windows)
%LOCALAPPDATA%\cursor-agent\agent.cmd
标准执行模板
& '%LOCALAPPDATA%\cursor-agent\agent.cmd' \
-p --trust --force \
--workspace '<PROJECT_PATH>' \
"Step N only: <单步目标+边界+验收条件>. Print changed files and concise summary."
说明:
-p:非交互打印模式,便于脚本编排
--trust:信任当前 workspace,减少确认阻塞
--force:允许执行必要命令(谨慎使用)
Step N only:强约束只做当前步,避免越界改动
推荐分步法(最小侵入)
- Step 1: 仅改系统门槛(Manifest/权限/Service 声明)
- Step 2: 仅建数据层(Entity/Repository)
- Step 3: 仅建服务层(前台服务、定时采集、容错)
- Step 4: 仅改权限流和 UI 入口
- Step 5: 仅改渲染刷新(轨迹折线、定时刷新)
- Step 6: 编译验收并修复本次引入问题
每步结束必须要求 agent 输出:
- 改动文件清单
- 简要变更点
- 验证结果(是否编译通过)
超时/中断续跑策略
- 若命令超时:
- 不重置任务
- 直接用“Continue Step X from current repo state ...”继续
- 若步骤漂移:
- 下一条 prompt 明确“Step X only / do not touch unrelated files”
安全边界
- 不允许跨步大改
- 默认只改指定文件
- 每步都要可编译或至少可定位错误
- 仅修复“本步引入”的编译错误,历史遗留问题单独说明
结果交付模板
- Step X 执行状态:成功/失败
- 变更文件:A, B, C
- 验收:编译通过/失败(附错误点)
- 下一步建议:Step X+1
快速示例
& '%LOCALAPPDATA%\cursor-agent\agent.cmd' -p --trust --force --workspace '<PROJECT_PATH>' "Step 3 only: implement TrackForegroundService with AMapLocationClient, 60s sampling, START_STICKY, notification channel, cleanup in onDestroy. Keep changes minimal and compile-friendly. Print changed files and summary."