elements-of-style
Strunk 写作规则，用于提升文档质量。适用于所有面向人类读者的文本：文档、报告、注释、提交信息等。
Resources
1Install
npx skillscat add penkzhou/swiss-army-knife-plugin/elements-of-style Install via the SkillsCat registry.
This skill provides guidance on applying Strunk's writing rules to improve the clarity and conciseness of text intended for human readers. It helps ensure documents, reports, comments, and commit messages follow established principles of good writing style. Use it when creating or editing any written content that will be read by people.
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 使用完整指南进行编辑。
Categories
Install
npx skillscat add penkzhou/swiss-army-knife-plugin/elements-of-style Install via the SkillsCat registry.