| name | elements-of-style |
| description | Strunk 写作规则，用于提升文档质量。适用于所有面向人类读者的文本：文档、报告、注释、提交信息等。 |
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 使用完整指南进行编辑。