elements-of-style skill

---
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 模型和重要文档）

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

1. 先生成草稿
2. 使用 Read 工具读取 `elements-of-style.md`
3. 逐条检查 Section V（常见误用词）
4. 优化并定稿

### 受限上下文策略

当上下文紧张时：

1. 根据规则摘要独立完成草稿
2. 派发子 agent，携带草稿和 `elements-of-style.md`
3. 让子 agent 进行编辑润色并返回修订版

## 规则摘要

### Elementary Rules of Usage（语法/标点）

1. 所有格单数名词加 's
2. 三个或更多项的系列中，每项后加逗号（除最后一项）
3. 插入语用逗号包围
4. 引入并列从句的连词前加逗号
5. 不要用逗号连接独立从句
6. 不要把句子断成两截
7. 句首的分词短语必须指向语法主语

### Elementary Principles of Composition（写作原则）

8. 一段一主题
9. 段落以主题句开头
10. **使用主动语态**
11. **用肯定形式陈述**
12. **使用明确、具体、形象的语言**
13. **删除冗词**
14. 避免连续松散句
15. 用相似形式表达并列概念
16. **相关词语保持紧邻**
17. 摘要保持同一时态
18. **强调词放在句末**

### Section V: Words and Expressions Commonly Misused

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

## 核心原则速查

| 原则 | 说明 | 示例 |
|------|------|------|
| 主动语态 | 主语执行动作 | ✓ "测试发现了 3 个错误" ✗ "3 个错误被测试发现" |
| 正面陈述 | 避免双重否定 | ✓ "忘记了" ✗ "没有记住" |
| 删除冗词 | 精简表达 | ✓ "现在" ✗ "在目前这个时间点" |
| 具体语言 | 避免抽象模糊 | ✓ "响应时间 200ms" ✗ "性能不错" |
| 强调词放句末 | 重点信息收尾 | ✓ "最重要的是安全性" |

## 底线

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