目录
当AI的说明难以理解时,先别急着缩短,而应要求模型充分解释想要表达的意思。explain-before-shorten技能将这一指令转化为可重复使用的编辑流程,同时保留专业术语和重要条件。
要点#
- 修改具体措辞前,先确定读者需要理解什么。
- 先写出一份口头讲解也能让人听懂的草稿,再进行精简。
- 将条件和限制放在其所约束的表述附近。
- 检查最终文本能否独立表达清楚;如果版式很重要,还应检查页面的实际显示效果。
简短的说明为何难以传达意思#
句子即使在技术上正确,也可能没有说明要点。请看所提供资料中的以下示例。
> Completed表示代码已执行完毕,并不表示无效输入的数量为零。
这一区别或许很重要,但第二句话在解释执行状态与输入有效性的关系之前,就先提出了提醒。如果读者想了解Completed的定义,这条提醒可能会分散他们对要点的注意力。如果读者想知道如何解读验证结果,这段说明又不够充分。
修改方式取决于目的。如果是定义状态,可能只需写“Completed表示代码已执行完毕”。如果是解释验证,则需要经过确认的信息,说明无效输入如何影响结果。用编造的解释替换提醒,即使更易读,也会降低可信度。
这项技能会改变什么#
explain-before-shorten技能改变的是编辑顺序。它要求模型先明确说明需要传达什么,再写出充分的解释,而不是立即删减文字。
“大声讲解”是一种思考方法,并非对文风的要求。最终文章仍可保持正式文风。读者需要的专业术语应予以保留。目的是解释其含义,而非将其替换成含糊的日常用语。
所提供的技能面向幻灯片、技术文档和邮件中的日语说明。其编辑方法也可用于英语文章,但资料并未说明,更换语言或模型后,它能在多大程度上稳定发挥作用。
分6步审改#
将以下步骤应用于段落、幻灯片和表格条目。
1. 明确想要表达的意思。 用一句话写出希望读者理解什么。对于只需解释概念的文章,不要额外添加行动建议。 2. 不限制篇幅,充分解释。 说明会发生什么,并根据需要补充原因或条件。区分已确认的事实、建议和可能性。 3. 分开不同话题。 将机制、要求和例外分别放在不同句子或位置。每个条件都应紧邻其所约束的表述。 4. 在不丢失含义的前提下精简。 删除重复内容和不必要的铺垫。保留主体、动作、因果关系和重要限制。 5. 只读最终文本。 检查没有长篇草稿或口头补充说明,是否仍能理解。 6. 检查编辑结果。 确认保存的文本与预期修改一致。对于尺寸固定的幻灯片,还应检查换行以及是否与页脚重叠。
如果精简后变得难懂,就把删掉的文字加回来。与需要读者自行补全解释才能理解的句子相比,稍长一些的句子更合适。
具体说明修改要求#
有效的请求应同时提供难懂的文本及其目的。
> 请使用explain-before-shorten修改这个段落。读者需要理解Completed的含义。请先解释意思,再进行精简。保留技术条件,指出缺失的事实,不要编造。
如果前后段落或相关表格会影响含义,也应一并提供。如果只要求“表达得更自然些”,模型就只能猜测问题出在用词、结构还是信息不足。
所提供的技能通常会先返回最终文本,再简要说明重要改动。无需每次都展示用于编辑的长篇草稿。这样,回复就能集中于用户可直接使用的文本。
明确限制条件#
即使要精简,也不能删除决定表述是否成立的条件。例如,“不保证达到最大值”这一简短表述,并未告诉读者什么因素会妨碍达到该值。如果详细解释,或许可以指出分配上限构成了限制,但前提是该条件已在目标系统中得到确认。
资料中的示例展示的是写作方法,而非产品的共同行为。有关分配上限、服务更新和执行限制的表述,在其他场景中复用前都需要核实。
编辑范围同样重要。收到审阅措辞的请求时,应提出建议;收到编辑请求时,则修改指定文档。两者都不意味着可以对其他页面或技能进行无关修改。如果无法确认保存或显示结果,应明确说明这一限制。
下一步#
选取一段AI写的难懂文字,请求使用explain-before-shorten进行修改。同时附上一句话,具体说明读者需要理解什么。
来源: https://zenn.dev/microsoft/articles/explain-before-shorten
目录
