文档教程知识库【免费下载链接】developer-roadmapInteractive roadmaps, guides and other educational content to help developers grow in their careers.项目地址https://gitcode.com/GitHub_Trending/de/developer-roadmap点击查看免费下载导读本文聚焦 developer-roadmap 项目 ai-agents 路线图 中的核心提示工程原则之一——在提示中把需求表达得具体明确。你将从为什么要具体的原理出发掌握目标、格式、限制、受众、排除项、关键数据等维度的完整写法并通过模糊与具体的案例对比学会在单轮对话与 Agent 工作流中写出高精度的提示词从而减少模型猜测、剔除无关输出、显著降低来回追问的成本。一、为什么具体明确是提示工程的第一原则在 what-is-prompt-engineeringY8EqzFx3qxtrSh7bWbbV8.md 中提示工程被定义为编写清晰的提问或指令让 AI 系统给出你想要的答案。而实现这一目标的第一步就是把话说清楚。当你用模糊、宽泛的语言向 AI 提出请求时模型只能基于概率去猜测你的真实意图结果往往是多余的猜测成本模型在多个可能的解释之间摇摆输出覆盖了所有可能性但每一条都不是你真正想要的无关的额外细节模型补全了大量你没有要求的背景、铺垫和延伸内容后续追问的时间损耗第一轮输出不达标你需要反复澄清一轮轮地把需求挤出来。反之清晰、精确的措辞能直接给模型划定回答的边界让它在第一时间命中目标。这一点对 LLM 如此对承载了工具调用、多步推理的 AI Agent 更是如此——Agent 的每一步行动都由提示词驱动需求越模糊Agent 的决策链就越容易偏离方向。二、核心五要素目标、格式、限制、受众、排除项把需求写具体本质上是在提示开头一次性声明以下五类信息要素要回答的问题示例目标Goal这次任务到底要产出什么帮我列出三个建议而不是解释概念格式Format输出长什么样用编号列表用三列表格输出 JSON限制Limits有哪些硬性约束不超过 200 字不要涉及财务建议受众Audience答案给谁看面向非技术背景的产品经理排除项Leave out明确不要什么不要包含代码示例不要列举开源工具关键做法把目标、格式、限制、受众、排除项放在提示的开头。模型对提示早期内容的权重处理更高把最重要的约束前置能确保它不会被后续的补充信息稀释。这一原则与路线图中的另一篇文档 provide-additional-context6I42CoeWX-kkFXTKAY7rw.md 互为表里提供上下文解决的是给足背景信息而**写具体解决的是把要求说精确**。前者保证模型不缺料后者保证模型不跑偏。三、把关键事实钉死数字、日期、来源具体不仅体现在结构上更体现在关键事实的精确化上。凡是可能影响答案正确性的数字、日期和来源都应当直接点名数字数量、金额、比例、时间跨度——最近 30 天前 5 大客户预算 1 万元以内日期截止时间、统计区间——数据截至 2025 年 12 月 31 日对比 2024 与 2025 年的数据来源指定数据出处或口径——以上市公司年报为准以官方文档为准。这些信息一旦缺失模型就只能自行假设而假设一旦错误整个输出都会建立在错误的地基上。点名关键事实就是主动替模型消除最大的不确定性来源。四、模糊 vs 具体一个案例的完整拆解原文档给出了最直观的对比示例我们把它完整展开模糊版本解释一下第二次世界大战。具体版本列出第二次世界大战的三大关键事件每个事件附带日期和一句简短说明。两条提示的差异体现在三个层面范围收窄从解释整场战争一个可以写几十万字的话题收窄为三个关键事件格式指定明确要求列出即条目式输出而非长篇叙述信息密度指定每个事件必须附带日期 一句简短说明限定了每条内容的深度。再看一个贴近开发者的对比模糊版本帮我看看这段代码有什么问题。具体版本以下函数在并发调用时会偶发数据错乱。请用编号列表指出(1) 可能的竞态条件(2) 每处的修复建议(3) 修复后的完整代码。不要修改其他无关逻辑不要讨论代码风格。可见具体 明确任务边界 明确输出形式 明确回答深度 明确禁区。这四条写全模型第一次输出就能达到可用水平。五、从单轮对话到 AI Agent具体性在 Agent 场景中的延伸提示的精确性在 AI Agent 场景中会更加关键。Agent 与普通对话的本质区别在于它会主动执行动作——调用工具、读写文件、发起 API 请求、执行代码参见路线图中的 agent-loopEih4eybuYB3C2So8K0AT3.md。当指令模糊时Agent 可能调用错误的工具需求没说清楚该用搜索还是该用数据库查询Agent 凭猜测选择执行多余的步骤目标未限定Agent 会把无关的候选动作也做一遍以错误的参数发起请求未指定过滤条件、时间范围、输出字段工具返回的数据自然对不上。因此在 Agent 的系统提示词system prompt与任务指令中具体化应当落地为明确工具选择的判定条件当用户提供订单号时直接调用订单查询工具当用户只提供客户名时先调用客户检索工具明确每一步动作的输入输出调用搜索工具时关键词必须使用用户原话且每次只搜索一个关键词明确停止条件拿到库存数据后立即停止调用工具直接汇总结果不要再发起其他查询。这一理念与 tool-definitionqakbxB8xe7Y8gejC5cZnK.md 中工具定义本身就要写清楚参数与行为的要求一脉相承工具定义负责把能做什么写清楚提示词负责把要它做什么写清楚两者共同决定了 Agent 行为的确定性。六、与提示工程其他原则的组合使用写具体不是孤立技巧它与 ai-agents 路线图提示工程板块中的其他原则组合使用效果最佳指定长度与格式specify-length-format-etcwwHHlEoPAx0TLxbtY6nMA.md 详细讲解了120 字以内用编号列表列名与顺序JSON/Markdown等输出约束。把长度和格式写死是具体化在输出维度上的直接落地固定格式还能让下游程序或人工直接解析消费结果。提供附加上下文provide-additional-context6I42CoeWX-kkFXTKAY7rw.md 主张把主题、目的、受众、语气、关键事实一次性给足就像带新人一样给够背景——具体性是怎么说上下文是给什么料。在提示中给示例use-examples-in-your-promptyulzE4ZNLhXOgHhG7BtZQ.md 指出放一两个输入→期望输出的样例模型会直接模仿其模式。示例本质上是最具体的需求表达——与其描述一百遍要表格不如直接放一个两行三列的小表格。使用专业术语use-relevant-technical-termssUwdtOX550tSdceaeFPmF.md 强调用领域内精确词汇代替含糊描述与写具体互为补充术语解决用什么词说具体性解决把要素说全两者都能减少歧义、帮助模型检索到正确的知识。迭代与测试iterate-and-test-your-promptsnoTuUFnHSBzn7GKG9UZEi.md 把第一版提示当作草稿运行、观察、一次只改一个变量加一个示例、限一个长度、调一种语气、再测再记。写具体不是一次到位的天赋而是一轮轮改出来的习惯——每次迭代都朝更具体前进一格直到输出清晰、正确、可复现。七、可复用的具体化提示模板把本文的原则打包成一个可直接套用的模板【任务】一句话说清要产出什么 【背景】给出必要的上下文一句话到三句话 【受众】答案给谁看用什么深度和语气 【格式】列表 / 表格 / JSON / Markdown必要时给出列名与顺序 【长度】字数上限或条数上限 【必须包含】关键数字、日期、来源、字段 【不要包含】禁区清单逐条列明 【示例】可选一个输入→期望输出的小样例填写示例【任务】基于以下销售数据找出营收下滑最严重的一个季度并给出三条可能原因。 【背景】数据为公司 2025 年四个季度的营收单位万元。 【受众】面向销售总监的季度复盘摘要。 【格式】先给结论再用编号列表列原因每条原因不超过两行。 【长度】全文不超过 250 字。 【必须包含】下滑季度、同比下滑百分比、按季度数据。 【不要包含】不要给改进建议不要展开行业分析。这套模板同时适用于普通对话与 Agent 任务在 Agent 场景下把必须包含换成必须调用哪些工具、传入什么参数、何时停止即可。八、延伸阅读以下内容均位于本仓库 ai-agents 路线图的提示工程板块可与本文组合阅读提示工程是什么what-is-prompt-engineering提供附加上下文provide-additional-context指定长度与格式specify-length-format-etc在提示中使用示例use-examples-in-your-prompt使用相关专业术语use-relevant-technical-terms迭代并测试你的提示词iterate-and-test-your-promptsAgent 主循环agent-loop工具定义tool-definition小结把需求写具体是提示工程中投入产出比最高的动作之一先在提示开头声明目标、格式、限制、受众与排除项再把数字、日期、来源等关键事实点名最后用示例和模板把抽象描述变成可执行指令。它削减模型的猜测空间、过滤无关细节、减少追问轮次而在 AI Agent 场景中它直接决定工具选择、参数传递与停止条件是否正确。配合上下文、格式、示例、术语与迭代测试等相邻原则你就可以把一段碰运气的提示打磨成稳定、可复现、可被 Agent 忠实执行的精确指令。赞分享文档教程知识库【免费下载链接】developer-roadmapInteractive roadmaps, guides and other educational content to help developers grow in their careers.项目地址https://gitcode.com/GitHub_Trending/de/developer-roadmap点击查看免费下载相关推荐Stream What You HearSWYH重写版 - Rust实现教程Stream What You HearSWYH重写版 Rust实现教程 项目介绍 SWYH rs 是一个基于 Rust 语言重新编写的“Stream WhPayload 登录时提示 Unauthorized, you must be logged in to make this request 怎么排查Payload 登录时提示 Unauthorized, you must be logged in to make this request 怎么排查 在后端CMSAwesome Claude Code 离线使用完整指南断网也能 5 分钟跑起本地资源库Awesome Claude Code 离线使用完整指南断网也能 5 分钟跑起本地资源库 高铁上没有信号机房做隔离测试公司内网屏蔽外网——网络一断依赖在教程文档上一篇MAA明日方舟自动化助手5分钟跑通一键全日常下一篇PrettyMIDI 实战从读取 .mid 文件到合成音频的三步走创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 AI Agent 提示工程实战：把需求写具体（Be Specific in What You Want）
文档教程知识库【免费下载链接】developer-roadmapInteractive roadmaps, guides and other educational content to help developers grow in their careers.项目地址https://gitcode.com/GitHub_Trending/de/developer-roadmap点击查看免费下载导读本文聚焦 developer-roadmap 项目 ai-agents 路线图 中的核心提示工程原则之一——在提示中把需求表达得具体明确。你将从为什么要具体的原理出发掌握目标、格式、限制、受众、排除项、关键数据等维度的完整写法并通过模糊与具体的案例对比学会在单轮对话与 Agent 工作流中写出高精度的提示词从而减少模型猜测、剔除无关输出、显著降低来回追问的成本。一、为什么具体明确是提示工程的第一原则在 what-is-prompt-engineeringY8EqzFx3qxtrSh7bWbbV8.md 中提示工程被定义为编写清晰的提问或指令让 AI 系统给出你想要的答案。而实现这一目标的第一步就是把话说清楚。当你用模糊、宽泛的语言向 AI 提出请求时模型只能基于概率去猜测你的真实意图结果往往是多余的猜测成本模型在多个可能的解释之间摇摆输出覆盖了所有可能性但每一条都不是你真正想要的无关的额外细节模型补全了大量你没有要求的背景、铺垫和延伸内容后续追问的时间损耗第一轮输出不达标你需要反复澄清一轮轮地把需求挤出来。反之清晰、精确的措辞能直接给模型划定回答的边界让它在第一时间命中目标。这一点对 LLM 如此对承载了工具调用、多步推理的 AI Agent 更是如此——Agent 的每一步行动都由提示词驱动需求越模糊Agent 的决策链就越容易偏离方向。二、核心五要素目标、格式、限制、受众、排除项把需求写具体本质上是在提示开头一次性声明以下五类信息要素要回答的问题示例目标Goal这次任务到底要产出什么帮我列出三个建议而不是解释概念格式Format输出长什么样用编号列表用三列表格输出 JSON限制Limits有哪些硬性约束不超过 200 字不要涉及财务建议受众Audience答案给谁看面向非技术背景的产品经理排除项Leave out明确不要什么不要包含代码示例不要列举开源工具关键做法把目标、格式、限制、受众、排除项放在提示的开头。模型对提示早期内容的权重处理更高把最重要的约束前置能确保它不会被后续的补充信息稀释。这一原则与路线图中的另一篇文档 provide-additional-context6I42CoeWX-kkFXTKAY7rw.md 互为表里提供上下文解决的是给足背景信息而**写具体解决的是把要求说精确**。前者保证模型不缺料后者保证模型不跑偏。三、把关键事实钉死数字、日期、来源具体不仅体现在结构上更体现在关键事实的精确化上。凡是可能影响答案正确性的数字、日期和来源都应当直接点名数字数量、金额、比例、时间跨度——最近 30 天前 5 大客户预算 1 万元以内日期截止时间、统计区间——数据截至 2025 年 12 月 31 日对比 2024 与 2025 年的数据来源指定数据出处或口径——以上市公司年报为准以官方文档为准。这些信息一旦缺失模型就只能自行假设而假设一旦错误整个输出都会建立在错误的地基上。点名关键事实就是主动替模型消除最大的不确定性来源。四、模糊 vs 具体一个案例的完整拆解原文档给出了最直观的对比示例我们把它完整展开模糊版本解释一下第二次世界大战。具体版本列出第二次世界大战的三大关键事件每个事件附带日期和一句简短说明。两条提示的差异体现在三个层面范围收窄从解释整场战争一个可以写几十万字的话题收窄为三个关键事件格式指定明确要求列出即条目式输出而非长篇叙述信息密度指定每个事件必须附带日期 一句简短说明限定了每条内容的深度。再看一个贴近开发者的对比模糊版本帮我看看这段代码有什么问题。具体版本以下函数在并发调用时会偶发数据错乱。请用编号列表指出(1) 可能的竞态条件(2) 每处的修复建议(3) 修复后的完整代码。不要修改其他无关逻辑不要讨论代码风格。可见具体 明确任务边界 明确输出形式 明确回答深度 明确禁区。这四条写全模型第一次输出就能达到可用水平。五、从单轮对话到 AI Agent具体性在 Agent 场景中的延伸提示的精确性在 AI Agent 场景中会更加关键。Agent 与普通对话的本质区别在于它会主动执行动作——调用工具、读写文件、发起 API 请求、执行代码参见路线图中的 agent-loopEih4eybuYB3C2So8K0AT3.md。当指令模糊时Agent 可能调用错误的工具需求没说清楚该用搜索还是该用数据库查询Agent 凭猜测选择执行多余的步骤目标未限定Agent 会把无关的候选动作也做一遍以错误的参数发起请求未指定过滤条件、时间范围、输出字段工具返回的数据自然对不上。因此在 Agent 的系统提示词system prompt与任务指令中具体化应当落地为明确工具选择的判定条件当用户提供订单号时直接调用订单查询工具当用户只提供客户名时先调用客户检索工具明确每一步动作的输入输出调用搜索工具时关键词必须使用用户原话且每次只搜索一个关键词明确停止条件拿到库存数据后立即停止调用工具直接汇总结果不要再发起其他查询。这一理念与 tool-definitionqakbxB8xe7Y8gejC5cZnK.md 中工具定义本身就要写清楚参数与行为的要求一脉相承工具定义负责把能做什么写清楚提示词负责把要它做什么写清楚两者共同决定了 Agent 行为的确定性。六、与提示工程其他原则的组合使用写具体不是孤立技巧它与 ai-agents 路线图提示工程板块中的其他原则组合使用效果最佳指定长度与格式specify-length-format-etcwwHHlEoPAx0TLxbtY6nMA.md 详细讲解了120 字以内用编号列表列名与顺序JSON/Markdown等输出约束。把长度和格式写死是具体化在输出维度上的直接落地固定格式还能让下游程序或人工直接解析消费结果。提供附加上下文provide-additional-context6I42CoeWX-kkFXTKAY7rw.md 主张把主题、目的、受众、语气、关键事实一次性给足就像带新人一样给够背景——具体性是怎么说上下文是给什么料。在提示中给示例use-examples-in-your-promptyulzE4ZNLhXOgHhG7BtZQ.md 指出放一两个输入→期望输出的样例模型会直接模仿其模式。示例本质上是最具体的需求表达——与其描述一百遍要表格不如直接放一个两行三列的小表格。使用专业术语use-relevant-technical-termssUwdtOX550tSdceaeFPmF.md 强调用领域内精确词汇代替含糊描述与写具体互为补充术语解决用什么词说具体性解决把要素说全两者都能减少歧义、帮助模型检索到正确的知识。迭代与测试iterate-and-test-your-promptsnoTuUFnHSBzn7GKG9UZEi.md 把第一版提示当作草稿运行、观察、一次只改一个变量加一个示例、限一个长度、调一种语气、再测再记。写具体不是一次到位的天赋而是一轮轮改出来的习惯——每次迭代都朝更具体前进一格直到输出清晰、正确、可复现。七、可复用的具体化提示模板把本文的原则打包成一个可直接套用的模板【任务】一句话说清要产出什么 【背景】给出必要的上下文一句话到三句话 【受众】答案给谁看用什么深度和语气 【格式】列表 / 表格 / JSON / Markdown必要时给出列名与顺序 【长度】字数上限或条数上限 【必须包含】关键数字、日期、来源、字段 【不要包含】禁区清单逐条列明 【示例】可选一个输入→期望输出的小样例填写示例【任务】基于以下销售数据找出营收下滑最严重的一个季度并给出三条可能原因。 【背景】数据为公司 2025 年四个季度的营收单位万元。 【受众】面向销售总监的季度复盘摘要。 【格式】先给结论再用编号列表列原因每条原因不超过两行。 【长度】全文不超过 250 字。 【必须包含】下滑季度、同比下滑百分比、按季度数据。 【不要包含】不要给改进建议不要展开行业分析。这套模板同时适用于普通对话与 Agent 任务在 Agent 场景下把必须包含换成必须调用哪些工具、传入什么参数、何时停止即可。八、延伸阅读以下内容均位于本仓库 ai-agents 路线图的提示工程板块可与本文组合阅读提示工程是什么what-is-prompt-engineering提供附加上下文provide-additional-context指定长度与格式specify-length-format-etc在提示中使用示例use-examples-in-your-prompt使用相关专业术语use-relevant-technical-terms迭代并测试你的提示词iterate-and-test-your-promptsAgent 主循环agent-loop工具定义tool-definition小结把需求写具体是提示工程中投入产出比最高的动作之一先在提示开头声明目标、格式、限制、受众与排除项再把数字、日期、来源等关键事实点名最后用示例和模板把抽象描述变成可执行指令。它削减模型的猜测空间、过滤无关细节、减少追问轮次而在 AI Agent 场景中它直接决定工具选择、参数传递与停止条件是否正确。配合上下文、格式、示例、术语与迭代测试等相邻原则你就可以把一段碰运气的提示打磨成稳定、可复现、可被 Agent 忠实执行的精确指令。赞分享文档教程知识库【免费下载链接】developer-roadmapInteractive roadmaps, guides and other educational content to help developers grow in their careers.项目地址https://gitcode.com/GitHub_Trending/de/developer-roadmap点击查看免费下载相关推荐Stream What You HearSWYH重写版 - Rust实现教程Stream What You HearSWYH重写版 Rust实现教程 项目介绍 SWYH rs 是一个基于 Rust 语言重新编写的“Stream WhPayload 登录时提示 Unauthorized, you must be logged in to make this request 怎么排查Payload 登录时提示 Unauthorized, you must be logged in to make this request 怎么排查 在后端CMSAwesome Claude Code 离线使用完整指南断网也能 5 分钟跑起本地资源库Awesome Claude Code 离线使用完整指南断网也能 5 分钟跑起本地资源库 高铁上没有信号机房做隔离测试公司内网屏蔽外网——网络一断依赖在教程文档上一篇MAA明日方舟自动化助手5分钟跑通一键全日常下一篇PrettyMIDI 实战从读取 .mid 文件到合成音频的三步走创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考