Claude Code 提示词越具体，返工越少

今天这个主题很小，却非常容易决定 Claude Code 的工作质量。很多人把 Claude Code 当成一个更聪明的聊天窗口，输入一句「帮我修一下支付问题」，就期待它自动读懂业务、定位文件、复现 bug、写测试、修实现、跑验证。这个期待不算离谱，因为 Claude Code 确实是一个 agentic coding environment，它可以读文件、运行命令、修改代码，并在用户观察、纠偏或暂时离开时继续推进任务。Anthropic 官方文档也明确把这种工作方式描述为，用户描述目标，Claude 负责探索、计划和实现。(Claude)

但真正进入项目之后，我们会发现一句模糊提示词带来的成本很高。Claude Code 能推断意图，却不能读取我们的脑子。官方最佳实践里有一句非常关键的建议，指令越精确，需要的后续纠偏越少。更具体地说，提示词应该引用具体文件，说明约束条件，并指向已有代码模式。(Claude) 这就是「Be specific upfront」真正想强调的东西，不是把提示词写得很长，而是在任务开始的地方，把 Claude Code 最容易猜错的地方提前钉住。

我们把今天这个例子放在真实开发语境里看