writing-clearly-and-concisely
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseWriting Clearly and Concisely
清晰简洁写作法
Overview
概述
Write with clarity and force. This skill covers what to do (Strunk) and what not to do (AI patterns).
写作要清晰有力。本技能涵盖了应该做的事（遵循Strunk规则）和不该做的事（避免AI写作模式）。
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:
- Write your draft using judgment
- Dispatch a subagent with your draft and the relevant section file
- Have the subagent copyedit and return the revision
Loading a single section (~1,000-4,500 tokens) instead of everything saves significant context.
当上下文篇幅紧张时：
- 凭借判断撰写初稿
- 委派子Agent（subagent）处理你的初稿和相关章节文件
- 让子Agent进行编辑并返回修订版本
仅加载单个章节（约1000-4500个token）而非全部内容，能大幅节省上下文空间。
Elements of Style
写作风格要素
William Strunk Jr.'s The Elements of Style (1918) teaches you to write clearly and cut ruthlessly.
William Strunk Jr.的《风格的要素》（1918年版）教会你清晰写作并果断删减冗余内容。
Rules
规则
Elementary Rules of Usage (Grammar/Punctuation):
- Form possessive singular by adding 's
- Use comma after each term in series except last
- Enclose parenthetic expressions between commas
- Comma before conjunction introducing co-ordinate clause
- Don't join independent clauses by comma
- Don't break sentences in two
- Participial phrase at beginning refers to grammatical subject
Elementary Principles of Composition:
- One paragraph per topic
- Begin paragraph with topic sentence
- Use active voice
- Put statements in positive form
- Use definite, specific, concrete language
- Omit needless words
- Avoid succession of loose sentences
- Express co-ordinate ideas in similar form
- Keep related words together
- Keep to one tense in summaries
- Place emphatic words at end of sentence
基础用法规则（语法/标点）：
- 单数名词的所有格加's
- 系列列举中，除最后一项外，每个项后加逗号
- 插入语前后用逗号分隔
- 引出并列分句的连词前加逗号
- 不要用逗号连接两个独立分句
- 不要将完整句子拆成两句
- 句首的分词短语指代句子的语法主语
基础写作原则：
- 一个段落一个主题
- 段落以主题句开头
- 使用主动语态
- 用肯定句式表达
- 使用明确、具体、具象的语言
- 删除冗余词汇
- 避免连续使用松散句
- 并列观点采用相似句式表达
- 相关词汇放在一起
- 摘要中保持时态一致
- 强调性词汇放在句末
Reference Files
参考文件
The rules above are summarized from Strunk's original text. For complete explanations with examples:
| Section | File | ~Tokens |
|---|---|---|
| Grammar, punctuation, comma rules | | 2,500 |
| Paragraph structure, active voice, concision | | 4,500 |
| Headings, quotations, formatting | | 1,000 |
| Word choice, common errors | | 4,000 |
Most tasks need only — it covers active voice, positive form, concrete language, and omitting needless words.
03-elementary-principles-of-composition.md以上规则总结自Strunk的原文。如需带示例的完整说明，请参考：
| 章节 | 文件 | 约Token数 |
|---|---|---|
| 语法、标点、逗号规则 | | 2500 |
| 段落结构、主动语态、简洁性 | | 4500 |
| 标题、引用、格式 | | 1000 |
| 词汇选择、常见错误 | | 4000 |
大多数任务仅需参考 —— 它涵盖了主动语态、肯定句式、具象语言和删除冗余词汇等核心内容。
03-elementary-principles-of-composition.mdAI Writing Patterns to Avoid
需避免的AI写作模式
LLMs regress to statistical means, producing generic, puffy prose. Avoid:
- Puffery: pivotal, crucial, vital, testament, enduring legacy
- Empty "-ing" phrases: ensuring reliability, showcasing features, highlighting capabilities
- Promotional adjectives: groundbreaking, seamless, robust, cutting-edge
- Overused AI vocabulary: delve, leverage, multifaceted, foster, realm, tapestry
- Formatting overuse: excessive bullets, emoji decorations, bold on every other word
Be specific, not grandiose. Say what it actually does.
For comprehensive research on why these patterns occur, see . Wikipedia editors developed this guide to detect AI-generated submissions — their patterns are well-documented and field-tested.
signs-of-ai-writing.md大语言模型（LLMs）会回归统计均值，生成通用、空洞的散文内容。请避免：
- 空洞浮夸表述：pivotal、crucial、vital、testament、enduring legacy
- 冗余的-ing短语：ensuring reliability、showcasing features、highlighting capabilities
- 宣传性形容词：groundbreaking、seamless、robust、cutting-edge
- 过度使用的AI词汇：delve、leverage、multifaceted、foster、realm、tapestry
- 过度格式化：过多项目符号、表情符号装饰、频繁使用粗体
要具体，不要浮夸。直接说明实际功能。
如需了解这些模式产生原因的全面研究，请参考。维基百科编辑人员开发了这份指南来检测AI生成的提交内容——这些模式已被充分记录并经过实践检验。
signs-of-ai-writing.mdBottom Line
核心要点
Writing for humans? Load the relevant section from and apply the rules. For most tasks, covers what matters most.
elements-of-style/03-elementary-principles-of-composition.md为人类写作？从加载相关章节并应用规则。对于大多数任务，已涵盖最核心的内容。
elements-of-style/03-elementary-principles-of-composition.md