Cursor代码重构需求提示词怎么设置检查标准

先说一个核心判断：AI重构代码，如果没有一套可量化的检查标准兜底，翻车的概率远比你想象的高。常见场景里，Cursor 可能把一个被三个组件依赖的工具函数直接内联，却没去验证调用方到底传没传预期的参数——这种“聪明反被聪明误”的案例，在团队里已经发生过不止一次。

所以，在让 Cursor 动手重构之前，必须先确认五项硬性检查标准。标准到位了，AI 才不会凭“感觉”瞎改，调用链不会断，团队规范也不会被绕过去。

第一步：强制AI输出结构化检查清单

操作很简单：在 Cursor 编辑器中选中待重构代码 → 按 Ctrl+K（Windows/Linux）或 Cmd+K（macOS）→ 输入 Refactor with judgment first → 回车 → 在提示框中粘贴下面这段提示词。

请分两阶段响应：

输出「重构前检查标准」，严格按以下顺序逐条列出并验证：
① 当前函数/类是否被其他文件 import 且存在非字面量调用（需扫描 import 语句 + AST 调用分析）
② 函数参数是否含可选属性（如 { id?: string }），若含，重构后必须保留 undefined 容忍逻辑
③ 是否存在 JSDoc @deprecated 标记，若有，禁止提取或重命名，仅允许添加兼容 wrapper
④ 项目根目录下是否存在 pyproject.toml 或 eslint.config.js，若有，重构结果必须通过 ruff check 或 eslint --fix 验证
⑤ 若原函数含 console.log 或 debugger，重构后日志位置必须保持在逻辑入口处，不得移入子函数

第二步：用.cursorrules固化检查动作

有两种方法可以把这套检查标准变成项目的永久约束：

在项目根目录创建 .cursorrules 文件，写入：

"refactor-checks": ["import-usage", "optional-param-safety", "deprecation-guard", "lint-compliance", "debugger-presence"]

在 .cursorrules 中追加一条更细粒度的约束：

"never extract function that appears in more than 2 import paths without explicit approval"

这里有个关键提醒：

——避免它跳过步骤就开始乱改。

第三步：人工核对与触发重构

第一步执行完后，AI 会返回一个带 ✅ 或 ❌ 的检查结果表。只有全部是 ✅ 时，才能进入阶段二；任意一条是 ❌，AI 必须说明失败原因以及修复路径。举个例子：

❌ import-usage：src/components/Modal.tsx 第17行调用 validateForm()，参数数量为3，当前重构将减少至2个

确认所有检查都通过之后，在 Chat 窗口输入 confirm refactor，AI 就会立即生成重构建议。而且每处修改都必须附带一条回滚命令，比如 git checkout HEAD -- src/utils/validation.ts。这样即使改出问题，也能一键恢复，不耽误进度。