Skip to content

27-output-styles-and-response-shaping.md

Latest commit

 

History

History
84 lines (55 loc) · 3.09 KB

27-output-styles-and-response-shaping.md

File metadata and controls

84 lines (55 loc) · 3.09 KB

27. Output Styles 与 Response Shaping

所属专题簇：控制、扩展与灰度治理

建议前读：17. 系统提示词与模型决策

建议后读：12. CLI 操作手册

研究问题

Claude Code 的 output style 只是显示主题，还是会真的影响模型输出行为？

一句话结论

output style 在 Claude Code 里更接近“输出约束 prompt”，而不是单纯 UI 皮肤；它把风格、格式和 keep-coding 指令一起变成了可加载配置。

这篇讲什么

这一章解释 .claude/output-styles、frontmatter 和 style prompt 如何进入 Claude Code 的输出层。

如果你不看源码，只看这一章，应该记住什么

  • output style 是文本行为控制，不是颜色主题。
  • style 可以来自项目目录和用户目录。
  • 这体现了 Claude Code 把“如何回答”也做成正式配置面。

源码依据

Mermaid 图：output style 装配图

flowchart TD
    A["用户目录 output-styles"] --> C["loadOutputStylesDir"]
    B["项目目录 .claude/output-styles"] --> C
    C --> D["frontmatter 解析"]
    D --> E["name / description / prompt / keepCodingInstructions"]
    E --> F["输出行为约束"]
Loading

output style 是 markdown 配置，而不是硬编码枚举

src/outputStyles/loadOutputStylesDir.ts 明确说明：

  • 会从项目和用户目录加载 markdown 文件
  • 文件名会变成 style name
  • 文件内容会变成 style prompt
  • frontmatter 提供 name 和 description

这说明 Claude Code 把输出风格设计成了开放配置面。

keep-coding-instructions 很关键

同一文件还会解析 keep-coding-instructions。这很值得注意，因为它说明 style 不只是“让回答更简洁”这种表层约束，还可能影响模型是否保留面向编码场景的默认工作指令。

这已经不是纯显示问题，而是 prompt 行为 shaping。

为什么这对研究 Anthropic 有意义

Claude Code 在这里体现出一个重要思路：

  • prompt 不只有 system prompt 一种来源
  • 输出侧也可以通过独立配置层影响行为

这使得系统可以同时拥有：

  • 稳定的默认工作法
  • 可切换的输出风格
  • 插件或项目局部定制

你真正应该记住的点

  • output style 属于“如何回答”的配置层。
  • 它是 prompt / 行为层的一部分，不是纯视觉层。
  • 研究 Claude Code 的输出差异时，不能只看主 prompt，也要看 output style。

延伸阅读