编辑前规划模式
先要智能体计划、审查、再执行 — 大任务的廉价保险。
智能体开发进阶
为什么
MCP 参考服务器仓库约有 9 万 GitHub star，代理 AI 基金会成员从 2025 年 12 月的 49 个创始成员增长到 2026 年 8 月的 247 个，显示多智能体生态快速增长。计划是廉价产物，能在昂贵编辑前捕获错误假设。
审查 10 行计划仅需秒级；回滚 30 错误文件编辑需一小时。大任务先规划是最高 ROI 习惯。
何时使用
触及 >5 文件、陌生代码、或风险迁移始终先规划。可一眼看清的单文件编辑跳过。
如何做
1. 提示："列出待改文件及每文件变更；暂不编辑"。
2. 审查计划：范围、顺序、风险、遗漏文件。
3. 聊天中调整计划后再放行。
4. 分步执行，每步一 commit。
5. 对比结果与计划；调查任何偏差。
示例
> 仅计划：将 40 路由从 assertValid 迁到 zod。列出每文件 + 所需 schema。
[审查 40 行表，发现 2 遗漏路由，补上]
> 按表执行，每路由一 commit，首个 tsc 错误即停。
计划中发现 2 遗漏路由避免了破碎的部分迁移。
常见问题
- ⚠为省时跳过计划：虚假节约 — 错误编辑成本更高。
- ⚠Error: Cannot find module '@modelcontextprotocol/sdk' → `npm install @modelcontextprotocol/sdk`；智能体需 SDK 调用 MCP 工具。
- ⚠错误："Tool timed out after 30000ms" → 调大超时配置或将任务拆成智能体可增量完成的小子任务。
最佳实践
- ✓始终说'暂不编辑'使智能体规划而非行动。
- ✓将计划视为契约；拒绝任何偏离的执行。
- ✓用具体指标衡量结果（节省时间、缺陷率、测试覆盖率），使实践可被论证和改进。
常见问题解答
什么是编辑前规划模式？
先要智能体计划、审查、再执行 — 大任务的廉价保险。 它可帮助开发者快速理解 编辑前规划模式 的核心价值与适用场景。
如何开始使用编辑前规划模式？
开始使用 编辑前规划模式，建议先掌握以下要点：提示："列出待改文件及每文件变更；暂不编辑"。
编辑前规划模式 的常见误区有哪些？
使用 编辑前规划模式 时常遇到的问题包括：为省时跳过计划：虚假节约 — 错误编辑成本更高。；Error: Cannot find module '@modelcontextprotocol/sdk' → `npm install @modelcontextprotocol/sdk`；智能体需 SDK 调用 MCP 工具。；错误："Tool timed out after 30000ms" → 调大超时配置或将任务拆成智能体可增量完成的小子任务。。
编辑前规划模式 的最佳实践是什么？
编辑前规划模式 的最佳实践包括：始终说'暂不编辑'使智能体规划而非行动。；将计划视为契约；拒绝任何偏离的执行。；用具体指标衡量结果（节省时间、缺陷率、测试覆盖率），使实践可被论证和改进。。
如何深入学习编辑前规划模式？
从官方文档入手，再在 GitHub 上搜索真实示例；先在小实验仓库验证模式，再应用到生产代码。