writing-clearly-and-concisely

# 清晰简洁地写作 ## 概述 清晰且有力地写作。本技能涵盖了应该做什么（斯特伦克规则）以及不应该做什么（AI 模式）。 ## 何时使用此技能 当你为人类撰写散文时，请使用此技能： - 文档、README 文件、技术解释 - 提交信息、合并请求描述 - 错误消息、UI 文案、帮助文本、注释 - 报告、摘要或任何解释 - 为提高清晰度而进行的编辑 **如果你正在撰写供人类阅读的句子，请使用此技能。** ## 有限上下文策略 当上下文空间有限时： 1. 根据判断撰写草稿 2. 派遣一个子智能体（subagent）处理你的草稿和相关章节文件 3. 让子智能体进行润色并返回修订版 加载单个章节（约 1,000-4,500 tokens）而不是全部内容，可以显著节省上下文。 ## 风格要素 威廉·斯特伦克（William Strunk Jr.）的《风格要素》（1918）教导你清晰写作并无情地删减冗余。 ### 规则 **基本用法规则（语法/标点）**： 1. 通过添加 's 构成单数所有格 2. 在系列术语中，除最后一项外，每项后使用逗号 3. 用逗号括起插入语 4. 在引导并列从句的连词前使用逗号 5. 不要用逗号连接独立从句 6. 不要将句子拆分为两半 7. 开头的分词短语应指向语法主语 **基本写作原则**： 8. 每个主题一段 9. 段落以主题句开头 10. **使用主动语态** 11. **使用肯定形式陈述** 12. **使用明确、具体、具体的语言** 13. **省略不必要的词语** 14. 避免连续使用松散的句子 15. 用相似的形式表达并列思想 16. **将相关的词放在一起** 17. 摘要中保持时态一致 18. **将强调的词放在句末** ### 参考文件 以上规则总结自斯特伦克的原始文本。如需包含示例的完整解释，请参考： | 章节 | 文件 | ~Tokens | |---------|------|---------| | 语法、标点、逗号规则 | `02-elementary-rules-of-usage.md` | 2,500 | | 段落结构、主动语态、简洁性 | `03-elementary-principles-of-composition.md` | 4,500 | | 标题、引用、格式 | `04-a-few-matters-of-form.md` | 1,000 | | 词汇选择、常见错误 | `05-words-and-expressions-commonly-misused.md` | 4,000 | **大多数任务仅需 `03-elementary-principles-of-composition.md`** —— 它涵盖了主动语态、肯定形式、具体语言以及省略不必要的词语。