新手第一次使用 Cursor，目标应是建立最小闭环：确认项目状态、只读了解、提出小任务、审查改动、运行验证。不要把“帮我完成整个项目”作为第一条指令。
开始前先准备什么
打开项目前先运行 git status，确认工作区里没有来源不明的改动，并准备项目已有的启动或测试命令。
如果项目还没使用 Git，先复制一份目录作为回退点；如果已经使用 Git，至少记下当前分支和基线状态。第一次练习优先选文案、空状态或一个局部样式，不选登录、支付、数据库迁移、权限控制等高影响功能。还应从 README、package.json、pyproject.toml 等真实文件找到验证命令，不能让 Agent 猜。
建议先写下本次唯一目标，例如“将搜索无结果时的提示改得更明确，接口和数据结构保持不变”。这样审查 diff 时有明确边界，也能判断 Agent 是否把简单任务扩大成重构。
实际操作步骤
用 Open Folder 打开仓库根目录，先让 Agent 只读 README、依赖文件和入口。
- 打开正确根目录：用 Open Folder 打开包含 README 和版本控制目录的仓库根目录，再运行
git status --short。先保存输出，后面才能区分原有改动与 Agent 新改动。 - 先问再改：让 Agent 只读 README、依赖文件和入口。要求回答附文件路径，并把不确定内容单独列出，避免把猜测当项目事实。Cursor 官方快速入门也建议先让 Agent 解释代码库和主要入口。
- 限定第一次改动：选择一个只涉及一个行为的小任务，例如修改空状态文案，并明确禁止修改接口、依赖和其他页面。先让 Agent 给出预计文件清单，清单异常就暂停。
- 审查实际变化：逐文件阅读 diff，检查是否有整文件格式化、锁文件变化或无关删除。随后运行最小相关测试；测试失败时保存原始命令、退出码和第一段关键错误，不要直接要求“继续修到好”。
- 手工确认：启动本地页面或运行脚本，亲自复现目标状态。功能正确后再次运行
git status --short，确认改动文件与计划一致。
可直接复制的第一次提问
先不要修改文件。请阅读 README、依赖清单和程序入口，回答：
1. 项目如何启动和测试；
2. 搜索空状态由哪个组件负责，并给出文件路径；
3. 完成“让空状态提示更明确”最少需要改哪些文件；
4. 哪些信息目前无法从仓库确认。
等我确认后再修改。预期回答应包含可打开的文件路径、仓库中已经存在的命令和一个有限改动范围。如果回答出现仓库里找不到的文件或命令，先让 Agent 引用原文位置，再手工核对。不要因为回答流畅就跳过证据。
怎样验证结果
完成标准是 diff 只包含预期文件、相关测试真实执行并通过、手工检查看到目标行为。
可以用“三次对照”签收：改动前的 git status 是基线，diff 说明改了什么，测试和手工步骤说明结果是否成立。若没有自动测试，至少记录运行命令、访问路由、输入数据和看到的预期文字，并在提交说明中标明仍缺少自动回归。Agent 的“已完成”总结不属于验证证据。
常见错误
- 不先看 git status，容易混入原有改动。
- 只看 Agent 总结，不看 diff，无法确认真实变化。
- 没有测试时应写清未验证边界。
适用边界
首次任务不要执行部署、数据库迁移、删除文件或生产配置变更。
涉及安全、权限、计费或生产数据的修改，即使代码量很小，也不属于安全的第一次任务。项目本身无法启动时，应先把“恢复可运行基线”作为独立问题处理；否则无法判断新改动是否引入回归。
相关问答
Agent 解释错入口怎么办？
要求它给出构建文件、路由注册或调用关系的证据，再手工打开文件核对。
第一次适合让它新增依赖吗？
通常不适合；先完成不新增依赖的小任务，熟悉权限与验证流程。
资料与适用范围
本文根据 2026 年 10 月 1 日核验的 官方资料 1、官方资料 2 整理。示例流程未在你的设备、账号或仓库中实测，界面、方案、权限和项目命令应以当前环境为准。
Ai菜鸟网。发布者：AI小管家，转载请注明出处：https://www.alyyhw.com/32595.html
