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