拾光札记

写好 Prompt:与 AI 协作的实用技巧

让 AI 少犯错、少返工的具体方法:怎么把需求说清楚、怎么管上下文,配好例子和坏例子对比。

用 Claude Code、Codex 或任何 AI 助手,效果好不好,一大半取决于你怎么跟它说话。同样一个需求,说法不同,结果天差地别。

这篇不讲玄乎的「咒语」,只讲能立刻上手、真正管用的写法,每条都配坏例子 / 好例子对比,你照着调整自己的说法即可。

一、核心一句话:把 AI 当成聪明但不了解背景的新同事

它很能干,但它不知道你脑子里的默认前提。你觉得「理所当然」的东西,必须说出来。你说得越具体,它猜得越少,返工越少。下面所有技巧,本质都是这一条的展开。

二、说清楚「做什么」,更要说清楚「做到什么程度」

模糊的形容词是返工之源。「好看点」「优化一下」「专业一点」——这些词每个人理解都不一样,AI 只能靠猜。

坏例子:

帮我把这个页面优化一下。

好例子:

帮我优化这个页面的加载速度。具体做三件事:把图片改成懒加载、把没用到的 CSS 删掉、给首屏图片加上宽高避免布局跳动。改完告诉我每一项做了什么。

把「优化」拆成能验收的具体动作,AI 就没得跑偏。凡是形容词,尽量换成可检查的动作。

三、给足上下文:背景、约束、目标

一个好需求通常包含三块:背景(现在是什么情况)、约束(有什么不能碰的规则)、目标(要达到什么效果)。

坏例子:

写个函数验证手机号。

好例子:

我在做一个注册表单(背景)。用 JavaScript 写一个函数,验证输入是不是合法的中国大陆手机号(11 位、以 1 开头)(目标)。不要用第三方库,用正则实现就行(约束)。验证不通过时返回具体的错误提示文字(目标)。

信息给全了,它一次就能给到你要的东西,不用来回补充。

四、一次只让它做一件事

想一口气让 AI 做十件事,往往十件都做得半吊子,而且出问题时你根本分不清是哪件搞坏的。

坏例子:

帮我把登录、注册、找回密码、个人中心、还有整体配色全都做了。

好例子:

我们先只做登录页面。就一个用户名输入框、一个密码输入框、一个登录按钮,先把布局和基础校验做好。其它页面等这个确认没问题了再说。

小步走、每步验证,是和 AI 协作最省心的节奏,尤其是在写代码时。

五、明确「不要做什么」

告诉 AI 边界,和告诉它任务同样重要。尤其是改代码时,加一句「别动别的」能大幅减少它顺手改坏其它地方。

好例子:

只修改这个登录按钮的颜色,改成蓝色。不要改按钮大小、不要动其它按钮、不要重构这个文件的其它代码。

六、给例子,比讲道理管用

与其费劲描述你想要什么格式,不如直接给一个样例,让它照着来。

坏例子:

帮我把这些数据整理成规范的格式。

好例子:

帮我把下面这些数据整理成这种格式,每行一条: 姓名 | 部门 | 入职年份 例如:张三 | 技术部 | 2021 下面是原始数据:……

给了模板和一个例子,输出格式基本不会错。

七、让它先说方案,你确认了再动手

对于比较大的改动,别让它闷头就改。先让它讲思路,你把关,再执行。这样能在它动手前就拦掉错误方向,省下大量返工。

好例子:

我想给网站加一个评论功能。先别写代码,先说说你打算怎么实现、需要改哪些文件、有没有更简单的做法,等我确认后再动手。

八、报错和反馈要具体

当结果不对,最没用的反馈是「不对」「还是不行」。把现象原原本本描述出来,它才能定位。

坏例子:

报错了,修一下。

好例子:

点击提交按钮后页面没反应,浏览器控制台报错:Uncaught TypeError: form.submit is not a function。我期望点击后能弹出「提交成功」提示。请找出原因并修复。

排错反馈的三要素:报错原文、你做了什么操作、你期望的正确表现。

九、管好上下文:长对话要「重置」和「聚焦」

AI 的注意力是有限的。一个对话聊得太久、话题跳来跳去,它会开始「忘事」或者被前面无关的内容带偏。

实用做法:

  • 一个新任务,尽量开一个新对话,别在一个满是旧内容的对话里继续。
  • 话题跑偏、它开始犯迷糊时,用一句话把当前目标重新讲一遍,帮它拉回焦点:「我们现在只专注一件事:修好这个删除按钮,其它先不管。」
  • 需要它参考某个文件时,明确点出文件名,别让它猜是哪个。

在 Claude Code / Codex 这类工具里,如果一个任务彻底做完了、要开始不相关的新任务,直接开新会话比在旧会话里硬接更干净。

十、迭代,别指望一次到位

不要期待第一次回答就完美。把它当成一起改稿的过程:先拿到一版,再基于它一点点调。

方向对了,但按钮太小了,放大一点;另外提示文字改成「保存成功」。其它保持不变。

每次反馈都具体指出改哪里、保持哪里不变,几轮下来就能收敛到你要的效果。

一页速查表

原则一句话记忆
具体把形容词换成可检查的动作
上下文交代背景、约束、目标
聚焦一次只做一件事
边界说清楚「不要做什么」
示例给样例比讲道理管用
先方案大改动先让它讲思路再动手
具体反馈报错贴原文 + 说清操作和期望
管上下文新任务开新对话,跑偏了拉回焦点
迭代不求一次到位,一版版调

结合实战

这些技巧配合 用 Claude Code / Codex 从零搭一个项目 一起看效果最好——那篇是「怎么搭」,这篇是「怎么说」,两篇合起来就是一套完整的 AI 协作方法。

本页目录