先让 Claude Code 核查,避免重复开发
作者原计划将 WordPress 插件的付费功能下放免费版,却在要求 Claude Code 先调查并停止后,发现该功能早已免费提供。交接文档要求核查现有实现、选项、排除列表和预设行为,将实施安排在人工审阅之后。
AI 深度解读
让 Claude Code 开工前,先报告现有实现并停下来,结果发现:准备从 Pro 下放到免费版的功能,早在 1.10.38 就已经免费了。真正需要改的,是免费版的自动预设。
这次任务能及时转向,靠的是交接文档里的一次明确停顿。它让能够读取代码的 Agent 检查了需求前提,也让作者重新审视自己的性能测试。这个案例对日常 AI 编程的启发是:实现步骤写得再细,也可能建立在一个错误判断上。
功能早就有了,为什么测试还会得出错误结论
作者维护一款 WordPress 缓存插件,分为免费版和 Pro 版。其中有个被作者称为「max delay」的设置,会把 jQuery 和内联脚本推迟到访客第一次交互时再执行。
在作者维护的网站上,开启它之后,PageSpeed Insights 移动端分数提高了不少。因此,作者决定把这个功能从 Pro 下放到免费版,并先与 Claude 讨论,再写交接文档让 Claude Code 实现。
问题出在比较条件上。
作者此前比较的是「只安装免费版」和「安装 Pro 并开启 max delay」。Claude Code 读过代码后发现,max delay 自 1.10.38 起就已属于免费功能。免费版分数较低,是因为它的 Auto 按钮没有开启普通 delay 或 max delay;手动开启后,免费版也能提供同样的行为。
测试观察到了性能差异,却没有证明差异来自版本权限。
原文没有给出具体分数、测试次数或完整环境,不能据此判断收益有多大。但报告足以推翻原任务:无需迁移功能,应该调整免费版 Auto 预设,而且只对作者已经测试过的主题启用 max delay。
怎样让开工前的报告真正检查到代码
交接文档第 4 节的标题是「先报告这些内容,到这里停止」。作者还在文档顶部的状态行写明:先完成 §4 的现状报告并停止,等作者审阅后再开始实现。
这比笼统要求「先分析一下」更明确。报告与实现之间,有一个必须等待审阅的边界。
第 4 节要求 Claude Code 回答五组问题:
- max delay 当前如何实现,涉及哪个类和选项名,与免费版普通 delay 有什么区别?
- Pro 是否有默认排除列表,具体包含什么?
- 现有预设如何处理免费版 delay 和 Pro 的 max delay?
- 免费版与 Pro 同时启用时,如何避免重复应用延迟?
- 两个版本分别需要修改哪些文件,大约新增多少条翻译字符串?
这些问题仍然带着「功能需要迁移」的假设,却要求 Agent 阅读现有代码才能回答。第一组问题就把错误前提暴露了出来。
原文没有公布具体类名、选项名、文件路径和翻译字符串数量,因此这里能借鉴的是提问方法,不能照搬成插件改造方案。
作者担心,如果直接把「将 max delay 移到免费版」交给 Claude Code,可能会做出重复实现:两个选项名、难以辨认的生效状态,以及额外的双版本兼容检查。这个后果并未实际发生,是作者对潜在返工的判断。
我的判断
我认同把「现状报告并停止」放在交接文档最顶部。它给需求提出者和执行者安排了不同职责:前者说明目标,后者用代码检查目标所依赖的事实。作者和 Claude 一起写文档,也没有自动消除错误假设。
但这仍是一个案例。作者没有给出与直接实现、普通计划模式或人工代码审查的对照数据,不能证明这套流程普遍更快。
相比一份只列修改步骤的计划,现状报告的价值在于提供证据:功能在哪里、配置如何生效、版本之间是什么关系。如果报告只是复述需求,依然可能把原来的误解写得更完整。
作者认为,不必直接问「这件事是否必要」,追问当前实现就能发现问题。我更倾向于同时保留这个问题:现有能力能否满足目标,为什么还需要修改?这个案例中,读取代码恰好足以纠错;其他任务可能还要核对部署配置或实际操作条件。
报告回来后,需求提出者也要重新检查自己的证据。
这次改变方向,不只是因为 Agent 找到了代码,还因为作者重新读了自己的测量结果,承认比较条件没有对齐。
能拿来做什么
- 给 Claude Code 写涉及功能迁移、权限调整或配置变更的任务时,在文档顶部明确要求「先报告现状并停止,审阅后再实现」,并列出必须从仓库中查证的问题。
- 在前端性能优化中比较两个版本或方案时,先核对功能开关与预设是否一致。发现分数差距后,检查差异来自功能缺失,还是来自默认配置。
- 维护免费版与付费版共存的项目时,要求报告说明功能归属、配置入口和重复执行的处理方式,再据此确定需要修改的范围。
- 如果代码证据推翻了需求前提,就重写交接文档。本例最终任务是为已测试主题调整 Auto 预设,原来的功能迁移计划应当取消。