先让 Agent 读 README、目录、测试命令与完成定义，再允许改文件；用可粘贴开工模板，禁止一上来全仓重构。
要点
- 官方同向：Cursor Quickstart／最佳实践强调先理解代码库再改、优先 Plan；Codex 文档示例亦是先
explain this codebase／Tell me about this project，再用/init沉淀AGENTS.md（Quickstart、Best practices、Codex CLI，核验日 2026-10-30）。 - 开工四件套（建议每次开新任务勾一遍）：① README／贡献说明；② 顶层目录与入口；③ 项目已有的构建／测试／lint 命令；④ 本次完成定义（改哪些路径、怎样算做完、失败时停）。
- 持久化：把“怎么跑测试、别动什么”写进根目录
AGENTS.md（Codex 与 Cursor 均可）或 Cursor.cursor/rules；规则宜短、可执行，风格交给 linter（AGENTS.md、Cursor Rules）。 - Plan 优先于盲改：Cursor Agent 输入框
Shift+Tab可开 Plan Mode（研究代码库→澄清问题→出计划→你批准后再写）；计划可存Save to workspace →.cursor/plans/“（官方博客，核验日 2026-10-30；快捷键标待核）。 - 可粘贴模板：下文给“只读摸底”与“窄改开工”两段提示；反例是空仓一句“重构整个项目”。
- 证据强度：先读再改／Plan／AGENTS 发现规则来自官方（高）；清单条目为编译归纳的可跟做流程（中高）；UI 文案标待核。
正文
场景
新开一个 Agent 对话，最贵的错误往往不是模型“不够聪明”，而是你还没告诉它：仓库怎么跑起来、什么叫做完、哪些文件动不得。结果是它边猜边改，diff 又长又偏。编码代理适合在你标清地图之后加速，不适合替你做“第一次克隆后的定向”。
下文给一份可反复用的开工清单：先读什么、提示怎么贴、规则文件写什么、哪些开场要直接否决。覆盖 Cursor Agent 与 Codex CLI（含 Cursor 里用 Codex／同类 Agent 的习惯）；与《只改指定文件》篇互补：那篇管作用域，本稿管动手前的顺序。
可跟做步骤／可抄工作流
证据强度：高（Cursor Docs／Blog＋Codex Learn，核验日 2026-10-30）；UI／快捷键标待核。
开工清单（对话开始前 2 分钟）
- Git 检查点：干净或已开分支；
git status可回滚。无版本控制时先不要大范围授权写入（与审批篇一致）。 - 确认说明文件是否存在：根目录
README、CONTRIBUTING、AGENTS.md、Cursor 的.cursor/rules／旧版.cursorrules（官方建议迁到.cursor/rules的.mdc）。没有就先让 Agent 只读生成摘要，再决定是否/init或手写短规则。 - 记下四条事实（可写在提示里）：入口文件或启动命令；测试命令（优先单测／包级，不先全仓）；包管理器；“禁止改”的路径（锁文件、CI、生成目录等）。
- 选模式：复杂需求用 Plan／先只读；琐碎单文件可直接窄改。Cursor：
Shift+Tab切 Plan Mode。Codex：先read-only或低风险权限摸底，再放宽。
模板 A：只读摸底（可直接粘贴）
在改任何文件之前，先只做只读调研，输出：
1) README／文档里写明的安装与启动步骤（引用路径）；
2) 顶层目录各自职责（3～8 条）；
3) 主入口与关键模块路径；
4) 仓库里已有的测试／lint／typecheck 命令（从 package.json、Makefile、README 查找）；
5) 你建议我下一步最小改动的范围。
现在不要修改、创建或删除任何文件，不要安装依赖，不要跑会写磁盘的命令。模板 B：窄改开工（摸底之后）
目标：【一句话】
已确认：
- 测试命令：【例如 npm test -- path】
- 只允许修改：【路径列表】
- 禁止修改／创建：【锁文件、CI、无关包…】
- 完成定义：
1) 列出实际改动文件与理由；
2) 跑【测试命令】到通过；
3) 若必须扩大范围，先停下来问我。
先给出不超过 8 步的实施计划，等我回复“按计划执行”后再改文件。把“先读再改”写进规则（可抄短片段）
根目录 AGENTS.md 示例：
## 开工
- 新任务先读 README 与相关 AGENTS；不确定入口时先搜索再改。
- 默认先给计划或只读结论；用户确认后再写入。
- 使用仓库已有的测试命令验证；不要擅自升级 major 依赖。
## 变更边界
- 只改用户点名的路径；需要扩 scope 先询问。Cursor 可用 Always Apply 的短规则表达同一纪律；长文 style guide 不要整本塞进规则（官方最佳实践）。
验收
- Agent 第一轮输出是否引用了真实路径／命令（可点开核对）。
- 出现写入前是否经过你的“按计划执行”或 Plan 批准。
git diff --stat是否落在允许列表内。
真实用户诀窍／反例
- 诀窍：完成定义写进同一条提示。 “改完跑 X；失败就修到绿；不要动 Y”比事后补救便宜。
- 诀窍：规则里写命令指针，不写百科。 Cursor／Codex 都建议短规则＋指向仓库内范例文件；Agent 需要时再读。
- 诀窍：跑偏就开新对话，不要在脏线程里加戏。 官方建议任务切换／反复犯错时新开；可用
@引用旧聊天要点而非整段粘贴。 - 反例：一上来“重构整个项目／优化架构／统一代码风格”。 无地图、无完成定义＝默许全仓扫描与大范围写入。
- 反例：把全量 format／全仓 lint 当第一完成定义。 格式与 lint 交给本地工具与 CI；Agent 完成定义优先绑行为与测试。
- 反例：README 与 AGENTS 互相矛盾还不先澄清。 先让 Agent 列出冲突点，你定口径后再改。
适用边界
- 本稿是动手顺序与提示模板，不替代路径合同篇（只改指定文件），也不替代终端审批篇。
- Plan Mode 快捷键、
/init菜单位置、Cloud Agents 是否同等加载本地 AGENTS：以当前产品界面与文档为准（待核）。 - 超大 monorepo 仍需先选对工作目录／包级 AGENTS，否则“读了根 README”不等于读对了你要改的包。
【来源与编译】
- Quickstart｜Cursor Docs｜https://cursor.com/docs/get-started/quickstart｜核验日 2026-10-30（先解释代码库再改）
- Best practices for coding with agents｜Cursor Blog｜https://cursor.com/blog/agent-best-practices｜核验日 2026-10-30（Plan Mode、规则宜短、新对话时机、具体提示）
- Rules｜Cursor Docs｜https://cursor.com/docs/rules｜核验日 2026-10-30（AGENTS.md、
.cursor/rules、最佳实践） - Custom instructions with AGENTS.md｜ChatGPT Learn／Codex｜https://learn.chatgpt.com/docs/agent-configuration/agents-md｜核验日 2026-10-30（发现顺序、就近覆盖）
- Codex CLI｜ChatGPT Learn｜https://learn.chatgpt.com/docs/codex/cli｜核验日 2026-10-30（explain／permissions／init 入门路径；与既有第一次开 Agent 篇一致）
- Your first project｜Cursor Help｜https://cursor.com/help/getting-started/first-project｜核验日 2026-10-30
- 本文说明：编译“开工四件套＋两段模板＋规则短片段”；社区空泛“让 AI 重构”作反例归纳；未把未核快捷键坐标写成永久事实；UI 标待核。