Claude Code Output Style（输出风格）机制解析：从开场身份注入到内置风格定义

文档提示工程人工智能【免费下载链接】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 的系统提示词并非单一字符串而是由数百个按环境与配置条件注入的片段构成。其中Output Style输出风格是当用户配置了风格化输出时决定 Agent 如何回答用户查询的核心机制。本文以本仓库中提取自 Claude Code v2.1.251 的原始提示词文件为主线系统讲解 Output Style 的开场身份声明、条件注入决策逻辑、内置 Concise 风格的具体行为准则、每轮提醒机制及其在 CHANGELOG 中的演进脉络帮助你理解 Claude Code 是如何把用户偏好翻译成模型行为约束的。一、Output Style 是什么一行开场身份声明在配置了输出风格Output Style的会话中Claude Code 会注入一段极简的开场提示词用于确立 Agent 的身份与行为基准。其完整内容位于 system-prompts/system-prompt-interactive-agent-intro-output-style-active.mdYou are an interactive agent that helps users according to your Output Style, which describes how you should respond to user queries.翻译过来即你是一个交互式 Agent根据你的输出风格来帮助用户该风格描述了你应该如何响应用户查询。这一行的语义要点有三身份声明Agent 被定义为interactive agent交互式 Agent与后台任务、只读搜索等专用 Agent 形态区分行为基准Agent 的响应方式不是自发的而是依据一个名为 Output Style 的配置来执行作用范围风格约束的是how you should respond——即响应的形式、详略与节奏而非任务本身的内容。该文件的 HTML 注释frontmatter同时给出了元数据name为 System Prompt: Interactive agent intro (output-style active)description指明它适用于已配置 Output Style 的会话ccVersion为 2.1.251。根据仓库 README.md 的统计这段提示词约占40 tokens是整个系统提示词中体量最小、但语义关键的开场行之一。二、三套开场变体Output Style 的条件注入逻辑开场身份行并非只有这一个版本。仓库中同时存在三个相互配合的变体共同构成一段条件注入决策。理解它们才能明白 active 变体在什么时机、什么条件下被选中。2.1 conditional 变体真正的决策中枢真正执行选择逻辑的是 system-prompts/system-prompt-interactive-agent-intro-output-style-conditional.md约 231 tokensccVersion 2.1.268。其 frontmatter 声明了五个注入变量变量语义OUTPUT_STYLE_CONFIG当前会话的输出风格配置对象为null表示未配置OUTPUT_STYLE_AGENT_INTRO已配置输出风格时的开场行即上文 active 变体的内容USE_COLLABORATIVE_AGENT_INTRO_FN是否使用协作目标身份的函数开关COLLABORATIVE_AGENT_INTRO协作目标模式下的开场文案SECURITY_POLICY_INSTRUCTIONS安全策略注入片段核心逻辑是一段嵌套三元表达式${OUTPUT_STYLE_CONFIG!null?OUTPUT_STYLE_AGENT_INTRO:USE_COLLABORATIVE_AGENT_INTRO_FN()?COLLABORATIVE_AGENT_INTRO:You are an interactive agent that helps users with software engineering tasks.} Use the instructions below and the tools available to you to assist the user.其决策顺序可还原为第一优先Output Style。若OUTPUT_STYLE_CONFIG ! null会话配置了输出风格注入OUTPUT_STYLE_AGENT_INTRO——即本文主角 active 变体的那一行第二优先协作目标模式。未配置输出风格时若USE_COLLABORATIVE_AGENT_INTRO_FN()为真则注入协作目标开场文案兜底软件工程身份。否则使用硬编码的默认行 You are an interactive agent that helps users with software engineering tasks.。紧随其后固定拼接两段内容指令引用Use the instructions below and the tools available to you to assist the user.以及${SECURITY_POLICY_INSTRUCTIONS}安全策略注入并附带一条明确约束除非确信 URL 是用于帮助用户编程否则绝不生成或猜测 URL只允许使用用户消息或本地文件中提供的 URL。从源码结构可以推断OUTPUT_STYLE_CONFIG是本次注入决策的开关总闸而 active 变体正是它被打开时选中的分支文本——这就是为什么 active 文件本身不包含任何条件逻辑因为它只是被条件表达式引用的纯文本常量。2.2 short 变体无风格时的最小开场system-prompts/system-prompt-interactive-agent-intro-short.md约 27 tokens则是最精简的兜底行You are an interactive agent that helps users with software engineering tasks.它与 conditional 变体中的默认分支文案一致表明软件工程任务助手是未做任何特殊配置时的标准身份。三、内置 Output Style 实例Concise 风格的六条行为准则Output Style 并不仅仅是存在一个配置它必须有可执行的具体内容。仓库中保存了一个内置风格的完整定义——Concise简洁输出风格位于 system-prompts/system-prompt-concise-output-style.md约 373 tokensccVersion 2.1.237。它直接以用户选择了简洁而非叙述开篇并给出六条硬性准则结果先行Lead with the result第一句话直接回答发生了什么/答案是什么禁止 Let me...、Now Ill... 之类的前摇也不做结尾复述砍掉叙述、保留实质Cut narration, keep substance不复述用户请求、计划或已执行的每个步骤只报告结果、决策和用户必须采取行动的事项默认简短Short by default简单问题用 1–3 句纯文本回答标题、表格、列表只在真正承载结构时使用绝不当作装饰直白陈述State things plainly跳过推诿式套话只有当注意事项会改变用户下一步行动时才提及按需提供完整细节Give full detail on request当用户明确要求解释或细节时必须完整作答——简洁绝不意味着扣下请求的信息绝不为简洁牺牲正确性Never trade correctness for brevity错误报告、失败的测试输出、安全警告、破坏性操作的确认信息必须保留完整内容。文件最后还明确了一条优先级规则当这些规则与系统中其他更一般的沟通/格式指导冲突时本风格规则优先Where these rules conflict with more general communication or formatting guidance elsewhere in your instructions, these rules win.。这一实例揭示了两点机制事实其一Output Style 本质是一段覆盖型指令通过末条冲突时本规则优先的声明获得对通用指令的覆盖权其二风格约束的是表达形态与信息取舍而正确性底线不可让渡——这与 active 变体根据 Output Style 响应查询的身份声明形成了完整的闭环。四、每轮提醒机制System Reminder 的风格激活通知Output Style 并非只在开场注入一次。仓库中的 system-prompts/system-reminder-output-style-active.md约 102 tokensccVersion 2.1.238展示了它在会话中的持续存在方式。该 Reminder 声明了两个注入变量ESCAPE_UNTRUSTED_TEXT_FN对不可信文本做转义的函数与OUTPUT_STYLE_CONFIG其模板为${ESCAPE_UNTRUSTED_TEXT_FN(OUTPUT_STYLE_CONFIG.style)} output style is active. ${OUTPUT_STYLE_CONFIG.turnReminder??Remember to follow the specific guidelines for this style.}可还原为风格名 output style is active. 每轮提醒文本机制要点OUTPUT_STYLE_CONFIG.style风格名称经转义函数处理后嵌入句首向模型通报当前激活的风格turnReminder可选的每轮提醒字段。若风格配置提供了该字段则使用自定义文本例如某风格想强调的专属要点若为空??空值合并则回退到默认文案 Remember to follow the specific guidelines for this style.记得遵循该风格的特定指南。结合 CHANGELOG.md 第 2114 行的记录Output style active — Lets an output style supply its own per-turn reminder text, falling back to the default follow the specific guidelines wording可以确认每轮提醒文本是风格配置可自定义的字段这使输出风格不仅约束开场身份还能在每一轮持续强化其行为准则。五、演进脉络CHANGELOG 中的版本足迹从仓库 CHANGELOG.md 可以还原 Output Style 机制近期的演进轨迹新增 Concise 风格第 855 行NEW: System Prompt: Concise output style——定义内置 Concise 风格要求结果先行、省略叙述与重复复述、默认简短、按需完整、保留错误报告/失败测试输出/安全警告/破坏性确认的完整内容。这说明 Output Style 体系内置了开箱即用的风格而非仅有自定义能力开场行拆分第 641 行Interactive agent intro 被拆分为仅在风格确实位于开场行下方时才声明 style below的变体即本主题 active/conditional 变体分化的由来移除误导性措辞第 457 行REMOVED: Interactive agent intro (output-style below)——移除了风格在下方这一可能失真的表述风格指导本身保留协作身份分支第 822 行未激活输出风格时新增 collaborative-goals 身份分支与既有软件工程身份并存即 conditional 变体中USE_COLLABORATIVE_AGENT_INTRO_FN的来源可自定义每轮提醒第 2114 行Output style active Reminder 支持风格自定义turnReminder文本。从这一脉络可以推断Output Style 机制正朝着更精确的条件注入 更强的自定义能力方向演化——开场行只说真实存在的内容风格可携带自己的每轮提醒未配置时则回退到协作或软件工程默认身份。六、在仓库中继续深入若希望进一步研究这套机制可按以下路径在仓库中继续追踪开场身份三变体active 变体、conditional 变体、short 变体内置风格实例Concise 输出风格每轮提醒Output style active Reminder整体索引与 token 统计README.mdSystem Prompt 一节收录了上述文件的说明与 token 数如 active 变体约 40 tks、conditional 变体约 231 tks、short 变体约 27 tks、Concise 风格约 373 tks、Reminder 约 102 tks演进历史CHANGELOG.md 中搜索 output style 相关条目。需要说明的是仓库中的提示词文件是从 Claude Code 编译产物中提取的一手材料见 README.md 的 Extraction 一节token 数会因会话内插值如内置工具名、子 Agent 列表等略有浮动但 ±20 tokens 以内具体输出风格的完整自定义配置方式属于 Claude Code 产品级功能应以你所安装的 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点击查看免费下载相关推荐Claude Code Explanatory Output Style 插件解析用 SessionStart Hook 复刻解释型输出风格Claude Code Explanatory Output Style 插件解析用 SessionStart Hook 复刻解释型输出风格 本篇技术指南AI 应用AI 技能/插件开发工具为 Claude 首席参谋 Agent 定制 executive 输出风格从 output-style 模板到 Agent SDK 的参数化落地为 Claude 首席参谋 Agent 定制 executive 输出风格从 output style 模板到 Agent SDK 的参数化落地 导读 本文以示例工程Gentle-AI Gentleman Persona 全解析Claude Code 中资深架构师导师人格的规则、输出风格与注入机制Gentle AI Gentleman Persona 全解析Claude Code 中资深架构师导师人格的规则、输出风格与注入机制 本文围绕 Gentl上一篇如何用RyzenAdj榨干AMD处理器性能新手必学的终极调校指南下一篇如何用Pulovers Macro Creator轻松实现Windows自动化新手必备的脚本录制神器创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考