写 Prompt 一次过的秘诀

Thu, 22 Jan 2026 14:15:00 +0000

用了一段时间 Claude Code, 你会发现大部分翻车的会话不是模型不行, 是你自己的 prompt 有问题。Claude 能猜你的意图, 但你没法指望它会读心。

把任务范围卡死

“帮我优化一下这段代码”——这种 prompt 出来什么结果全看运气。什么叫优化? 性能、可读性、还是裁掉冗余代码?

好的 prompt 应该说清楚文件、场景和验证方式:

给 src/auth.ts 写一个已登出用户的边缘用例测试, 不要用 mock.

任务范围越小, 结果越可控。模糊的 prompt 只有在一种情况下有用——你真的想让 agent 给意见的时候。“这个文件你有什么改进建议"就很合适, 但记得限定范围, 别让它自己逛到几百个文件里去。

Claude 从真实代码里学规范比从文字描述里学快得多。你不需要跟它解释"我们项目的命名规范是驼峰、接口前缀有 I 开头”——

参考 src/services/user.ts 的写法, 用同样的模式实现这个新接口.

一句话, 比一百字描述都有用。

我 debug 的时候用这个格式, 很少出问题:

症状: 用户登录后跳到 404 页面
位置: src/router/index.ts 第 42-56 行的路由守卫逻辑
修复标准: 登录后跳到 redirect 参数指定的页面, 没有 redirect 就去首页

再加一句 “先写一个能复现的测试再修”, 能防止它改完了但什么都没修。

有时候你做到一半, 突然想确认一个不相关的事——“这个包的 API 签名是什么样的?"。如果用主会话问, 它会污染上下文。用 /btw 这个包的 API 签名是什么 问, 答案会以浮层显示, 不进对话历史, 不占上下文。