使用指南
让 AI 改代码之前，先写一份能核对的验收清单
代码助手可以帮助理解和修改项目，交付是否完成还需要看差异、检查结果与实际操作。
先分清三个对象
- 官方文档介绍 Agent、项目规则及相关工具入口。
- 理解项目、修改文件和运行检查是不同工作环节。
- 代码生成结果需要结合项目要求审阅。
把需求写成能观察的结果
以修复一个表单为例，先写清什么输入会触发问题、正确结果应该显示什么、提交失败时怎样反馈。补充一个正常样本和一个边界样本，比只说“优化一下”更容易让后续检查有依据。
同时列出本次涉及的页面或文件，以及项目已有的检查命令。若工具建议增加依赖或修改其他模块，回到原来的验收目标判断是否需要；不要把文件改动数量当成完成程度。
交付时保留三份证据
第一份是文件差异，用来判断是否引入了与任务无关的变化。第二份是项目检查结果，用来说明代码能够通过哪些约束。第三份是实际操作记录，例如在浏览器中完成正常提交与错误输入。
若检查失败，让助手围绕具体错误继续修复，完成后重跑受影响的检查。不要把“已经修改”当作“已经修好”；最终说明应写清验证覆盖到哪里，以及哪些环境尚未检查。
把图中的流程展开
- 查看差异
确认修改符合需求范围
- 运行检查
记录项目约束与结果
- 实际操作
验证正常和异常路径
相关软件的界面参考
这张图来自本站已收录的产品资料，用于对照本文涉及的任务入口。图示设备、版本与当前可下载版本分别核对。
从代理任务看到代码变更 · 实际界面 · macOS（官方示例窗口）
阅读与使用边界
- 具体检查命令应以你的项目说明为准。
- 本文为通用审阅方法，没有对某次 AI 修改作正确性保证。
原文与整理说明
Cursor 官方文档（原文，在新标签页打开） · Cursor
本文为本站根据公开资料撰写的中文解读；建议与示意图是本站整理，不代表厂商承诺或安装实测。资料核对日期：2026-10-12。