cursor重构前必须验证5项标准：①检查跨文件调用及ast调用；②保留可选参数undefined容忍逻辑；③@deprecated标记禁止重命名/提取；④须通过ruff或eslint校验；⑤日志/断点保留在逻辑入口处。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让Cursor在执行代码重构前，先确认是否满足5项以上可验证的检查标准，避免AI凭空重构、破坏调用链或违反团队规范，比如它可能把一个被3个组件依赖的工具函数直接内联，却没检查调用方是否传入了预期参数。
第一步：强制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"]
Agents 正在你的整个代码库中处理越来越复杂、运行时间更长的任务。本次版本引入了新的 agent 框架改进，以实现更好的上下文管理，并在编辑器和 CLI 中带来了许多提升使用体验的修复。
方法二：在 .cursorrules 中追加约束规则：
"never extract function that appears in more than 2 import paths without explicit approval"
【若AI未输出全部5条标准，或某条未带验证方式（如“扫描 import 语句”），则该次重构请求自动终止】
第三步：人工核对与触发重构
第一步完成后，AI会返回带 ✅/❌ 的检查结果。只有全部为 ✅ 时，才执行阶段二；任意一项为 ❌，AI必须说明失败原因及修复路径（例如：“❌ import-usage：src/components/Modal.tsx 第17行调用 validateForm()，参数数量为3，当前重构将减少至2个”）。
确认无误后，在Chat窗口输入“confirm refactor” → AI立即生成重构建议，且每处修改都附带回滚命令（如 git checkout HEAD -- src/utils/validation.ts）。
