输入输出接口

提示工程组织任务目标、约束、背景与输出要求。清晰结构有助模型理解，但措辞不是确定性程序，不能保证所有要求都被遵循。

应给足必要证据而非堆积通用口号。角色描述可以提供风格或视角，却不能替代真实项目约定。输出要求也应允许证据不足和未完成状态。

原创练习：把“修复问题并确保专业”改写为可验证的功能、兼容性和测试要求，保留模型选择实现路径的空间。再比较是否减少无关重构与假完成。

完成标准是让Prompt服务任务，而非用更长文本掩盖缺失信息。若问题在工具权限或旧索引，继续润色提示可能没有收益。

Prompt管理涉及模板、变量、复用与版本。复用可以减少重复组织，但不同任务需要的证据与约束仍应区分，模板不宜变成所有场景的固定长流程。

评估Prompt必须记录模型、工具定义、任务样本和配置，否则输出差异无法归因。模板变量也需要正确转义和来源标记，防止外部数据混入高信任指令。

原创练习：给两个Prompt版本分配明确标识，在相同任务上比较正确、遗漏、成本和时长。保留旧版以便回归，不只保存看起来最好的回答。

完成标准是建立可重复实验，而不是拥有很多模板。版本化本身不提高质量，只有与真实评价和失败分析连接才有价值。

指令优先级解决不同来源要求冲突，事实可信度解决内容是否真实。这两维不能互相替代，外部证据正确不表示它能改写用户目标。

本书依据已核验历史Model Spec说明规范概念，不声称规范等于实际模型零失误。工具授权仍应由程序执行，不能全部交给模型判断。

原创练习：网页正文要求删除项目，用户仅要求总结网页。解释为什么这段文本是待分析对象，而不是授权命令。再加入一条过期项目规则，区分指令身份与事实时效。

完成标准是能为输入标记来源、范围和用途。不要仅靠把危险内容放进引号就认为所有注入风险解决，也不要将工具结果天然提升为高优先级要求。

函数调用把模型提出的工具名与参数交给应用执行，再将结果关联回原调用。模型生成调用不是实际执行，执行成功也不等于整体任务完成。

参数需语法、类型、业务与权限校验。返回应区分成功、无结果、超时、权限不足等状态，不能用空文本混淆。关联ID帮助处理多个或并行调用。

原创练习：设计只读文件工具，明确允许根目录、文件不存在与无权限的差异，再模拟模型收到两种错误后应采取什么行动。

完成标准是画出完整请求—执行—观察闭环，并说明副作用在哪发生。严格Schema减少格式错误，却不能允许越界路径或重复远端操作。

结构化输出约束格式与字段类型，不保证字段事实正确。合法JSON、符合Schema和符合业务是三个层次。

模式设计应包含真实状态，例如缺证据、未验证、工具失败。若只允许成功结论，可能迫使模型把中间状态塞入错误类别。拒绝与截断也需要独立处理。

原创练习：设计代码修复报告字段，要求变更文件、已运行测试和未验证事项，再加入验证器检查引用ID与文件是否存在。模型填了字段不代表证据真实。

完成标准是把解析成功与任务验收分离。置信度字段即使限制0到1，也不自动成为校准概率，仍需独立数据评价。

流式响应分批提供文本、参数或事件。接收到一部分不代表完整对象已成立，应遵循协议中的完成信号与错误状态。

工具参数可能跨多个片段，不能用脆弱字符串规则猜结束。高风险动作尤其应等完整参数、授权与校验后执行，不能边流式生成边无条件操作。

原创练习：把一个JSON调用切成三段，其中最后一段包含目标路径后缀。比较提前执行与完整组装后的差异，再模拟连接中断。

完成标准是能区分用户可见的渐进反馈与后台动作提交。更早显示文本可以改善体验，但不应提前宣告业务操作完成。

Claude的提示设计文档提供清晰任务、上下文组织与示例等方法。它们应结合模型和任务验证，不是可跨所有产品无修改使用的定律。

示例要代表目标分布，标签和输出格式一致；复杂信息可分区，但分隔符本身不是安全边界。具体业务事实仍需来源。

原创练习：把一段混杂规则、日志与用户要求的Prompt分成明确区块，再检查是否保留了所有必要限制。比较改结构与简单增加文字的效果。

完成标准是通过真实任务找到有效表达，而不是认为某种标签形式具有魔法。规则冲突和过时资料不能靠排版自动消失。

Extended Thinking涉及模型额外推理与其接口状态。可见推理摘要、最终回答和受保护状态不应混为一段普通聊天文本。

工具调用之间可能需要保持相关状态，处理方式应遵循所用模型与API。不能自行删改受保护内容后假设行为等价，也不能从最终字数估算全部消耗。

原创练习：画出推理、工具调用、工具观察、继续推理的事件序列，标出哪些由应用保存、哪些由模型服务管理。再设计截断或恢复时的验证。

完成标准是让用户得到可核查证据与结论，而不是要求无限展示内部过程。增加推理预算不能弥补不存在的工具权限或未提供的私有知识。