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 使用完整指南进行编辑。