Back to Details

writing-clearly-and-concisely

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Writing Clearly and Concisely

清晰简洁地写作

Overview

概述

William Strunk Jr.'s The Elements of Style (1918) teaches you to write clearly and cut ruthlessly.
WARNING: 
elements-of-style.md
consumes ~12,000 tokens. Read it only when writing or editing prose.
小威廉·斯特伦克的《风格的要素》（1918年）教会你清晰写作并果断删改冗余内容。
注意： 
elements-of-style.md
会占用约12000个token。仅在写作或编辑散文时阅读它。

When to Use This Skill

何时使用此技能

Use this skill whenever you write prose for humans:
  • Documentation, README files, technical explanations
  • Commit messages, pull request descriptions
  • Error messages, UI copy, help text, comments
  • Reports, summaries, or any explanation
  • Editing to improve clarity
If you're writing sentences for a human to read, use this skill.
每当你为人类撰写散文内容时，都可以使用此技能：
  • 文档、README文件、技术说明
  • 提交信息、拉取请求描述
  • 错误提示、UI文案、帮助文本、注释
  • 报告、摘要或任何说明性内容
  • 编辑以提升内容清晰度
如果你正在撰写供人类阅读的句子，请使用此技能。

Limited Context Strategy

有限上下文策略

When context is tight:
  1. Write your draft using judgment
  2. Dispatch a subagent with your draft and 
    elements-of-style.md
  3. Have the subagent copyedit and return the revision
当上下文受限的时候：
  1. 凭借判断撰写初稿
  2. 派遣一个subagent，附上你的初稿和
    elements-of-style.md
  3. 让subagent进行编辑并返回修订版本

All Rules

所有规则

Elementary Rules of Usage (Grammar/Punctuation)

基础用法规则（语法/标点）

  1. Form possessive singular by adding 's
  2. Use comma after each term in series except last
  3. Enclose parenthetic expressions between commas
  4. Comma before conjunction introducing co-ordinate clause
  5. Don't join independent clauses by comma
  6. Don't break sentences in two
  7. Participial phrase at beginning refers to grammatical subject
  1. 单数名词所有格加's
  2. 系列列举中，除最后一项外，每项后加逗号
  3. 插入语前后用逗号隔开
  4. 引出并列分句的连词前加逗号
  5. 不要用逗号连接两个独立分句
  6. 不要将完整句子拆分成两句
  7. 句首的分词短语指代语法主语

Elementary Principles of Composition

基础写作原则

  1. One paragraph per topic
  2. Begin paragraph with topic sentence
  3. Use active voice
  4. Put statements in positive form
  5. Use definite, specific, concrete language
  6. Omit needless words
  7. Avoid succession of loose sentences
  8. Express co-ordinate ideas in similar form
  9. Keep related words together
  10. Keep to one tense in summaries
  11. Place emphatic words at end of sentence
  1. 一个段落一个主题
  2. 段落以主题句开头
  3. 使用主动语态
  4. 用肯定形式陈述内容
  5. 使用明确、具体、具象的语言
  6. 删除冗余词汇
  7. 避免连续使用松散句
  8. 并列内容采用相似句式
  9. 相关词汇放在一起
  10. 摘要中保持时态一致
  11. 将强调词汇放在句末

Section V: Words and Expressions Commonly Misused

第五部分：易误用的词汇与表达

Alphabetical reference for usage questions
按字母顺序排列的用法参考

Bottom Line

核心要点

Writing for humans? Read 
elements-of-style.md
and apply the rules. Low on tokens? Dispatch a subagent to copyedit with the guide.
为人类撰写内容？阅读
elements-of-style.md
并应用这些规则。token不足？派遣subagent依据该指南进行编辑。