writing-clearly-and-concisely 是一份帮助 AI 把说明文字写清楚的 Skill。文档、提交消息、报错提示或报告里,读者看完仍不知道发生了什么时,它用具体表达替换空泛评价。
主文借用 Strunk 的英文写作原则:一个段落围绕一个话题,尽量用主动语态,把相关词放近,删掉不提供信息的词。也提醒少堆“关键、突破、无缝”一类宣传形容词,不用加粗和列表掩盖缺少内容。
完整语法解释与例子另在参考文件,本文只介绍主文已经列出的取舍。英文标点和语法规则不能照搬为中文硬标准;用在中文说明里,先保住对象、动作和原因,再删套话,才有助于读者理解,不是追求每句话都越短越好。