mcpField
W
writing-clearly-and-concisely

writing-clearly-and-concisely

github.com/obra生产力6072.1k 次安装11 周前更新
代码仓库

关于 writing-clearly-and-concisely

这项写作技能依据《The Elements of Style》，为面向人类读者的写作与编辑提供指导，涵盖语法、行文组织和精简表达，适用于文档、消息和说明。

主要功能

  1. 01语法与标点指导
  2. 02文章组织原则
  3. 03采用主动、具体的表达
  4. 04删减多余措辞

适用场景

  1. 01编辑技术文档
  2. 02撰写提交和拉取请求说明
  3. 03改进界面文案和错误消息

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/obra/the-elements-of-style --skill writing-clearly-and-concisely

安装后在 Claude Code 中输入/writing-clearly-and-concisely确认已加载。

附带文件elements-of-style.md

详细介绍

清晰简洁地写作

概述

William Strunk Jr. 的 The Elements of Style（1918 年）教你如何清晰写作，并果断删减冗词。

警告： elements-of-style.md 会占用约 12,000 个 token。仅在撰写或编辑散文时阅读。

何时使用此技能

只要你要为人类撰写散文，就使用此技能：

  • 文档、README 文件、技术说明
  • 提交消息、拉取请求说明
  • 错误消息、UI 文案、帮助文本、注释
  • 报告、摘要或任何说明
  • 为提高清晰度而进行的编辑

只要你在写供人阅读的句子，就使用此技能。

有限上下文策略

上下文有限时：

  1. 凭判断撰写草稿
  2. 将草稿和 elements-of-style.md 交给子 Agent
  3. 让子 Agent 进行文字编辑并返回修订稿

所有规则

基本用法规则（语法／标点）
  1. 单数名词的所有格形式是在词尾加 's
  2. 系列中的每个词后都加逗号，最后一个词除外
  3. 用逗号括住插入语
  4. 并列连词引出并列分句时，连词前加逗号
  5. 不要用逗号连接独立分句
  6. 不要把一个句子拆成两个
  7. 句首的分词短语应修饰语法主语
基本写作原则
  1. 每个主题写成一个段落
  2. 段落以主题句开头
  3. 使用主动语态
  4. 采用肯定表达
  5. 使用明确、具体、实在的语言
  6. 删去不必要的词语
  7. 避免连续使用松散句
  8. 用相似的形式表达并列观点
  9. 让相关词语彼此靠近
  10. 摘要中保持时态一致
  11. 把强调的词语放在句末
第五节：常见误用词语与表达

按字母顺序编排的用法参考

要点

要为人类写作？阅读 elements-of-style.md 并应用其中的规则。Token 不足？让子 Agent 根据指南进行文字编辑。

评论

支持 Markdown