输出风格

定义

输出风格（Output Styles）是 Claude Code .claude/output-styles/ 下的文件，其指令被 注入系统提示。因身处系统提示层，它携带所有指令机制中 最高的权威性，从不被 压缩，每个 session 启动时加载，首次请求后缓存（故为中等上下文成本）。

要点

• 会替换默认系统提示：自定义输出风格默认 覆盖 Claude Code 的默认系统提示（除非 frontmatter 设 keep-coding-instructions: true），从而丢掉"我在帮你做软件工程"以及如何界定改动范围、何时加注释、安全顾虑、跑测试再收工等关键默认指令——Claude 会退化为通用助手。
• 最高权威 ⇒ 审慎使用：正因权重最高，应只在真正需要 重大角色切换（编码助手 → 通用助手）时动用。
• 先看内置：动手写之前先看 Proactive（自主）、Explanatory（讲解）、Learning（协作教学）三种内置风格，多数需求已覆盖，无需自维护风格文件。
• 与追加系统提示的关系：--append-system-prompt 是更安全的替代——只做加法、不改角色，避免输出风格"覆盖式"的意外行为。

示例

• 把 Claude Code 从软件工程助手切成通用写作助手（须显式接受丢失编码默认指令的代价）。
• 启用内置 Learning 风格进入协作教学模式，而不必写任何风格文件。

相关概念

• 指令权威性梯度
• Skills系统
• Hooks系统

参考资料

• Anthropic, Steering Claude Code: skills, hooks, rules, subagents and more
• Claude Code Output Styles 文档