elements-of-style

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Writing Clearly and Concisely

概述

Overview

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

警告：

elements-of-style.md

约消耗 12,000 tokens。仅在编写或编辑文档时读取完整内容。

William Strunk Jr.'s The Elements of Style (1918) teaches you how to write clear, concise text.

Warning:

elements-of-style.md

consumes approximately 12,000 tokens. Only read the full content when writing or editing documents.

使用场景

Use Cases

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

文档、README、技术说明
Commit messages、Pull Request 描述
错误信息、UI 文案、帮助文本、注释
报告、摘要、或任何解释性文本

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

Use this skill when writing text for human readers:

Documents, READMEs, technical specifications
Commit messages, Pull Request descriptions
Error messages, UI copy, help text, comments
Reports, summaries, or any explanatory text

If you're writing sentences for human readers, use this skill.

使用策略

Usage Strategies

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

Lightweight Mode (for Haiku models and simple documents)

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

Rule 10: 使用主动语态
Rule 11: 正面陈述
Rule 12: 使用具体、明确的语言
Rule 13: 删除冗词
Rule 16: 相关词语紧邻
Rule 18: 强调词放句末

Refer directly to the rule summary below and apply the core principles:

Rule 10: Use the active voice
Rule 11: Make positive statements
Rule 12: Use specific, definite language
Rule 13: Omit needless words
Rule 16: Keep related words close
Rule 18: Place emphasis at the end of the sentence

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

Deep Mode (for Sonnet/Opus models and important documents)

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

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

When creating final reports or knowledge retention documents:

First generate a draft
Use the Read tool to read
```
elements-of-style.md
```
Check Section V (Commonly Misused Words and Expressions) item by item
Refine and finalize the draft

受限上下文策略

Constrained Context Strategy

当上下文紧张时：

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

When context is limited:

Independently complete the draft based on the rule summary
Dispatch a sub-agent with the draft and
```
elements-of-style.md
```
Have the sub-agent edit and polish the draft, then return the revised version

规则摘要

Rule Summary

Elementary Rules of Usage（语法/标点）

Elementary Rules of Usage (Grammar/Punctuation)

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

Add 's to singular possessive nouns
Use a comma after each item in a series of three or more (except the last one)
Enclose parenthetical expressions in commas
Use a comma before the conjunction introducing a coordinate clause
Do not join independent clauses with a comma
Do not break sentences in two
A participial phrase at the beginning of a sentence must refer to the grammatical subject

Elementary Principles of Composition（写作原则）

Elementary Principles of Composition (Writing Principles)

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

Each paragraph should have a single topic
Begin paragraphs with a topic sentence
Use the active voice
State in positive form
Use definite, specific, concrete language
Omit needless words
Avoid a succession of loose sentences
Express coordinate ideas in similar form
Keep related words close
Keep summaries in the same tense
Place emphasis at the end of the sentence

Section V: Words and Expressions Commonly Misused

按字母顺序参考常见用词问题（详见

elements-of-style.md

）

Refer to commonly misused words alphabetically (see

elements-of-style.md

for details)

核心原则速查

Quick Reference for Core Principles

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

Principle	Explanation	Example
Active Voice	The subject performs the action	✓ "The test found 3 errors" ✗ "3 errors were found by the test"
Positive Statement	Avoid double negatives	✓ "Forgot" ✗ "Did not remember"
Omit Needless Words	Simplify expressions	✓ "Now" ✗ "At the present time"
Specific Language	Avoid abstraction and vagueness	✓ "Response time 200ms" ✗ "Good performance"
Emphasis at Sentence End	Conclude with key information	✓ "Most importantly, security"

底线

Bottom Line

为人类写作？读取

elements-of-style.md

并应用规则。Token 不足？派发子 agent 使用完整指南进行编辑。

Writing for humans? Read

elements-of-style.md

and apply the rules. Short on tokens? Dispatch a sub-agent to use the full guide for editing.