AgentSkillsCN

superpowers-writing-clearly-and-concisely

将以下写作原则应用于任何人类可读文本(文档、提交/PR 信息、错误提示、解释、报告、UI 文案等),让文字更加清晰有力。

SKILL.md
--- frontmatter
name: superpowers-writing-clearly-and-concisely
description: 将下面的写作原则应用于任何人类可读文本(文档、提交/PR 信息、错误提示、解释、报告、UI 文案等),让文字更清晰有力

清晰简洁地写作

概览

基于简明中文写作原则:清晰、直接、具体、删繁就简。

何时使用此 skill

适用于所有需要人类阅读的文字:

  • 文档、README、技术说明
  • 提交信息、PR 描述
  • 错误消息、UI 文案、帮助文本、注释
  • 报告、总结、各类解释说明
  • 编辑文本以提升清晰度

只要写给人看的文字,就用这个 skill。

所有规则

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

  1. 句子短平实,能断句就断句
  2. 并列项用顿号/逗号分清,避免歧义
  3. 插入说明用逗号/破折号括起
  4. 主谓宾就近放,避免长串定语
  5. 不要用逗号拼接两个完整句子
  6. 时态、主语保持一致,避免悬挂修饰
  7. 中文行文尽量用全角标点

写作原则

  1. 一段一事,段首点题
  2. 用主动语态、肯定式表达
  3. 句子具体可感,避免空洞形容
  4. 删掉废话:去掉“进行”“相关的”等虚词
  5. 相同结构并列,避免跳跃
  6. 重要信息放句末或段首
  7. 先结论,后补充;避免长铺垫
  8. 给出数字、示例、路径,少用“适当”“可能”等模糊词
  9. 若需步骤,用列表或序号,保持对齐
  10. 技术名词保持英文原文,必要时括注中文

常见误用词

常见冗词:进行、相关的、各个、非常、一定、其实、基本、一定程度上、可能会(视语境删或改为具体描述)

总结

写中文时,遵循以上规则:短句、主动、具体、删繁就简,必要时配数字和例子。若不确定,先写草稿再对照这些规则自查。