SKILL.md
清晰简洁地写作
概览
基于简明中文写作原则:清晰、直接、具体、删繁就简。
何时使用此 skill
适用于所有需要人类阅读的文字:
- 文档、README、技术说明
- 提交信息、PR 描述
- 错误消息、UI 文案、帮助文本、注释
- 报告、总结、各类解释说明
- 编辑文本以提升清晰度
只要写给人看的文字,就用这个 skill。
所有规则
基础用法规则(语法/标点)
- 句子短平实,能断句就断句
- 并列项用顿号/逗号分清,避免歧义
- 插入说明用逗号/破折号括起
- 主谓宾就近放,避免长串定语
- 不要用逗号拼接两个完整句子
- 时态、主语保持一致,避免悬挂修饰
- 中文行文尽量用全角标点
写作原则
- 一段一事,段首点题
- 用主动语态、肯定式表达
- 句子具体可感,避免空洞形容
- 删掉废话:去掉“进行”“相关的”等虚词
- 相同结构并列,避免跳跃
- 重要信息放句末或段首
- 先结论,后补充;避免长铺垫
- 给出数字、示例、路径,少用“适当”“可能”等模糊词
- 若需步骤,用列表或序号,保持对齐
- 技术名词保持英文原文,必要时括注中文
常见误用词
常见冗词:进行、相关的、各个、非常、一定、其实、基本、一定程度上、可能会(视语境删或改为具体描述)
总结
写中文时,遵循以上规则:短句、主动、具体、删繁就简,必要时配数字和例子。若不确定,先写草稿再对照这些规则自查。