name: 清晰简洁写作 description: 适用于撰写人类阅读的散文——文档、提交消息、错误消息、解释、报告或UI文本。应用Strunk的永恒规则,实现更清晰、更强有力、更专业的写作。
清晰简洁写作
概述
以清晰和有力的方式写作。此技能涵盖该做什么(Strunk规则)和不该做什么(AI模式)。
何时使用此技能
每当为人类撰写散文时使用此技能:
- 文档、README文件、技术解释
- 提交消息、拉取请求描述
- 错误消息、UI文本、帮助文本、注释
- 报告、摘要或任何解释
- 编辑以提高清晰度
如果您正在撰写供人类阅读的句子,请使用此技能。
有限上下文策略
当上下文紧张时:
- 使用判断力撰写草稿
- 派遣子代理,带上您的草稿和相关部分文件
- 让子代理进行编辑并返回修订版本
加载单个部分(约1,000-4,500令牌)而不是所有内容,可以节省大量上下文。
风格要素
William Strunk Jr.的《风格要素》(1918年)教您清晰写作并无情删减。
规则
用法基本规则(语法/标点):
- 形成所有格单数,添加’s
- 在系列中的每个术语后使用逗号,除了最后一个
- 用逗号将插入语括起来
- 逗号在引入并列从句的连接词前
- 不要用逗号连接独立从句
- 不要把句子分成两半
- 开头的分词短语指代语法主语
作文基本原则:
- 每个主题一个段落
- 以主题句开始段落
- 使用主动语态
- 以肯定形式陈述
- 使用明确、具体、具体的语言
- 省略不必要的词
- 避免连续的松散句子
- 以相似的形式表达并列思想
- 将相关词放在一起
- 在摘要中保持一致时态
- 将强调词放在句子末尾
参考文件
以上规则是从Strunk的原始文本中总结出来的。有关完整解释和示例:
| 部分 | 文件 | ~令牌 |
|---|---|---|
| 语法、标点、逗号规则 | 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写作模式
LLMs倾向于统计均值,产生通用、浮夸的散文。避免:
- 浮夸: 关键的、至关重要的、重要的、证明、持久的遗产
- 空的"-ing"短语: 确保可靠性、展示特性、突出能力
- 促销形容词: 突破性的、无缝的、强大的、前沿的
- 过度使用的AI词汇: 深入、利用、多方面、培养、领域、织锦
- 格式过度使用: 过多的项目符号、表情符号装饰、每两个词就加粗
要具体,不要宏大。说出它实际做什么。
有关这些模式为何发生的全面研究,请参阅 signs-of-ai-writing.md。维基百科编辑开发了这个指南来检测AI生成的提交——他们的模式已得到充分记录和现场测试。
底线
为人类写作?从 elements-of-style/ 加载相关部分并应用规则。对于大多数任务,03-elementary-principles-of-composition.md 涵盖了最重要的内容。