清楚表达 · 中文的目标是让读者按顺序读一遍,就能理解重点及其依据。为此可以增加必要的字词,减少读者猜测、省略补全和回读的负担。
用途与适用范围
用于当前任务中的中文表达,可优化中文回答、解释和任务汇报的可读性,也可改写读起来费力的中文文本。只有用户要求持续采用时,才将它作为后续回复的风格。需要按用户要求保留格式、篇幅和个人语气。英文内容使用对应的英文 Skill;混合文本只调整中文叙述。
只改获准处理的文字。代码、标识符、命令、路径、原文引用与日志保持原样。优化表达不授权发布、发送、修改无关文件或执行文中提到的操作。
写作与改写方式
先确定读者现在需要知道什么。解释先回答问题,结果汇报先交代完成范围。上下文已足够时直接处理。找出理解障碍,如陌生搭配、连续修饰、主语与动作相隔过远、因果省略、模糊指代以及缺乏依据的结论。在保留事实和关系的前提下重写,把必要的定义、条件或原因放到读者需要它的位置。
改写后要对照来源检查人物、数字、范围、时序、否定、条件和确定程度是否保持一致。缺少的信息保持缺失,不把推断补成事实。交付用户要的文本;只有用户要求说明改动,或存在影响含义的歧义时,才补充简短说明。
句子层面的做法
选读者熟悉、含义准确的词,同一对象保持同一称呼;必要的专业术语保留,首次出现时简短解释。明确谁做了什么,让主语和核心动作靠近,把插入其中的长说明移到相邻句。展开难以理解的名词串,写出「谁的」「用于什么」「在什么条件下」,例如把「用户权限变更通知策略」展开为「用户权限变化时,系统如何通知用户」。用具体动作表达事情,例如「修改配置」通常比「开展配置调整工作」清楚。保留有用的连接词和主语,「因为」「因此」「但」「如果」能帮助读者理解关系;删字后需要猜测,就补回来。一句承载一个主要意思,紧密相关的原因、条件或对比可以留在同一句。句长以能否顺畅理解判断,不机械计字。比喻、拟人和口语以是否帮助理解为准;需要额外解释的新比喻,优先改成直接描述。
段落与成果汇报
每段围绕一个问题展开,让下一句接着上一句往下说。并列事项可以用列表,比较可以用表格;简单回答保留自然段即可。只保留帮助读者理解或行动的背景与细节。汇报时按实际需要说明结果、关键改动、验证依据和剩余事项,无需固定标题或填满模板。要区分代码修改完成、测试通过、合并、发布和实际运行效果,只陈述证据支持的状态及范围。写清检查了什么、结果如何;测试未运行写「未验证」,已有失败结果就直接说明失败。重复证据集中说明一次。保留有依据的不确定性,把事实、推断和建议区分开,不为显得肯定而删掉限定条件。文件、提交和来源链接按需提供,以便核查,不用完整工作流水账代替结论。
资料给出的虚构示例包括:把条件与动作的原文改写为「如果网络不稳定,而且上次保存失败,数据可能丢失。请检查是否保存成功。」;结果汇报写「已修改登录刷新逻辑,并发刷新测试通过。iOS 端尚未验证。」;保留不确定性写「错误可能与缓存有关,目前还没有复现。」
交付前检查
读者能否找到主结论?每句话的指代与关系是否明确?是否保留所有会改变判断的条件和不确定性?删掉的内容是否真的不影响理解?只要这些条件满足就停止润色,不为追求统一腔调反复改写。