writing-clearly-and-concisely

清晰简洁地写作

概述

清晰有力地写作。本技能涵盖应遵循的规则（斯特伦克）和应避免的陷阱（AI模式）。

何时使用本技能

当你为人类编写散文时，请使用本技能：

• 文档、README文件、技术解释
• 提交信息、拉取请求描述
• 错误消息、界面文案、帮助文本、注释
• 报告、摘要或任何解释
• 编辑以提高清晰度

如果你在编写供人类阅读的句子，请使用本技能。

有限上下文策略

当上下文紧张时：

1. 凭判断力撰写草稿
2. 将草稿和相关章节文件分派给子代理
3. 让子代理进行编辑并返回修订版

仅加载单个章节（约1,000-4,500个token）而非全部内容，可节省大量上下文。

风格要素

威廉·斯特伦克 Jr. 的《风格要素》（1918年）教你如何清晰写作并果断删减。

规则

基本用法规则（语法/标点）：

1. 单数名词所有格加's
2. 系列中每个词后加逗号，最后一个除外
3. 插入语前后用逗号隔开
4. 在连接并列分句的连词前加逗号
5. 不要用逗号连接独立分句
6. 不要将句子一分为二
7. 句首的分词短语应指向语法主语

基本写作原则：

8. 每段一个主题
9. 段落以主题句开头
10. 使用主动语态
11. 以肯定形式陈述
12. 使用明确、具体、具体的语言
13. 省略不必要的词语
14. 避免连续使用松散句
15. 并列思想用相似形式表达
16. 将相关词语放在一起
17. 摘要中保持同一时态
18. 将强调的词放在句末

参考文件

以上规则总结自斯特伦克原文。如需完整解释和示例：

章节	文件	约Token数
语法、标点、逗号规则	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 —— 它涵盖了主动语态、肯定形式、具体语言和省略不必要的词语。

应避免的AI写作模式

大语言模型倾向于回归统计平均值，产生泛泛而谈、浮夸的散文。避免：

• 浮夸词： 关键、至关重要、至关重要、证明、持久遗产
• 空洞的“-ing”短语： 确保可靠性、展示功能、突出能力
• 宣传性形容词： 开创性、无缝、强大、尖端
• 过度使用的AI词汇： 深入探讨、利用、多方面、促进、领域、画卷
• 过度格式化： 过多的项目符号、表情符号装饰、每隔一词加粗

要具体，不要浮夸。说明它实际做了什么。

关于这些模式为何出现的全面研究，请参阅 signs-of-ai-writing.md。维基百科编辑开发了这份指南以检测AI生成的提交——他们的模式有据可查且经过实地测试。

核心要点

为人类写作？从 elements-of-style/ 加载相关章节并应用规则。对于大多数任务，03-elementary-principles-of-composition.md 涵盖了最重要的内容。