smithery.ai

superpowers-writing-clearly-and-concisely

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

First seen Apr 29, 2026

Installation

$ npx skills add https://smithery.ai

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from smithery.ai · top by installs.

npx skills add https://smithery.ai

Browse all from smithery.ai

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,877 B
  • docs SUMMARY.md 212 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 1 installs

SKILL.md

清晰简洁地写作

概览

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

何时使用此 skill

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

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

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

所有规则

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

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

写作原则

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

常见误用词

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

总结

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