★ FEATURED ARTICLE 文档提示工程人工智能【免费下载链接】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点击查看免费下载本篇技术指南围绕 Claude Code 系统提示词中的 Outcome-first communication style结果优先沟通风格展开它是 Claude Code 主系统提示词中约束 Agent 与用户交互方式的核心片段之一。文章将逐条拆解该提示词的通信规范——从文本输出即用户所见的底层前提、结果优先的回复结构到可读性优先、响应格式匹配任务复杂度、代码注释边界——并结合仓库中其他通信类提示词Communication style、Writing for the user、Responsive mode 等做纵向印证。读完你可以完整理解 Claude Code 如何约束 Agent 的每一条用户可见消息并可直接将这套规范迁移到自己的 Agent 提示词设计中。一、提示词在 Claude Code 体系中的定位根据 README.md 的说明Claude Code 并非只有单一的系统提示词字符串而是由 500 个条件性注入的片段组成包括随环境与配置动态加入的大段内容、27 个内置工具描述、Explore/Plan 等内置 Agent 的独立提示词以及大量 AI 驱动的实用功能提示词。Outcome-first communication style 就属于**主系统提示词System Prompt**的一部分仓库中在System Prompt分类下与它并列的还有 Communication style、Writing for the user、Responsive mode 等。该文件头部元信息front matter精确概括了它的职责让 Claude 对用户可见的更新保持可读且结果优先在工作完成后直接给出答案让响应格式匹配任务复杂度将代码注释限制在非显而易见的约束上。从仓库记录的版本演进看ccVersion: 2.1.235它是随 Claude Code 各版本持续更新的提示词片段同目录下的 CHANGELOG.md 记录了系统提示词跨版本的变化轨迹。二、底层前提你的文本输出就是用户看到的全部该提示词的第一句就奠定了整个通信规范的基石它本身是一个条件注入片段由变量IS_TEXT_OUTPUT_VISIBLE_TO_USER决定两种表述当文本输出对用户可见时交互式终端Your text output is what the user reads; they usually cant see your thinking or the raw tool results.当文本输出不可见时如部分后台/聚焦模式Your text output is what the user reads between tool calls; they usually cant see your thinking or the raw tool results.无论哪种情况结论一致用户通常看不到你的思考过程也看不到原始工具结果唯一稳定可见的就是你输出的文字。因此提示词要求把每条文本当作写给一位离开了一会儿、现在回来接手的队友——这位队友不知道你中途发明的代号和缩写也没有旁观你整个过程的展开。在此基础上该提示词提出了两条工作节奏要求第一次工具调用之前用一句话说明你接下来要做什么工作过程中在发现关键信息或改变方向时给出简短的进展更新。这与姊妹提示词 Communication style 中的表述完全同构——Before your first tool call, state in one sentence what youre about to do. While working, give short updates at key moments: when you find something, when you change direction, or when you hit a blocker. Brief is good — silent is not. One sentence per update is almost always enough.——可见简短更新优于沉默是 Claude Code 通信提示词族一以贯之的原则。条件分支最终文本消息是交付契约当IS_TEXT_OUTPUT_VISIBLE_TO_USER为假时该提示词还会注入一段关键约束Text you write between tool calls may not be shown to the user. Everything the user needs from this turn, including answers, summaries, findings, conclusions, and deliverables, must be in the final text message of your turn, with no tool calls after it. Keep text between tool calls to brief status notes. If something important appeared only mid-turn or in your thinking, restate it in that final message.这段逻辑与 Writing for the user 的前提互相印证The user may not see your tool calls, tool results, or the text you write between them. Only your final message reliably reaches them, so it has to stand on its own.其工程含义是答案、摘要、结论、交付物必须全部收敛到回合的最终文本消息中且该消息之后不允许再跟任何工具调用中途或思考中出现的任何重要内容都必须在最终消息里复述。这为 Agent 的回合结束策略设定了明确的时序契约。三、结果优先Outcome-first第一句就是 TLDR该提示词的核心指令只有一句话但分量最重Lead with the outcome. Your first sentence after finishing should answer what happened or what did you find: the thing the user would ask for if they said just give me the TLDR. Supporting detail and reasoning come after, for readers who want them.即完成工作后的第一句话必须回答发生了什么或发现了什么——也就是用户说直接给我 TLDR时想要的那个答案。支持性细节和推理放在其后供需要深究的读者阅读。这一原则在 Claude Code 提示词体系中反复出现构成一条强一致性的规范Concise output style 的第一条规则就是 Lead with the result— Your first sentence answers what happened or whats the answer. No preamble (Let me..., Now Ill...) and no closing recap of what you already said.Writing for the user 同样要求 Lead with the answer or outcome. If something could not be verified, say so first.Reporting outcomes 进一步收紧了真实性边界如果任何步骤失败、被跳过或结果与预期不符必须在报告的第一句就说明即使其余工作全部成功未经验证的完成不得被描述为已完成。因此结果优先并不仅是排版偏好而是一套完整的通信纪律先给结论再给理由先报失败与未完成项再报成功项。四、可读性优先于简洁性该提示词用一段专门辨析了一个常见误区Being readable and being concise are different things, and readable matters more. If the user has to reread your summary or ask you to explain, any time saved by brevity is gone.可读与简洁是两回事且可读性更重要。如果用户需要重读你的总结或再追问一次那么省下的时间就全部白费了。提示词明确指出了保持简短的正确方法通过选择性地包含来保持简短——剔除那些不会改变读者下一步行动的信息而不是通过压缩文字——不要使用碎片化短语、缩写、A → B → fails这样的箭头链也不要堆砌术语黑话凡是写出来的内容都要用完整句子表达并拼写出技术术语不要让读者去对照你此前发明的标签或编号就地在原处说清意思。注意这里的反面清单非常有实操价值A → B → fails箭头链、自造的缩写、前后文交叉引用的编号标签都是典型损害可读性的写法。Writing for the user 给出了更细的句法级约束可作为这条原则的可执行补充——No em-dashes, no parentheticals, no arrows以及One idea per sentence, about 20 words, with a verb。五、匹配任务的响应格式结果优先并不等于一律短平快。该提示词强调响应格式必须与问题匹配Match the response to the question: a simple question gets a direct answer in prose, not headers and sections. Use tables only for short enumerable facts, with explanations in the surrounding prose rather than the cells. Calibrate to the user: a bit tighter for an expert, more explanatory for someone newer.具体规则拆解如下场景要求的响应方式简单问题直接用散文给出答案不要堆标题和分节表格使用只用于简短、可枚举的事实解释放在表格周围的散文里而不是塞进单元格用户校准对专家更紧凑对新手更详尽这一条与 Communication style 的 Match responses to the task: a simple question gets a direct answer, not headers and sections 遥相呼应也与 Responsive mode 中headers and bullet lists for an answer that fits in two sentences属于反面教材的判断一致。格式是服务于信息结构的工具而非装饰只有真实承载结构时标题、表格、列表才应该出现Concise output style 也持同一立场Use headers, tables, and bullet lists only when they carry real structure, never as decoration。六、代码注释只写代码本身表达不了的约束该提示词最后一段把通信规范延伸到了代码层面Write code that reads like the surrounding code: match its comment density, naming, and idiom. Only write a code comment to state a constraint the code itself cant show, never to say where it came from, what the next line does, or why your change is correct; thats you talking to the reviewer, not the next reader, and its noise the moment the change merges.核心规则让代码读起来像周围的代码——匹配注释密度、命名风格与惯用法只为一个目的写注释陈述代码本身无法展示的约束例如一个必须保持的顺序、一个非显而易见的性能前提明确禁止三类注释来源出处、下一行做了什么、为什么你的改动是正确的——这些是写给评审者看的而不是写给下一位读者看的一旦改动合并就成了噪音。这套注释哲学在仓库中并非孤例。Comment what and task context avoidance 禁止写解释代码功能的注释和引用临时任务上下文的注释Comment why-only guidance 要求只有当原因是非显而易见且对将来读者有用时才写注释Communication style 则默认不写注释并禁止多段 docstring 与多行注释块。可见 Claude Code 的注释规范是从通信视角出发的注释也是一种面向未来读者的通信理应遵循同样的可读性与信息选择性原则。七、与相关提示词的协作关系Outcome-first communication style 不是孤立片段它与同一目录下的多个系统提示词共同构成 Claude Code 的用户通信子体系。下表整理了它们的分工与侧重点提示词文件侧重点Outcome-first communication style结果优先 可读性 格式匹配 注释边界Communication style工具调用期间的简短更新、回合结束一句话总结、代码不写注释Writing for the user最终消息的句法、格式、术语、代码与数字的呈现规则Responsive mode立即先回复、口语化纯英语、去除客套与填充语Concise output style用户主动选择简洁模式时的结果优先与去旁白Reporting outcomes区分观察到的结果与意图、先报失败、不夸大未验证的完成从版本号看这些片段由不同版本迭代而来例如 Communication style 为2.1.104Outcome-first 为2.1.235Concise output style 为2.1.237Responsive mode 为2.1.280说明 Claude Code 是持续打磨这套通信约束的——结果优先与可读性优先的原则在多代提示词中保持一致且不断细化。八、可落地的检查清单综合上述规范无论你是 Claude Code 用户还是正在设计自己的 Agent 提示词都可以把以下清单作为用户可见通信的自检标准首句即结论第一句话回答发生了什么/发现了什么失败与未完成项更要放在最前终局交付答案、摘要、结论、交付物全部收敛在最终文本消息中其后不再调用工具动笔前预告第一次工具调用前用一句话说明要做的事过程中只在发现关键信息或转向时给出单句更新可读性优先用完整句子写拼写技术术语不发明代号、缩写、箭头链或需要交叉索引的编号按需裁剪而非压缩剔除不影响读者下一步行动的信息而不是把文字压成碎片格式匹配任务简单问题用散文直接回答表格只放简短可枚举的事实按用户水平调节详略注释只说约束代码注释只写代码本身表达不了的约束绝不写来源、行内解释或改动理由。将这套规范与仓库中的其他通信提示词对照阅读可以完整还原 Claude Code 对 Agent 用户交互的全部约束——它本质上是一套面向暂时离开的队友写作的通信伦理信息完整、结论先行、行文可读、格式克制。输出文章 输出文章Claude Code 结果优先沟通风格解读 Outcome-First 系统提示词与用户通信规范本篇技术指南围绕 Claude Code 系统提示词中的 Outcome-first communication style结果优先沟通风格展开它是 Claude Code 主系统提示词中约束 Agent 与用户交互方式的核心片段之一。文章将逐条拆解该提示词的通信规范——从文本输出即用户所见的底层前提、结果优先的回复结构到可读性优先、响应格式匹配任务复杂度、代码注释边界——并结合仓库中其他通信类提示词Communication style、Writing for the user、Responsive mode 等做纵向印证。读完你可以完整理解 Claude Code 如何约束 Agent 的每一条用户可见消息并可直接将这套规范迁移到自己的 Agent 提示词设计中。一、提示词在 Claude Code 体系中的定位根据 README.md 的说明Claude Code 并非只有单一的系统提示词字符串而是由 500 个条件性注入的片段组成包括随环境与配置动态加入的大段内容、27 个内置工具描述、Explore/Plan 等内置 Agent 的独立提示词以及大量 AI 驱动的实用功能提示词。Outcome-first communication style 就属于**主系统提示词System Prompt**的一部分仓库中在System Prompt分类下与它并列的还有 Communication style、Writing for the user、Responsive mode 等。该文件头部元信息front matter精确概括了它的职责让 Claude 对用户可见的更新保持可读且结果优先在工作完成后直接给出答案让响应格式匹配任务复杂度将代码注释限制在非显而易见的约束上。从仓库记录的版本演进看ccVersion: 2.1.235它是随 Claude Code 各版本持续更新的提示词片段同目录下的 CHANGELOG.md 记录了系统提示词跨版本的变化轨迹。二、底层前提你的文本输出就是用户看到的全部该提示词的第一句就奠定了整个通信规范的基石它本身是一个条件注入片段由变量IS_TEXT_OUTPUT_VISIBLE_TO_USER决定两种表述当文本输出对用户可见时交互式终端Your text output is what the user reads; they usually cant see your thinking or the raw tool results.当文本输出不可见时如部分后台/聚焦模式Your text output is what the user reads between tool calls; they usually cant see your thinking or the raw tool results.无论哪种情况结论一致用户通常看不到你的思考过程也看不到原始工具结果唯一稳定可见的就是你输出的文字。因此提示词要求把每条文本当作写给一位离开了一会儿、现在回来接手的队友——这位队友不知道你中途发明的代号和缩写也没有旁观你整个过程的展开。在此基础上该提示词提出了两条工作节奏要求第一次工具调用之前用一句话说明你接下来要做什么工作过程中在发现关键信息或改变方向时给出简短的进展更新。这与姊妹提示词 Communication style 中的表述完全同构——Before your first tool call, state in one sentence what youre about to do. While working, give short updates at key moments: when you find something, when you change direction, or when you hit a blocker. Brief is good — silent is not. One sentence per update is almost always enough.——可见简短更新优于沉默是 Claude Code 通信提示词族一以贯之的原则。条件分支最终文本消息是交付契约当IS_TEXT_OUTPUT_VISIBLE_TO_USER为假时该提示词还会注入一段关键约束Text you write between tool calls may not be shown to the user. Everything the user needs from this turn, including answers, summaries, findings, conclusions, and deliverables, must be in the final text message of your turn, with no tool calls after it. Keep text between tool calls to brief status notes. If something important appeared only mid-turn or in your thinking, restate it in that final message.这段逻辑与 Writing for the user 的前提互相印证The user may not see your tool calls, tool results, or the text you write between them. Only your final message reliably reaches them, so it has to stand on its own.其工程含义是答案、摘要、结论、交付物必须全部收敛到回合的最终文本消息中且该消息之后不允许再跟任何工具调用中途或思考中出现的任何重要内容都必须在最终消息里复述。这为 Agent 的回合结束策略设定了明确的时序契约。三、结果优先Outcome-first第一句就是 TLDR该提示词的核心指令只有一句话但分量最重Lead with the outcome. Your first sentence after finishing should answer what happened or what did you find: the thing the user would ask for if they said just give me the TLDR. Supporting detail and reasoning come after, for readers who want them.即完成工作后的第一句话必须回答发生了什么或发现了什么——也就是用户说直接给我 TLDR时想要的那个答案。支持性细节和推理放在其后供需要深究的读者阅读。这一原则在 Claude Code 提示词体系中反复出现构成一条强一致性的规范Concise output style 的第一条规则就是 Lead with the result— Your first sentence answers what happened or whats the answer. No preamble (Let me..., Now Ill...) and no closing recap of what you already said.Writing for the user 同样要求 Lead with the answer or outcome. If something could not be verified, say so first.Reporting outcomes 进一步收紧了真实性边界如果任何步骤失败、被跳过或结果与预期不符必须在报告的第一句就说明即使其余工作全部成功未经验证的完成不得被描述为已完成。因此结果优先并不仅是排版偏好而是一套完整的通信纪律先给结论再给理由先报失败与未完成项再报成功项。四、可读性优先于简洁性该提示词用一段专门辨析了一个常见误区Being readable and being concise are different things, and readable matters more. If the user has to reread your summary or ask you to explain, any time saved by brevity is gone.可读与简洁是两回事且可读性更重要。如果用户需要重读你的总结或再追问一次那么省下的时间就全部白费了。提示词明确指出了保持简短的正确方法通过选择性地包含来保持简短——剔除那些不会改变读者下一步行动的信息而不是通过压缩文字——不要使用碎片化短语、缩写、A → B → fails这样的箭头链也不要堆砌术语黑话凡是写出来的内容都要用完整句子表达并拼写出技术术语不要让读者去对照你此前发明的标签或编号就地在原处说清意思。注意这里的反面清单非常有实操价值A → B → fails箭头链、自造的缩写、前后文交叉引用的编号标签都是典型损害可读性的写法。Writing for the user 给出了更细的句法级约束可作为这条原则的可执行补充——No em-dashes, no parentheticals, no arrows以及One idea per sentence, about 20 words, with a verb。五、匹配任务的响应格式结果优先并不等于一律短平快。该提示词强调响应格式必须与问题匹配Match the response to the question: a simple question gets a direct answer in prose, not headers and sections. Use tables only for short enumerable facts, with explanations in the surrounding prose rather than the cells. Calibrate to the user: a bit tighter for an expert, more explanatory for someone newer.具体规则拆解如下场景要求的响应方式简单问题直接用散文给出答案不要堆标题和分节表格使用只用于简短、可枚举的事实解释放在表格周围的散文里而不是塞进单元格用户校准对专家更紧凑对新手更详尽这一条与 Communication style 的 Match responses to the task: a simple question gets a direct answer, not headers and sections 遥相呼应也与 Responsive mode 中headers and bullet lists for an answer that fits in two sentences属于反面教材的判断一致。格式是服务于信息结构的工具而非装饰只有真实承载结构时标题、表格、列表才应该出现Concise output style 也持同一立场Use headers, tables, and bullet lists only when they carry real structure, never as decoration。六、代码注释只写代码本身表达不了的约束该提示词最后一段把通信规范延伸到了代码层面Write code that reads like the surrounding code: match its comment density, naming, and idiom. Only write a code comment to state a constraint the code itself cant show, never to say where it came from, what the next line does, or why your change is correct; thats you talking to the reviewer, not the next reader, and its noise the moment the change merges.核心规则让代码读起来像周围的代码——匹配注释密度、命名风格与惯用法只为一个目的写注释陈述代码本身无法展示的约束例如一个必须保持的顺序、一个非显而易见的性能前提明确禁止三类注释来源出处、下一行做了什么、为什么你的改动是正确的——这些是写给评审者看的而不是写给下一位读者看的一旦改动合并就成了噪音。这套注释哲学在仓库中并非孤例。Comment what and task context avoidance 禁止写解释代码功能的注释和引用临时任务上下文的注释Comment why-only guidance 要求只有当原因是非显而易见且对将来读者有用时才写注释Communication style 则默认不写注释并禁止多段 docstring 与多行注释块。可见 Claude Code 的注释规范是从通信视角出发的注释也是一种面向未来读者的通信理应遵循同样的可读性与信息选择性原则。七、与相关提示词的协作关系Outcome-first communication style 不是孤立片段它与同一目录下的多个系统提示词共同构成 Claude Code 的用户通信子体系。下表整理了它们的分工与侧重点提示词文件侧重点Outcome-first communication style结果优先 可读性 格式匹配 注释边界Communication style工具调用期间的简短更新、回合结束一句话总结、代码不写注释Writing for the user最终消息的句法、格式、术语、代码与数字的呈现规则Responsive mode立即先回复、口语化纯英语、去除客套与填充语Concise output style用户主动选择简洁模式时的结果优先与去旁白Reporting outcomes区分观察到的结果与意图、先报失败、不夸大未验证的完成从版本号看这些片段由不同版本迭代而来例如 Communication style 为2.1.104Outcome-first 为2.1.235Concise output style 为2.1.237Responsive mode 为2.1.280说明 Claude Code 是持续打磨这套通信约束的——结果优先与可读性优先的原则在多代提示词中保持一致且不断细化。八、可落地的检查清单综合上述规范无论你是 Claude Code 用户还是正在设计自己的 Agent 提示词都可以把以下清单作为用户可见通信的自检标准首句即结论第一句话回答发生了什么/发现了什么失败与未完成项更要放在最前终局交付答案、摘要、结论、交付物全部收敛在最终文本消息中其后不再调用工具动笔前预告第一次工具调用前用一句话说明要做的事过程中只在发现关键信息或转向时给出单句更新可读性优先用完整句子写拼写技术术语不发明代号、缩写、箭头链或需要交叉索引的编号按需裁剪而非压缩剔除不影响读者下一步行动的信息而不是把文字压成碎片格式匹配任务简单问题用散文直接回答表格只放简短可枚举的事实按用户水平调节详略注释只说约束代码注释只写代码本身表达不了的约束绝不写来源、行内解释或改动理由。将这套规范与仓库中的其他通信提示词对照阅读可以完整还原 Claude Code 对 Agent 用户交互的全部约束——它本质上是一套面向暂时离开的队友写作的通信伦理信息完整、结论先行、行文可读、格式克制。赞分享文档提示工程人工智能【免费下载链接】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点击查看免费下载相关推荐Claude Code 沟通风格系统提示解析面向用户的输出纪律、更新节奏与代码注释原则Claude Code 沟通风格系统提示解析面向用户的输出纪律、更新节奏与代码注释原则 导读 本文以 system prompt communication文档提示工程人工智能claude-code-system-prompts 仓库导读Claude Code 系统提示词的提取、结构与使用指南claude code system prompts 仓库导读Claude Code 系统提示词的提取、结构与使用指南 本指南围绕仓库根目录下的 CLAUDE文档提示工程人工智能Claude Code Responsive Mode 系统提示解析实时终端下的即时确认与去Claude 腔通信规范Claude Code Responsive Mode 系统提示解析实时终端下的即时确认与去Claude 腔通信规范 Responsive Mode 是文档提示工程人工智能上一篇YARA Time 模块实战指南用 time.now() 在规则中编写时间条件下一篇Steak的局限性分析何时应该考虑其他测试方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
