跳到正文
docai.cc

DOCAI · 课程 · L2 · 20 分钟 · 进阶技巧

Claude Code 需求表达:清晰描述让 AI 精准理解

需求缺的不是字数,而是上下文。用对象、目的、场合、标准、语气五个格子把话说全,补一份「不要什么」的清单,发出去前过一遍六项自检。

Claude Code 小白 · 如何清晰表达需求

你将学会

  • 能用五个要素把模糊需求补成可执行的描述
  • 会用负面清单和参照样本约束输出
  • 能在发送前用六项自检找出缺口

它不会替你补上没说出口的部分

同一句「写段公司介绍」,放在官网、招商材料和名片背面,需要的是三种文字。模型看不到你的使用场合,只能按最常见的样子猜。猜偏了,你就觉得它没听懂。

问题通常不在它,而在需求缺了上下文。它没有你们行业的常识,也不知道你老板的口味,能依据的只有你打出来的那几行字。

五个要素,一次说全

要素 你要回答的问题
对象 写什么,给谁看
目的 看完之后,对方要做什么
场合 用在哪,篇幅多大
标准 必须有什么,绝不能有什么
语气 正式还是轻松,简洁还是详尽

五个格子填完再发,命中率会明显不同。填不出来的格子,往往就是你自己还没想清楚的地方——先把它想明白,比反复让模型试更快。

拿「给团队写一封调整周会时间的通知」试一遍:对象是全组同事,目的是改时间并让大家确认,场合是内部邮件、不超过两百字,标准是写清新旧时间与生效日期,语气直接但不生硬。五格填完,这封通知基本就成型了。

「标准」这一格最容易糊弄。把「写得好」翻译成可检查的条件:不许出现哪些词、必须给出几个数字、结论放在开头还是结尾。能检查,才能验收。

三段改写对照

模糊版:「帮我写个产品文案。」

清晰版:

给一款防水蓝牙耳机写一段介绍,一百字左右。读者是跑步和健身的人,重点讲出汗不怕、戴着稳。语气有活力,收尾给一个明确动作。不要用「品质卓越」这类空词。

模糊版:「分析一下这份销售数据。」

清晰版:

这是一月华南区的销售明细。我只关心三件事:环比为何只涨了三个点、各区差异是否显著、二月能做什么。先给结论再给依据,总长不超过五百字。数据:[粘贴]

模糊版:「把这篇文章改改。」

清晰版:

保留原文结构和全部数字,只改两处:长句拆短,重复的表述删掉。读者是不了解这行的普通读者,改完控制在六百到七百字,另附两句话说明你动了哪里。

三组对照的共同点是:对象、范围、禁区和验收标准全写出来了。模型不用猜,你也不用反复纠正。

注意清晰版都不长。把要求写全不等于写长,删掉寒暄和重复,剩下的每句都在限定一件事。

说你「不要什么」,不会写就让它先问

负面清单往往比正面描述省事:不要空泛形容词,不要感叹号收尾,不要超过三条要点,不要口语到失去分寸。把它不想要的样子点名,比让它猜边界可靠。

再给一个参照样本。贴一段你喜欢的文字,说「照这个语感写」,比十个形容词都准。样本可以短,两三句就够,关键是它体现了你想要的那个分寸。

有时你自己也没想清楚。与其硬凑,不如先让它提问:「我想做一份季度总结,但还没想好该给你哪些材料。先别写,列出你需要我补充的信息,最多五个问题。」它问完、你答完,再动笔,多一轮问答能少三轮返工。

一次只交办一件事

「帮我写封邮件,顺便分析这份数据,再把附件翻译一下」——三个任务挤在一段话里,模型会把注意力平均分配,结果每样都做得潦草,你还得分开返工。正确做法是拆成三次请求,每次给全五要素,验收通过再进下一件。确实需要连着做时,明确主次和顺序:「先完成邮件,我确认后再处理数据,数据部分先不要动」。

说不清时,先要几个方向

自己也没把握想要什么风格时,不要硬凑形容词,让对方先给选项:

给这款保温饭盒写三版产品介绍,各 100 字左右:
A 版偏理性,讲容量和保温时长;
B 版偏生活场景,讲带饭上班的体验;
C 版偏简短有力,适合详情页首屏。
每版标注适合放在哪里。先不要解释思路。

拿到三版后,用「在 B 版基础上改」这种方式收敛,比重新描述一遍快得多。选中之后再把修改意见写成可检查的条目:哪句删、哪句换、字数上限多少。

三种返工症状与处理

症状:输出空泛,全是正确但没用的话。 多半缺的是对象和目的——它不知道读者是谁、看完要做什么。补上这两格,通常立刻见效。

症状:字数总是超标。 「简洁一点」不是标准,写成「不超过 200 字,超过就删例子,保留结论」才有约束力。

症状:改完仍不是想要的。 因为你只说了「不好」。换成定位式反馈:「第 2 段太口语,改成书面表达;第 4 段的数字保留;其余不动」。让它按位置改,比让它整体重写可控。更多正反例对照见好提示词与坏提示词。

发出前的六项自检

  • 是什么类型的产出,说了吗?
  • 读者是谁,说了吗?
  • 用在哪、多长,说了吗?
  • 必须包含什么,说了吗?
  • 语气和禁区,说了吗?
  • 怎样算合格,说了吗?

六项齐了再按发送键。缺的那一项,往往就是返工的原因。

自测

  1. 你最近一次不满意的输出,缺的是五要素里的哪一个?
  2. 你有没有给过「不要什么」的清单?
  3. 哪个任务适合先让它提问?

需求说清楚之后,可以把常用场景写成现成模板:职场提示词模板。提示词的基本结构见什么是提示词。

自测

先自己回答,再展开对照;答不上来就回到对应小节。
  1. 01五个要素分别是什么?看答案

    对象、目的、场合、标准、语气——写什么给谁看、看完要做什么、用在哪、必须有什么、用什么口吻。

  2. 02为什么「不要什么」的清单常常比正面要求更有效?看答案

    它直接排除你不接受的样子,减少模型在边界上的猜测;配合一个参照样本,效果更稳。

查看 Markdown

涉及的概念

在知识树上