Writing Clearly And Concisely 说明文档

# 清晰简洁的写作 一种应用 William Strunk Jr. 永恒写作原则的技能，旨在产生更清晰、更有力、更专业的文案，同时避免常见的 AI 写作模式。 ## 目的 此技能可帮助你为人类读者写出更好的文案。它借鉴了两个来源： 1. **《风格要素》(The Elements of Style)** (Strunk, 1918) - 经过时间考验的清晰、有力写作规则 2. **AI 模式规避** - 基于研究的指导，旨在避免 LLM 倾向于产生的通用、浮夸的语言 无论你是在编写文档、提交信息、错误消息还是任何人类会阅读的文本，此技能都能帮助你删减冗余，直达重点。 ## 使用场景 当你为人类编写文案时，请使用此技能： - **文档** - README 文件、API 文档、技术说明 - **Git 工作流** - 提交信息、拉取请求描述 - **面向用户的文本** - 错误消息、UI 文案、帮助文本、工具提示 - **代码注释** - 内联文档、文档字符串 - **报告和摘要** - 状态更新、分析、解释 - **编辑** - 提高现有文本的清晰度 **触发短语：** - “为...编写文档” - “起草一份 README” - “编辑此内容以提高清晰度” - “使其更简洁” - “审查此提交信息” ## 工作原理 1. **加载技能**：在为人类读者编写文案时加载 2. **应用 Strunk 的核心原则** - 主动语态、肯定形式、具体语言、删除不必要的词 3. **避免 AI 模式** - 没有浮夸、没有空洞的短语、没有促销性的形容词 4. **参考详细指南**：在需要特定规则时参考详细指南 ### 上下文高效方法 该技能使用渐进式披露来节省上下文： - **SKILL.md** (~1,000 tokens) 首先加载核心规则 - **参考文件** (每个 1,000-4,500 tokens) 仅在需要时加载 - **大多数任务仅需一个文件**：`03-elementary-principles-of-composition.md` 对于上下文紧缺的情况，派遣一个子智能体 (subagent) 处理你的草稿和相关章节文件。 ## 关键特性 ### Strunk 的核心规则 该技能强调《风格要素》中的这些原则： | 规则 | 原则 | |------|-----------| | 10 | 使用主动语态 | | 11 | 使用肯定形式陈述 | | 12 | 使用明确、具体、具体的语言 | | 13 | 省略不必要的词 | | 16 | 保持相关词汇在一起 | | 18 | 将强调的词放在句末 | ### AI 模式检测 该技能识别并消除常见的 LLM 写作模式： - **浮夸 (Puffery)**：piv