清晰简洁写作Skill writing-clearly-and-concisely

此技能旨在帮助用户撰写清晰、简洁的文本,特别适用于技术文档、错误消息、UI文本等场景。通过应用Strunk的写作规则,避免AI写作模式,提高写作的专业性和可读性。关键词:写作技巧、清晰写作、简洁表达、技术文档、Strunk规则、AI写作避免。

其他 0 次安装 0 次浏览 更新于 3/21/2026

name: 清晰简洁写作 description: 适用于撰写人类阅读的散文——文档、提交消息、错误消息、解释、报告或UI文本。应用Strunk的永恒规则,实现更清晰、更强有力、更专业的写作。

清晰简洁写作

概述

以清晰和有力的方式写作。此技能涵盖该做什么(Strunk规则)和不该做什么(AI模式)。

何时使用此技能

每当为人类撰写散文时使用此技能:

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

如果您正在撰写供人类阅读的句子,请使用此技能。

有限上下文策略

当上下文紧张时:

  1. 使用判断力撰写草稿
  2. 派遣子代理,带上您的草稿和相关部分文件
  3. 让子代理进行编辑并返回修订版本

加载单个部分(约1,000-4,500令牌)而不是所有内容,可以节省大量上下文。

风格要素

William Strunk Jr.的《风格要素》(1918年)教您清晰写作并无情删减。

规则

用法基本规则(语法/标点)

  1. 形成所有格单数,添加’s
  2. 在系列中的每个术语后使用逗号,除了最后一个
  3. 用逗号将插入语括起来
  4. 逗号在引入并列从句的连接词前
  5. 不要用逗号连接独立从句
  6. 不要把句子分成两半
  7. 开头的分词短语指代语法主语

作文基本原则

  1. 每个主题一个段落
  2. 以主题句开始段落
  3. 使用主动语态
  4. 以肯定形式陈述
  5. 使用明确、具体、具体的语言
  6. 省略不必要的词
  7. 避免连续的松散句子
  8. 以相似的形式表达并列思想
  9. 将相关词放在一起
  10. 在摘要中保持一致时态
  11. 将强调词放在句子末尾

参考文件

以上规则是从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 涵盖了最重要的内容。