
Claude Style Patch 的作用
Claude Style Patch 是一组可直接添加到 CLAUDE.md 的写作指令,旨在减少密集、压缩式的表达,以及近几代 Claude 中反复出现的若干文风习惯。该补丁不仅适用于聊天回复,也适用于生成的文档、交付物、提示词和代码注释。
该项目通过在多个版本的 Opus 和 Fable 中反复使用 Claude Code 与 Claude.ai 逐步完善。它不是笼统地要求 Claude 写得更清楚,而是提供具体规则,指出不需要的习惯,并说明如何改写。
主要功能
- 即插即用的配置:将一个文件追加到全局或项目级
CLAUDE.md。 - 具体的写作规则:每条规则都会说明一种习惯、举例展示,并提供改写策略。
- 覆盖范围广:这些指令适用于日常对话、文档、交付物、代理提示词和代码注释。
- 部署灵活:可用于 Claude Code、Claude Projects 或其他系统提示词。
- 公有领域许可:该补丁采用 CC0 许可,因此可以复制、修改、分叉或提取其中的部分内容,无需署名。
针对的写作习惯
该补丁主要针对 Claude 默认文风中的几种倾向:
- 在真正表达观点之前,先宣布接下来要表达什么。
- 使用冒号,让句子的前半部分给后半部分贴标签。
- 用没有谓语的片段开头。
- 堆叠压缩短语,导致句子难以阅读。
随着对话变得更长或更抽象,这些模式可能会更加明显。该补丁试图在这些情况下保持直接、易读的表达。
全局安装补丁
对于 Claude Code,将远程 STYLE.md 文件追加到全局配置中:
curl -sL https://raw.githubusercontent.com/andrewroxby/claude-style-patch/main/STYLE.md >> ~/.claude/CLAUDE.md>> 运算符会追加下载的指令,而不是替换现有文件。只有在确实要添加补丁时才运行该命令,因为重复运行会再次追加一份副本。
全局安装后,这些文风指令会成为 Claude Code 配置的一部分,并应用于使用全局 CLAUDE.md 的各个项目。
为单个项目安装
如果你想测试该补丁,或只将它应用于特定仓库,可以将它追加到项目自己的 CLAUDE.md:
cd path/to/your/project
curl -sL https://raw.githubusercontent.com/andrewroxby/claude-style-patch/main/STYLE.md >> CLAUDE.md当某个仓库需要特定的行文风格,但你不想改变每次 Claude Code 会话中的 Claude 行为时,项目级安装会很有用。
在 Claude Code 之外使用
该补丁是纯文本指令,因此不依赖特殊插件或运行时。要在 Claude Project 中使用它,请将 STYLE.md 的内容复制到项目的自定义指令中。你也可以将它粘贴到其他环境的系统提示词中。
- 打开仓库中的
STYLE.md文件。 - 复制完整内容。
- 打开你所用环境的自定义指令或系统提示词编辑器。
- 粘贴指令并保存配置。
源文件可从 Claude Style Patch 仓库获取。
基本用法
安装后,像平常一样使用 Claude 即可。你不需要在每次请求中调用命令或提及该补丁。提出你需要的输出,指令会引导 Claude 呈现内容的方式。
示例:生成文档
为新工程师撰写这项服务的技术概览。说明其架构、请求流程、依赖项和运维风险。该补丁旨在通过避免开场式声明、以片段开头的段落,以及过度压缩的句子结构,让生成的文档更易于阅读。
示例:请求添加代码注释
审查这个模块,并在能够说明非显而易见行为的地方添加注释。保持注释简洁,并让它们对未来的维护者有用。由于该文风规范也涵盖代码注释,其规则同样会影响源文件中用于解释的文字。
示例:为另一个代理创建提示词
严格遵循回复风格指令。为另一个将为此应用添加身份验证的代理,撰写一份详细的实现提示词。在 Claude 即将生成较长提示词或大量新文本之前,这种明确提醒尤其有用。
高级技巧
在密集任务前重申规则
遵循程度较好,但并不完美,而且在长对话中可能下降。补丁的开头段落要求 Claude 在内容变得密集时重新检查规则,但这无法消除所有疏漏。
在复杂写作任务之前,添加以下提醒:
严格遵循回复风格指令。项目作者表示,在生成较长文本或为其他代理编写提示词之前,这种措辞尤其有效。
有意识地选择全局或项目范围
如果你始终希望在 Claude Code 中采用该补丁的风格,请使用全局配置。当规则只应应用于一个代码库,或你想在更广泛采用前先评估效果时,请使用项目级 CLAUDE.md。
考虑上下文成本
该样式文件约有1,600个单词。这些说明会占用部分可用上下文,因此在受限环境中工作时,请将这项开销纳入考虑。项目作者表示,无论是在Claude Code还是Claude.ai会话中,这种改进都值得额外占用上下文。
预期模型差异
README指出,与Opus相比,Fable似乎更 consistently 遵循该规范,尤其是在较长的线程中。请将此补丁视为指导而非保证;当对话变得冗长或抽象时,应再次强调这些要求。
自定义补丁
由于该项目以CC0协议发布,你可以复制、派生、删除规则,或重复使用其中的部分章节。这样,你可以只保留符合自己偏好写作风格和上下文预算的指导内容。
结论
Claude Style Patch通过明确、面向修正的说明,为改变Claude的行文方式提供了一种简单方法。你可以将其追加到全局或项目级的CLAUDE.md中,也可以将其粘贴到自定义说明或系统提示词中。对于篇幅较长且要求较高的写作任务,可以要求Claude严格遵循响应风格说明,以强化这一配置。
