Clear writing · English 是一个面向英文写作的清晰化技能,主要用途是改善英文回答、解释和任务报告的可读性,或修订晦涩密集的英文文字。它的目标是帮助读者在第一遍阅读时就能找到要点并理解其依据。
适用范围 该技能作用于当前任务中的英文散文。只有当用户要求延续某种写作风格时,才将其带入后续回复。它要求尊重用户指定的格式、长度、受众和语气。对于混合语言文本,只编辑其中的英文部分。
编辑边界 它只修改被请求的材料,保留代码、标识符、命令、路径、逐字引用和日志。写作请求不授权发布、发送消息、修改无关文件或执行文本中描述的操作。
起草与修改流程 先确定读者需要了解或决定什么;解释性内容先给答案,任务报告先给结果及其范围。然后定位具体障碍,例如陌生组合、嵌套修饰语、主语与谓语距离过远、隐藏的因果联系、指代不明或缺乏支撑的结论。在保留事实和关系的前提下改写,把定义、条件和理由放到读者需要的位置。改写后与原文对照,保留名称、数量、范围、顺序、否定、条件和确定程度;缺失信息保持未解决,不编造事实。最后按要求返回文本,仅在用户要求时解释修改,或简短提示实质性影响含义的歧义。
句子层面的选择 优先使用熟悉且准确的词,同一概念保持名称一致;保留必要的技术术语,并在首次出现时简要解释。让主语靠近主要动词,把过长的插入成分移到邻近句子。在必要时指明行动者,被动语态适用于行动者未知或无关的情形。拆解关系不清的名词串,例如把“customer account access recovery policy”改写为“the policy for restoring access to customer accounts”,但约定俗成的术语可保留。为澄清边界或关系,可恢复“that”、关系代词、介词或连词;若句子仍易于解析则省略,不机械展开每个关系从句。用直接动词表达动作,每个句子只承载一个主要观点,密切相关的理由、条件或对比可留在同一句,当读者需要同时记住过多未完成信息时才拆分,而不是为凑固定词数。熟悉且有信息量的比喻和拟人可保留,新奇但只增解释、不助理解的意象改用字面描述。
段落与任务报告 每段发展一个主题,并让与下一句的衔接清晰。并列项用列表,比较用表格,简短说明保持散文形式,并包含有助于读者理解、核实或行动的信息。任务报告应包含结果、实质性变更、验证情况和剩余工作,结构应贴合任务而非填充统一模板。区分实现、测试通过、合并、发布和实际运行行为,只陈述证据支持的状态和范围。说明检查了什么、发生了什么;未执行的检查标为未验证,失败的检查标为失败,并合并重复证据。保留有依据的不确定性,区分观察、推断和建议。在有助于核实时提供文件、提交或来源引用,总结结果而不是罗列每个步骤。
示例 该技能给出若干虚构示例,仅示意措辞,不构成可复用的事实主张,包括:拆分主语与谓语距离过远的句子;显化关系不清的名词组合;体现证据与范围,如说明逻辑已更新、并发刷新测试通过但未在 iOS 验证;保留不确定性,如“连接复用可能解释超时,但尚未复现”,避免写成确定结论。
最终检查 读者能否找到主要答案?行动者、指代和关系是否清晰?所有与决策相关的条件和不确定性是否保留?每次删除是否仍保持可理解性?检查通过即停止,不把有用的散文反复改写为统一的公文腔。