Writing Clearly and Concisely

概述

William Strunk Jr. 的 The Elements of Style (1918) 教你如何写出清晰、简洁的文字。

警告：elements-of-style.md 约消耗 12,000 tokens。仅在编写或编辑文档时读取完整内容。

使用场景

当为人类编写文本时使用此 skill：

• 文档、README、技术说明

• Commit messages、Pull Request 描述

• 错误信息、UI 文案、帮助文本、注释

• 报告、摘要、或任何解释性文本

如果你在为人类读者写句子，就使用此 skill。

使用策略

轻量模式（用于 haiku 模型和简单文档）

直接参考下方的规则摘要，应用核心原则：

• Rule 10: 使用主动语态

• Rule 11: 正面陈述

• Rule 12: 使用具体、明确的语言

• Rule 13: 删除冗词

• Rule 16: 相关词语紧邻

• Rule 18: 强调词放句末

深度模式（用于 sonnet/opus 模型和重要文档）

当生成最终报告、知识沉淀文档时：

• 先生成草稿

• 使用 Read 工具读取 elements-of-style.md

• 逐条检查 Section V（常见误用词）

• 优化并定稿

受限上下文策略

当上下文紧张时：

• 根据规则摘要独立完成草稿

• 派发子 agent，携带草稿和 elements-of-style.md

• 让子 agent 进行编辑润色并返回修订版

规则摘要

Elementary Rules of Usage（语法/标点）

• 所有格单数名词加 's

• 三个或更多项的系列中，每项后加逗号（除最后一项）

• 插入语用逗号包围

• 引入并列从句的连词前加逗号

• 不要用逗号连接独立从句

• 不要把句子断成两截

• 句首的分词短语必须指向语法主语

Elementary Principles of Composition（写作原则）

• 一段一主题

• 段落以主题句开头

• 使用主动语态

• 用肯定形式陈述

• 使用明确、具体、形象的语言

• 删除冗词

• 避免连续松散句

• 用相似形式表达并列概念

• 相关词语保持紧邻

• 摘要保持同一时态

• 强调词放在句末

Section V: Words and Expressions Commonly Misused

按字母顺序参考常见用词问题（详见 elements-of-style.md ）

核心原则速查

原则 说明 示例

主动语态 主语执行动作 ✓ "测试发现了 3 个错误" ✗ "3 个错误被测试发现"

正面陈述 避免双重否定 ✓ "忘记了" ✗ "没有记住"

删除冗词 精简表达 ✓ "现在" ✗ "在目前这个时间点"

具体语言 避免抽象模糊 ✓ "响应时间 200ms" ✗ "性能不错"

强调词放句末 重点信息收尾 ✓ "最重要的是安全性"

底线

为人类写作？读取 elements-of-style.md 并应用规则。Token 不足？派发子 agent 使用完整指南进行编辑。