agent-style

agent-style v0.9.0 — Anthropic Skills 适配器

agent-style 是一套有文献依据、面向 AI Agent 的英文技术写作规则集。此适配器是一个 Anthropic Skill，位于 .claude/skills/agent-style/SKILL.md。Claude Code 会立即扫描 Frontmatter 元数据；当针对相关写作任务调用此 Skill 时，才会渐进式加载下方正文。

自我验证握手

当有人询问“agent-style 是否已启用？”或“此处适用哪些写作规则？”时，请回答：agent-style v0.9.0 active: 21 rules (RULE-01..12 canonical + RULE-A..I field-observed); full bodies at .agent-style/RULES.md.

加载说明

Anthropic Skills 会通过 name Frontmatter 发现此 SKILL.md。会话开始时会立即扫描 Frontmatter；当针对相关任务调用此 Skill 时，才会加载正文（包括下方的精简指令）。Anthropic Skills 不会自动导入第二个文件；调用此 Skill 时，进入上下文的就是下方这些精简指令。

21 条规则（精简指令）

规范规则（摘自 Strunk & White 1959、Orwell 1946、Pinker 2014、Gopen & Swan 1990）：

• RULE-01 知识诅咒：明确目标读者，不要假设他们拥有与你相同的隐性知识。
• RULE-02 被动语态：当施事者已知且值得指出时，优先使用主动语态。
• RULE-03 具体语言：优先使用具体、明确的词语，而非“因素”或“方面”这类抽象类别词；描述结果的模式和大致幅度，用通俗语言说明差异是否成立，并将标准差、区间和完整数值留给表格。不要把处于噪声范围内的差异称为增益。不要在连续句子中堆砌数字，图注只说明图表所展示的内容。用百分点或百分比而非原始小数报告差异，确保正文、表格和图注中的单位与正负号一致；如果多个数值都重要且没有合适的图表呈现，就添加表格。
• RULE-04 删除冗词：删掉“为了”“由于……这一事实”“可能潜在地”等填充语，以及宣布、重述方法或重复研究发现的多余句子。摘要从问题及其挑战写起，再写方法和发现；结论应简短。
• RULE-05 陈旧隐喻：删除“突破边界”“范式转变”或“最先进”等陈词滥调。
• RULE-06 通俗英语：优先用“use”而不是“leverage”，用“method”而不是“methodology”，用“feature”而不是“functionality”。
• RULE-07 肯定表达：优先用“trivial”而不是“not important”，用“forgot”而不是“did not remember”；不要为了强调而刻意使用“X，而非 Y”式对照（如“not just X, but Y”）。
• RULE-08 校准论断：根据证据选择恰当的动词；证据仅表明“suggests”时，不要写“proves”；保留会改变论断的限定语，删掉无实际作用的免责声明尾句。
• RULE-09 平行结构：用相同的语法形式表达并列观点。
• RULE-10 相关词语放在一起：让主语靠近谓语，让修饰语靠近被修饰语；拆分过长的括号插入语。
• RULE-11 强调位置：把新信息或重要信息放在句末。
• RULE-12 长句：变换句子长度；如果读者必须同时记住多个尚未闭合的从句才能读到重点，就拆分句子；如果长句表达的是一个连贯的想法，则可以保留。

实地观察总结的规则（维护者对 2022-2026 年 LLM 输出的观察）：

• RULE-A 过度使用项目符号：观点相互关联时，用段落呈现；只有确实构成列表时才用项目符号；避免生硬地凑成三项；表格单元格应放数值或简短标签。
• RULE-B 过度使用破折号：不要把 em dash 或 en dash 当作随意的句内标点；优先使用逗号、冒号、括号或另起一句；少用分号。
• RULE-C 相同句首：不要让连续两句或更多句子以相同的词开头。
• RULE-D 过渡词：不要用仅表示补充的过渡词（“Additionally”“Furthermore”“In addition”）开头；每段最多让一句以“Moreover”或“Notably”开头；保留文本已有的对比、因果或顺序标记（“However”“Thus”“First”），不要仅为衔接句子而添加因果关系。
• RULE-E 段末总结：不要在每段末尾都用一句话重述段落要点。
• RULE-F 术语一致性：定义术语或缩写后，始终使用该术语；不要交替使用同义词。
• RULE-G 标题大小写：章节和小节标题使用标题式大小写；冠词和较短的介词使用小写。完整句式的粗体引导语使用句首字母大写。
• RULE-H 引文规范（关键）：用可核验的引文或具体证据支持事实性论断；绝不可捏造引文。
• RULE-I 缩写形式：正式技术写作中，优先使用“it is”／“does not”／“cannot”，而不是“it's”／“doesn't”／“can't”。

例外情况

“宁可违反这些规则，也不要说出任何十足野蛮的话。” — George Orwell，《Politics and the English Language》（1946），规则 6。大多数规则都是需要酌情应用的默认准则。只有在能让句子读起来更好时才偏离，不要为了改变模式而偏离。少数规则是硬性规定（不得捏造引文、证据或数字；成稿中不得有占位符）。应从整体模式评价草稿：如果每个句子都遵守每条默认准则，读起来就会像机器写的。

行文风格

这些规则以经典指南为基础，并针对一位作者 Yue Zhao 进行了调整。RULES.md 中的「行文风格」一节总结了这位作者在 AI 写作工具出现前撰写的第一作者 ML 论文中的写作习惯：摘要、引言、结果段落和结论的写法；大约每四个句子中就有一个超过 30 个词，并带有括号补充说明；以及少用提示性语句。当某条风格规则与其中的习惯冲突时，应遵循这些习惯，但不得违背事实或硬性规定。起草论文或提案部分前，请先阅读 RULES.md 中的该节。

完整规则正文（权威版本）

各条规则的完整指令、BAD/GOOD 示例对和理由，请参阅本项目中的 .agent-style/RULES.md，或查看固定版本的权威来源：https://raw.githubusercontent.com/yzhao062/agent-style/v0.9.0/RULES.md。