陌讯skills聚合平台

elements-of-style

📁 penkzhou/swiss-army-knife-plugin 📅 Jan 26, 2026
4
总安装量
3
周安装量
#54511
全站排名
安装命令
npx skills add https://github.com/penkzhou/swiss-army-knife-plugin --skill elements-of-style

Agent 安装分布

antigravity 3
claude-code 3
gemini-cli 3
codex 2
kiro-cli 2

Skill 文档

Writing Clearly and Concisely

概述

William Strunk Jr. 的 The Elements of Style (1918) 教你如何写出清晰、简洁的文字。

警告：elements-of-style.md 约消耗 12,000 tokens。仅在编写或编辑文档时读取完整内容。

使用场景

当为人类编写文本时使用此 skill：

  • 文档、README、技术说明
  • Commit messages、Pull Request 描述
  • 错误信息、UI 文案、帮助文本、注释
  • 报告、摘要、或任何解释性文本

如果你在为人类读者写句子，就使用此 skill。

使用策略

轻量模式（用于 haiku 模型和简单文档）

直接参考下方的规则摘要，应用核心原则：

  • Rule 10: 使用主动语态
  • Rule 11: 正面陈述
  • Rule 12: 使用具体、明确的语言
  • Rule 13: 删除冗词
  • Rule 16: 相关词语紧邻
  • Rule 18: 强调词放句末

深度模式（用于 sonnet/opus 模型和重要文档）

当生成最终报告、知识沉淀文档时：

  1. 先生成草稿
  2. 使用 Read 工具读取 elements-of-style.md
  3. 逐条检查 Section V（常见误用词）
  4. 优化并定稿

受限上下文策略

当上下文紧张时：

  1. 根据规则摘要独立完成草稿
  2. 派发子 agent，携带草稿和 elements-of-style.md
  3. 让子 agent 进行编辑润色并返回修订版

规则摘要

Elementary Rules of Usage（语法/标点）

  1. 所有格单数名词加 ‘s
  2. 三个或更多项的系列中，每项后加逗号（除最后一项）
  3. 插入语用逗号包围
  4. 引入并列从句的连词前加逗号
  5. 不要用逗号连接独立从句
  6. 不要把句子断成两截
  7. 句首的分词短语必须指向语法主语

Elementary Principles of Composition（写作原则）

  1. 一段一主题
  2. 段落以主题句开头
  3. 使用主动语态
  4. 用肯定形式陈述
  5. 使用明确、具体、形象的语言
  6. 删除冗词
  7. 避免连续松散句
  8. 用相似形式表达并列概念
  9. 相关词语保持紧邻
  10. 摘要保持同一时态
  11. 强调词放在句末

Section V: Words and Expressions Commonly Misused

按字母顺序参考常见用词问题（详见 elements-of-style.md）

核心原则速查

原则 说明 示例
主动语态 主语执行动作 ✓ “测试发现了 3 个错误” ✗ “3 个错误被测试发现”
正面陈述 避免双重否定 ✓ “忘记了” ✗ “没有记住”
删除冗词 精简表达 ✓ “现在” ✗ “在目前这个时间点”
具体语言 避免抽象模糊 ✓ “响应时间 200ms” ✗ “性能不错”
强调词放句末 重点信息收尾 ✓ “最重要的是安全性”

底线

为人类写作？读取 elements-of-style.md 并应用规则。Token 不足？派发子 agent 使用完整指南进行编辑。

GitHub 仓库 ↗ ← 返回陌讯 Skills 聚合平台
本页面由 陌讯 Skills 聚合平台 收录整理，数据定期更新。