ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

像导演一样写提示词:从提示词工程师到AI协作高手

像导演一样写提示词:从提示词工程师到AI协作高手 连续三个晚上我都在反复修改给 Claude 的提示词。任务并不复杂把一堆产品日志整理成管理层能直接看的周报。我试过角色扮演、万能模板、锚定关键词、要求它“像资深分析师那样思考”可结果永远像一份面面俱到又毫无重点的资料汇编。问题不在 Claude 本身而在于我当时扮演的角色——一个试图用更多技巧压榨出更好结果的“提示词工程师”。后来我换了一个思路不再把自己当成提示词工程师而是当成导演。我不再琢磨“下一个词怎么写”而是开始问自己“这场戏为什么要拍、核心冲突是什么、观众是谁、剪辑节奏在哪里、哪部分必须保留、哪部分必须舍弃”。同样的任务只改了一次提示词输出质量立刻上了一个台阶。说到底不是反对提示词工程而是建议你换一个更有效的身份模型像导演一样写提示词而不是提示词工程师。1. 为什么“提示词工程师”这个称呼容易把努力带偏1.1 提示词不是咒语而是给协作对象的任务简报很多人第一次接触提示词会本能地认为它像搜索引擎关键词只要组合得足够精准结果就能足够匹配。于是开始研究“魔法词”什么“请一步一步思考”“你是顶级专家”“用 Markdown 输出”……这些技巧不是完全没用但它的隐含假设是模型是一个需要被技巧操控的工具。这个假设有一个问题Claude 不是一个只会执行指令的函数而是一个需要“上下文”才能完成协作任务的智能体。提示词的作用不是“控制”它而是把任务背景、目标、边界、交付标准和验收方式说清楚。这就像你把自己的意图传达给一个能力很强、但对你项目并不熟悉的伙伴。导演在拍片之前做的也不是指挥演员“你念这句台词”而是讲清楚这场戏的人物动机、场景氛围和目标情绪。演员理解了之后才有可能给出超出期待的表演。写提示词也一样你给模型的信息越接近“任务简报”它才越有可能交出“任务结果”而不只是一段“看起来在回答问题”的文本。1.2 提示词工程师常见的三个误区结合我看到的很多案例包括那些把“Claude 使用教程”“提示词设计”当作流量关键词的内容真正能把提示词写好的人仍然很少。最常见的误区有三个。误区一拼命堆细节却没有主次。把需求写成几百字流水账每个细节都要求保留。结果模型无法判断优先级只好把每件事都平均用力。最终输出的内容什么都提到了但什么都像背景噪音。误区二迷信万能模板忽略任务类型。同一个模板既用来写论文、写代码又用来审校合同这几乎不可能同时做好。因为不同类型的任务需要的上下文结构完全不同。写代码需要“输入、输出、边界条件”审校需要“改什么、不改什么、怎么呈现改动”这两者的上下文结构天然不同。误区三不会看输入只盯着输出。很多人反复调整提示词却不知道问题可能出在输入材料本身。你给 Claude 的材料里如果充满噪声、格式混乱、关键信息前后矛盾提示词再花哨也救不回来。导演看到一段粗剪的视频不会只抱怨调色不好他会先判断素材本身有没有拍对。这三个误区的共同原因是把自己当成了“提示词的输出者”而不是“任务结果的第一负责人”。提示词写得不好确实可能是技巧问题但更多时候是你在写之前就没有想清楚这场任务的目标、观众和边界。1.3 从“命令式”到“导演式”的转变命令式提示词的核心是“要求模型做什么”你要写一篇文章要包含要点要语气专业。导演式提示词的核心是“让模型理解为什么做、为谁做、做到什么程度”。这两种方式的结果差异在复杂任务里会特别明显。比如“写一个关于分布式事务的科普”和“给一个刚入行两周的初级后端工程师写一篇分布式事务的科普他需要先理解为什么需要事务再理解分布式的复杂性在引出两阶段提交之前不要蹦出一堆术语”后者的交付质量大概率更高。所以我的主判断是提示词工程不是不重要但它只是工具真正决定结果上限的是你有没有导演视角。你不需要成为“提示词工程师”你需要成为“会表达需求的人”。2. 像导演一样写提示词剧本、镜头、调光2.1 剧本先想清楚主角、观众和交付物导演拿到一个题材不会直接开拍。他要先确认这部电影给谁看希望观众看完记住什么。写提示词前也一样。我建议你在写任何一段复杂提示词之前先用一两句话回答三个问题这次任务的主角是什么是“一段代码”“一篇文章”“一份分析报告”还是“一套方案”最终交付给谁看是客户、管理层、工程师团队、还是自己看完之后对方最应该带走的一个判断是什么很多人会在提示词里写“请生成一份营销方案”但导演会写“请生成一份面向创业团队的冷启动营销方案读者看完能直接决定先做哪三件事”。后者不是在加形容词而是在锁定目标。一个具体案例之前我想让 Claude 帮忙写一份“季度复盘”。如果只写“帮我写季度复盘”它输出的内容基本是“本季度我们做了什么、完成了多少”。但当我改成“这份复盘是给团队内部看的目的是总结出三个值得继续投入的方向而不是给管理层汇报成果”Claude 输出的重点就完全变了。它开始注意筛选信息而不是罗列信息。2.2 镜头把大目标拆成可执行的片段导演不会让摄影师一个镜头拍完整个故事他会拆成多个景别再剪辑。写提示词也一样尤其是复杂任务最怕一次给一个大而全的需求。比如你要 Claude 帮你做一个“产品发布会演讲稿”。如果你只给“写一篇演讲稿”它大概率会给你一篇结构工整但空洞的稿子。如果你用镜头思维拆一下效果完全不同先写开场三分钟目的是让观众意识到旧方案有多痛再写产品发布章节突出一个核心功能带来的变化最后写 QA 模拟预判五个刁钻问题并给出回应。这正好对应我在 Claude Code 这类工具里写提示词的习惯一个大的开发任务不要一次性丢给模型“把整个模块写完”而是拆成“先定义接口再实现一个最小功能然后补测试最后重构”。导演式提示词不是更啰嗦而是更有节奏。拆的时候有一个原则每一步都要有“可验证的结果”。如果某一步完成后你无法判断它是不是正确的那这个拆分就不够清楚。比如“先梳理需求”就不如“先列出所有需要处理的数据字段并标注哪些来自数据库、哪些来自外部接口”更容易被模型理解。2.3 调光给足背景、语气和约束条件“调光”指的是最后一遍打磨确定整场任务的氛围、边界和禁忌。我通常会在提示词的末尾加入三样东西背景信息为什么现在要做这件事它处在哪个阶段语气和表达方式偏书面还是偏口语偏保守还是偏激进硬性约束不要做什么、不要超过多少字、不要使用某些术语。约束不是越多越好。约束太多模型会像戴着镣铐跳舞的演员动作变形。更合理的做法是先放开写一版再把它收敛到需要的样子。我自己写提示词的时候会刻意把“禁止事项”控制在三条以内每一条都是基于过去真实踩过的坑而不是“防止模型乱来”的防御性说教。比如我写内容审校的提示词通常只会说“不要改变原有语气不要新增例子不要做流畅度润色”。这三条已经足够划定边界再多写反而会让模型变得束手束脚。边界应该定在“最不能接受的地方”而不是“所有不希望出现的地方”。2.4 一个可以直接改写的通用提示词结构下面给出一个常见写法不是所谓万能模板而是一种导演式提示词的结构参照角色与目标 你是一个帮助我完成[任务类型]的协作者。这次任务的目标是[具体目标]最终交付物是[类型]。 背景与上下文 [项目或任务所处的阶段已经做过什么为什么现在要处理] 观众/使用者 这个结果最终会被[谁]使用TA 最需要的是[核心信息/能力]。 拆解动作 请按下面顺序处理 1. [第一步先理解/梳理] 2. [第二步再生成/实现核心部分] 3. [第三步最后检查/补边界] 约束与风格 - 语气[正式/口语/工程化] - 长度[比如 3000 字以内] - 不要[最多三条真实禁忌] 验收标准 当[某个条件]出现时请停下来告诉我而不是继续生成。这个结构可以直接用于 Claude、Claude Code 甚至其他大模型产品。它看起来并不复杂但它把导演关心的目标、背景、节奏和边界都放进了同一个流程里。每次使用前你只需要替换方括号中的内容然后删掉当前任务不需要的部分。3. 从单次试词到可持续复用的“导演工作流”3.1 先跑通一个最小可用的提示词再迭代很多人一上来就想写一个“完美提示词”结果花了一个小时在删除和堆砌之间反复横跳。我建议反过来先用 30 个字把任务目标写出来跑通一次然后根据输出倒推需要补充什么。这个思路和写代码是一样的。你不会没跑通 Hello World 就直接上生产环境。先跑通的另一个好处是你会通过输出看到模型对任务的理解。输出什么地方偏了往往就是提示词里什么地方不明确。这是最直接的“导演看样片”的过程。在 Claude Code 这类编程场景里尤其如此。不要一开始就写一个庞大的 CLAUDE.md也不要急着配一堆 Skill。先从一个具体任务开始让模型完成一次最小闭环再逐步把通用规则沉淀到配置文件里。如果你一开始就把所有规则塞进去会很难判断哪条规则在实际任务中真正起了作用。3.2 把高频任务沉淀成提示词片段库导演不会每次拍片都从零开始他会有分镜脚本模板、选角偏好、灯光风格。写提示词也一样如果你发现自己每周都在给 Claude 写“周报总结”“代码 Review”“内容审校”最好的做法是把它们固化成片段而不是每次重新写。具体做法每次跑出满意结果后把提示词存到一个本地目录按任务类型分类记录“为什么这样写有效”不要只存一份文本定期删掉废弃版本保留一两个真正稳定的结构。这比收藏任何“提示词指南”都靠谱因为你沉淀的是自己工作流里的经验而不是别人的通用模板。比如我自己会保留一个“代码 Review 提示词”的片段里面固定包含“先看行为变化、再看边界条件、最后看可读性”这个顺序。每次要用时只需要粘贴新的代码和具体背景就能稳定复用。3.3 在 Claude Code 里管理提示词时容易忽略的几个点这段时间 Claude Code 的讨论热度很高。它把提示词的使用从单纯的聊天框带到了终端、编辑器和工作流里。于是很多人开始关心安装、配置、Skill 使用这些不是不能聊但我更想提醒几个容易被忽略的问题。如果你把提示词写进 CLAUDE.md 这类说明文件要注意它会影响全局任务应该写成“项目背景”和“通用规则”不要把一次性任务的细节塞进去。如果输入 claude 命令时提示“无法识别”不要第一时间怀疑软件坏了。常见原因往往是 PATH 没有配置、Node.js 版本太低、或者在错误的终端环境里执行。先检查环境再重装这个顺序能节省大量时间。在 Claude Code 里使用 Skill 或自定义命令时提示词同样要遵循“先目标、后步骤、再边界”的结构否则模型很容易在工具链里走偏。这里要特别说一句工具可以帮你提效但它不会自动替代你的导演视角。Claude Code 只是给了你一个更大的片场你还是得自己决定这场戏怎么拍。3.4 提示词效果不好时的排查链路当输出不理想不要立刻改提示词。先按下面顺序排查。层次检查内容常见表现输入材料是否有噪声、遗漏、格式混乱、上下文不完整模型在错误前提上继续生成任务目标目标是“做什么”还是“为什么做”不清晰输出结构完整但内容没有重点约束条件约束过多、互相矛盾、不可验证输出要么僵硬要么违反其中一条输出格式是否指定了可验证的交付结构结果虽然是文本但无法直接使用运行环境模型版本、工具版本、上下文长度是否匹配长任务被截断命令无法识别迭代方式是否在换一种思路还是反复试同一个模板连续多次出现同类问题这个排查链路不神秘但它能帮你把“提示词效果差”从一个玄学问题变成可以定位的工程问题。很多时候你以为自己在“优化提示词”其实只是在“反复验证同一个错误假设”。4. 三个真实场景写作、重构、审校4.1 场景一用 Claude 写技术博客而不是“生成文章”写技术博客时很多人会用“帮我写一篇关于 Spring Boot 的文章”然后得到一篇概念堆砌的内容。换成导演思路后我会这样描述“我想写一篇关于 Spring Boot 自动配置的博客读者是一年经验的 Java 后端最近在看 starter 源码但还没有理解条件装配。我希望 TA 读完能说‘原来自动配置不是魔法而是有条件判断的装配流程’。可以先分析困惑点再给一个最小示例最后解释核心注解。”这个提示词并没有要求模型写一篇 5000 字长文但它让模型知道自己面对的读者是谁、困惑在哪、看完之后应该收获什么。输出的文章会更有方向感不是泛泛而谈。同样的逻辑也适用于 AI 编程提示词。你让 Claude 生成一段代码时如果只写“帮我实现一个订单列表接口”它可能给你一个完整但冗余的版本。如果改成“这个接口是给小程序端用的只需要返回 id、名称、金额和状态不需要分页不需要鉴权但需要考虑状态为空的兼容”模型生成的结果就会更接近你真正想要的。4.2 场景二用 Claude 做代码重构先给验收标准代码重构类任务最难写。如果你只说“帮我重构这段代码”模型往往会炫技式地改成一版你根本不敢合并的代码。导演式提示词会提前定义验收标准。比如“这是一个订单服务的 toList 方法目标是把超长 if-else 重构为可测试的策略结构。不能改变外部行为不能引入新的状态变量尽量保持命名风格一致。重构后请用表格说明每个分支对应哪个策略并标注你删除了哪些重复逻辑。”这样做的好处是把“你觉得怎么好”变成了“我知道怎样才算好”。模型可以有发挥空间但不会逾越边界。验收标准不是限制发挥而是给发挥划定方向。4.3 场景三用 Claude 做内容审校先给角色和禁忌内容审校类提示词最容易踩的坑是只写“请帮我审校是否有病句”结果模型给你改得面目全非。更好的做法是先给角色和禁忌。“你是一名有出版经验的审校人员。请检查我传给你的文稿只修复错别字、标点、明显语法错误和逻辑断层。不要改变我原有的语气不要做流畅度润色不要增加新的例子。最终输出修改前后对照并给一条说明原因。”这种提示词等于给模型一个清晰的“镜头边界”它不会越权去当作者。对一个靠审校吃饭的人来说这个边界比什么技巧都重要。导演最怕的不是演员演得不好而是演员自我发挥太多人物最后脱离了剧本。4.4 导演式提示词的适用边界导演式提示词并不适合所有场景。如果是简单查询、快速问答、草稿头脑风暴不需要太多结构直接问效率更高。如果是探索式任务你还不知道目标是什么就不该急着写完整剧本先让 Claude 给你几个方向。如果是高度重复且完全标准化的任务与其每次写提示词不如把它固化成技能、脚本或程序。看到边界反而能更正确地使用这种思路。它不是银弹而是一种值得训练的通用表达能力。提示词写得好不好最终不取决于你掌握了多少技巧而取决于你对任务本身的理解有多深。5. 一套提示词质量检查清单以及三个长期建议5.1 五个问题判断一段提示词是否合格我每次写完提示词都会用一个五问检查清单过一遍。我知道这次任务“为什么做”吗交付物最终会被谁、在哪里、以什么形式使用模型在开始时是否能理解任务背景而不需要猜任务是否被拆成了可验证的阶段而不是一个大而全的请求约束条件是否少于三条并且彼此没有冲突如果五个问题里有任何一个回答不了我不会急着把提示词发给 Claude我会先回去把那个问题想清楚。这个习惯比任何模板都重要。因为它逼着你在写提示词之前先把导演该想的事情想完。5.2 一些可以立刻用起来的表达习惯把“写一篇文章”改成“为一类读者写一篇能改变其认知的文章”。把“分析这段代码”改成“分析这段代码中最可能导致性能问题的三个位置并给出验证顺序”。把“不要出错”改成“在不确定需求时先提问不要直接假设”。把“输出 Markdown”改成“用 Markdown 输出包含目录、代码块和注意点”。这些表达习惯背后不是语言技巧而是导演对“镜头语言”的理解你选择让观众先看到什么后看到什么什么是特写什么是远景。当你开始有意识地控制信息的主次而不是把一堆要求堆在一起Claude 的输出质量会明显提高。5.3 从提示词工程师到提示词导演的三个长期建议第一把提示词能力当成“表达与判断能力”来训练。你越能说清楚目标、读者和边界提示词质量自然越高。这不是技巧问题而是思维方式问题。第二以作品为评估标准而不是以提示词长度为标准。一段二十字但让 Claude 输出惊艳结果的提示词比一段几百字却毫无重点的提示词更有价值。写提示词不是写作文不要因为“写得长”就觉得努力。第三建立自己的案例库。每次写完一段高质量的提示词记下当时的目标、输入、约束和输出。长期积累后你会有自己的“导演手记”而不是依赖别人的攻略和收藏夹。前几天我又一次打开 Claude准备处理一份已经积压很久的需求文档。这次我没有急着找模板而是先问了自己三个问题这份文档最终给谁看希望他看到之后做什么哪些细节是必须留下的。想清楚之后我只花一分钟写了一段并不长的提示词Claude 输出了我最近很满意的一版内容。从提示词工程师到提示词导演这个转变看似只是称呼的变化背后是整个工作方式的改变从“用更多技巧去控制工具”到“用更清晰的目标去驱动协作”。如果你也发现自己在反复调提示词却收效甚微可以先停下来别急着继续加细节。先把镜头架好再说服演员。
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进