Claude Code 系统提示词解读：Reporting outcomes 结果报告准则——让代理只报告已观察到的真实结果

文档提示工程人工智能【免费下载链接】claude-code-system-promptsAll parts of Claude Codes system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts点击查看免费下载本指南围绕 system-prompt-reporting-outcomes.mdccVersion 2.1.251展开逐条拆解 Claude Code 对代理Agent结果报告行为的硬性要求如何区分实际发生的结果与本应发生的意图、何时必须在报告第一句置顶失败信息、以及如何避免夸大未经验证的完成声明。读完本文你将掌握这套结果报告准则的全部条款、底层设计动机、与其配套提示词的协作关系以及在真实任务Web 抓取、代码评审、后台任务中的落地写法。一、这份提示词在仓库中的定位Reporting outcomes结果报告是 Claude Code 系统提示词集合中的一份独立行为准则。该集合由大量面向不同场景的提示词文件构成本文件通过文件头元数据声明了自己的身份name: System Prompt: Reporting outcomesdescription: Requires reports to distinguish observed outcomes from intentions, lead with failures or incomplete work, and avoid overstating unverified completion要求报告区分已观察结果与意图、以失败或不完整工作开头、避免夸大未经验证的完成ccVersion: 2.1.251随每个 Claude Code 版本更新它与同目录下的多份提示词构成一个结果报告行为体系其中关系最密切的三份是system-prompt-action-safety-and-truthful-reporting.md2.1.271负责任地报告结果的姊妹规则明确要求如果测试失败就带着输出说出来如果某一步被跳过就说出来当某事完成且已验证时就直说不要闪烁其词system-prompt-outcome-first-communication-style.md2.1.235沟通风格规则要求以结果开头Lead with the outcome第一句回答发生了什么/你发现了什么system-prompt-executing-actions-with-care.md2.1.200执行前审慎评估可逆性与影响范围的规则。如果把这三份提示词放在一起看executing-actions-with-care管怎么做之前先想清楚action-safety-and-truthful-reporting管做完了怎么如实汇报outcome-first-communication-style管汇报时怎么组织语言而reporting-outcomes则是这套体系里对证据与声明的关系规定得最严格的一份——它回答的是你凭什么说一件事做完了二、核心准则一报告实际发生的而不是你意图发生的提示词开篇第一句就是最核心的约束Report what actually happened, not what you intended. 报告实际发生的事而不是你打算做的事。这看起来简单却直指 LLM 代理最常见的报告缺陷模型在生成文本时很容易把我调用了工具、应该产生了某个效果当作效果确实发生了来陈述。报告必须是本会话中观察到的结果而不是这一步按理说应该产出什么的推断。准则原文对结果给出了三个明确的观察来源工具输出tool output——工具调用返回的内容本身文件当前读取到的内容the file as it now reads——不是写入时以为的内容而是现在重新读取文件看到的内容页面当前加载的状态the page as it now loads——不是请求发出后假设的状态而是页面此刻实际呈现的状态。换言之done、sent、saved、fixed、verified这类完成性动词每一个都必须挂靠在一条可被观察的证据上。这正是 system-prompt-action-safety-and-truthful-reporting.md 中如实报告结果Report outcomes faithfully的延伸if tests fail, say so with the output——带着输出说失败if a step was skipped, say that——说跳过when something is done and verified, state it plainly without hedging——完成且验证过就直说。反例与正例对照反例以意图代替结果正例以观察结果支撑声明修复已提交其实只是执行了 commit 命令没看返回commit 命令返回了哈希 abc1234提交已生效文件已保存调用过写文件工具但没回读重新读取了文件第 42 行已包含新配置测试通过了跑了测试但没看输出测试输出显示 12 passed, 0 failed页面已加载触发了导航没确认状态页面标题已变为 X内容区域渲染出了目标元素三、核心准则二未检查就直说未检查If you did not check, say you did not check. 如果你没有检查就说你没有检查。这条规则堵住了一个隐蔽的滑坡代理确实执行了某个动作但由于省略了验证步骤它转而用预期结果填补报告。准则的态度很明确——没有观察就没有声明权而未检查本身就是一个合法的、必须如实披露的状态。它在 system-prompt-action-safety-and-truthful-reporting.md 中同样有呼应if a step was skipped, say that。结合两文可以归纳出一个实用的分级声明模式已验证有工具输出 / 文件回读 / 页面状态为证 → 直说已确认已执行未验证动作做了但没回读结果 → 说已执行但未验证未执行步骤被跳过或被拒绝 → 说未执行/被跳过。agent-prompt-web-reading-specialist.md 给出了这个分级声明在真实场景中的完整样板If a page does not contain what was asked for, or a fetch failed or was denied, say so plainly — name the URL and the HTTP status or error — rather than guessing, so the caller can fetch a denied URL itself. Do not fill gaps from memory.即页面抓取失败或被拒绝时要直说并点明 URL 和 HTTP 状态码或错误而不是靠记忆补全内容。这正是未检查就直说的工程化实践——把失败信息结构化URL 状态码让调用方可以自行重试。四、核心准则三失败、跳过、异常结果必须置顶于报告第一句这是本提示词最具操作性的条款If any step failed, was skipped, or came back different from what you expected, say so in the first sentence of your report, before anything else, even when the rest of the work succeeded.三个触发条件某一步失败、某一步被跳过、结果与预期不符。只要命中其一就必须在报告第一句、在任何其他内容之前说出来——即使其余部分全部成功。这背后的动机是可见性visibility与可恢复性recoverability失败信息放在报告的中间或末尾很容易被用户略过用户基于不完整的图景做出错误判断而放在第一句则无论后面写了什么用户第一眼就能看见风险。这与 system-prompt-outcome-first-communication-style.md 的第一句回答发生了什么形成了机制上的衔接——第一句不仅要给结论还要优先给坏结论。落地时可以形成这样一个第一句模板本次任务完成但注意git push返回了错误非快速前进被拒绝其余步骤构建、测试均已通过并验证。五、核心准则四绝不悄悄绕过失败Never quietly work around a failure in a way that makes it look resolved; a problem the user can see is recoverable, one your summary hides is not.这条准则道破了整套规则的最终目的可见的问题是可恢复的被隐藏的问题则不可恢复。如果代理遇到失败后通过一个看起来像解决了问题的变通手段悄悄绕过去例如测试失败就跳过该测试、文件写入失败就改用临时文件、推送被拒就改写历史那么用户看到真实失败 → 可以介入、回滚、调整方案 →可恢复总结里隐瞒失败 → 用户以为一切正常问题留在暗处继续发酵 →不可恢复。因此绕过与报告的边界是绕过之后用户是否仍能看到原始问题。看不到就构成隐瞒。这与 system-prompt-executing-actions-with-care.md 中遇到障碍时不要用破坏性动作作为捷径把它抹掉如用--no-verify跳过安全检查是同一设计哲学的两面执行侧不许用变通掩盖风险报告侧不许用措辞掩盖失败。六、核心准则五提前停止时第一行就要说明并点名遗留事项When you stop before the task is complete, your first line says so plainly and names what is left.当代理在任务完成前停止时无论是主动收手、资源受限、还是等待用户输入报告的第一行必须直说任务未完成并点名剩余工作。两个动作缺一不可明确状态第一行即声明任务未完成而不是用已完成大部分工作这类含混表述点名遗留具体列出还剩什么——哪个文件没改、哪条命令没跑、哪个验证没做让用户可以立即接手。这条规则与仓库中 agent-prompt-general-task-agent.md 对代理的总体要求完整地完成任务——不要镀金但也不要留一半互为表里完整完成是理想状态而一旦无法完整完成如实交代缺什么就是最低限度的诚实。七、核心准则六摘要的确定性不得超过证据Do not describe partial work as done, and do not let a summary read as more certain than the evidence behind it.最后一条是对全文的收束包含两个禁令不要把部分工作描述成已完成改了一半的文件、跑了一半的验证、传了一半的数据都不能用完成时态表述不要让摘要读起来比证据更确定摘要使用的确定性程度确认已修复成功必须与证据强度严格匹配。证据只有执行过命令摘要就只能说已执行证据有回读确认摘要才配说已确认。这条准则实际上是前五条的总校验器第一句置顶失败准则三、不隐瞒绕过准则四、未完成即点名准则五最终都是为了保证摘要所呈现的确定性不超过证据所支撑的确定性。八、在仓库中的配套与落地证据除了前述直接关联的提示词仓库中还有多处实现了结果报告精神的具体场景提示词可作为理解本准则如何落地的参考agent-prompt-code-review-minimal-mode.md要求在工具调用后在自己的最终回复里复述 findings每条一行file:line — summary使结论在不渲染工具输出的会话中依然可见——这正是不允许声明悬空于证据之外的工程化处理agent-prompt-background-job-agent-instructions.md后台任务代理必须用自己的话复述结果State results in your own text even if a tool already printed them因为状态提取器看不到工具输出——与声明必须能被观察者核验的准则一脉相承system-prompt-outcome-first-communication-style.md要求Lead with the outcome并以给离开了一会儿的队友看的标准组织报告——与本文件第一句置顶坏消息配合构成完整的报告输出规范。九、实操自查清单将本文件浓缩为一组可执行的自查问题供你在编写代理报告或设计代理提示词时逐条核对证据挂靠我每个 done / sent / saved / fixed / verified 是否都对应一条本会话观察到的结果工具输出、文件回读、页面状态未检查声明我有没有跳过验证却说已验证没有检查的地方是否明确写了未检查坏消息置顶本次是否有失败、跳过或异常结果如果有是否已在第一句、在其他内容之前说明无隐瞒绕过我是否用变通手段让某个失败看起来已解决而用户其实看不到原始问题提前停止声明如果任务未完成第一行是否直说了未完成并点名遗留事项确定性匹配摘要的措辞强度确认/已修复 vs 已执行/待验证是否与证据强度严格一致结语Reporting outcomes全文虽然只有一段却是一条高度自洽、可直接执行的行为准则以观察结果定义证据准则一、二以第一句置顶保证可见性准则三以禁止隐瞒绕过保证可恢复性准则四以未完成即点名保证交接可续准则五以确定性不超证据保证整体可信准则六。它回答的终极问题是一个代理凭什么获得用户的信任——凭它说的每一句做完了都站得住。结合 system-prompt-action-safety-and-truthful-reporting.md、system-prompt-outcome-first-communication-style.md 与 system-prompt-executing-actions-with-care.md 一起阅读可以还原 Claude Code 在执行—汇报全链路上完整的行为约束体系。赞分享文档提示工程人工智能【免费下载链接】claude-code-system-promptsAll parts of Claude Codes system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts点击查看免费下载相关推荐如何快速上手OmTrackVLA 0.6B5分钟完成从安装到首次预测的完整指南如何快速上手OmTrackVLA 0.6B5分钟完成从安装到首次预测的完整指南 OmTrackVLA 0.6B是一款完全开源的视觉 语言 动作VLA模型CANN pyasc 算子编程asc.language.adv.get_special_basic_config 详解——自定义 SpecialBasicBlock 模板配置指南CANN pyasc 算子编程asc.language.adv.get_special_basic_config 详解——自定义 SpecialBasicBl文档提示工程人工智能Simple Form系统测试报告结果分析Simple Form系统测试报告结果分析 测试框架概述 Simple Form项目采用Minitest作为测试框架测试代码位于 test/ https:/后端UI组件上一篇免费开源的 LitCAD 二维 CAD 软件新手如何上手下一篇MouseJiggler让 Windows 不休眠的 5 分钟单文件小工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考