相关工具Claude Code CLI / Codex CLI / AGENTS.md / CLAUDE.md
最后审校2026-06-05
先判断这次任务能不能限定文件
AI Coding 的关键不是让 Agent 更自由，而是让它知道边界在哪里。你让它改一处样式，它可能顺手重构组件；你让它补一篇文章，它可能改数据模型；你让它修一个报错，它可能升级依赖。
先判断任务能不能限定文件。能限定，就不要给开放式任务。不能限定，也要先让 Agent 读代码并列出它认为需要改的范围。
让 Agent 先读文件不要动手
第一次提示先只读文件。这个动作可以暴露 Agent 的假设，也能拦住它直接写代码。
Text
先阅读文章列表、文章详情页和 data/blog.ts，不要改文件。
请列出：
1. 本次任务可能涉及的文件
2. 每个文件为什么需要读
3. 你认为最小修改范围
4. 需要我确认的风险点指定允许修改的文件
确认范围后，把允许修改的文件写清楚。不要只说“谨慎一点”。Agent 不知道你的仓库历史，也不知道哪些文件是别人刚改过的。
如果任务只涉及内容，就只允许改对应 Markdown。如果任务涉及页面展示，就列出组件和数据文件。这样 diff 出现额外文件时，读者马上能看出问题。
Text
按最小修改范围执行。
只允许修改：
- data/articles/ai-coding/example.md
- pages/articles/[slug].vue
不要修改：
- package.json
- pnpm-lock.yaml
- assets/css/main.css
- 其他文章文件明确禁止任务外重构
Agent 很容易把“顺便整理一下”当成帮助。长期维护项目里，顺便整理会制造额外 review 成本。
把禁止项写进提示词，也写进项目规则文件。短句比长解释更好。
- 不要重命名公开字段
- 不要改任务外样式
- 不要升级依赖
- 不要改路由结构
- 不要删掉旧数据兼容逻辑
- 不要覆盖用户未提交改动
保护用户已有改动
如果工作区已经有未提交改动，先让 Agent 识别哪些改动不是它做的。它需要绕开这些文件，或者只在你确认后继续。
Text
开始修改前先检查当前工作区改动。
列出你没有创建的改动。
如果目标文件里已经有用户改动，先停下来说明冲突点，不要覆盖。用 diff review 收尾
改完以后不要只看最终页面。让 Agent 按 diff review 的方式报告：哪些文件改了，为什么必须改，哪些文件没有碰，哪些验证没有跑。
Text
请 review 当前 diff，重点看：
1. 是否只改了允许修改的文件
2. 是否出现任务外重构
3. 是否影响旧数据或旧路由
4. 是否需要补验证
5. 哪些检查没有运行把边界写进 AGENTS.md 或 CLAUDE.md
如果你经常遇到 Agent 改太多文件，把边界规则写进 `AGENTS.md` 或 `CLAUDE.md`。这不是给它更多背景，而是给它更少自由度。
md
Edit scope:
- Read relevant files before editing.
- Keep edits scoped to the requested task.
- Do not refactor unrelated files.
- Do not change package versions unless asked.
- Preserve user changes in the working tree.
- Report unexpected files in the diff.改完后按这 6 项检查
交付前先查这几项：
- diff 里是否只有允许修改的文件
- 是否动了依赖、路由、配置或全局样式
- 是否保留旧数据和空状态
- 是否保护了用户已有改动
- 是否跑了相关验证
- 是否把重复边界写进项目规则