用途:把演讲脚本(speaker notes、实验室研讨会、学术会议、答辩脚本)改成适合“只听一次”的版本。适用场景包括:已有幻灯片只需打磨脚本、要求改得更自然清晰、调整幻灯片顺序后检查衔接、答辩或研讨会预演前的最后检查。不适用于从零做幻灯片、论文段落润色或修改事实与数据本身,它只改表达方式。
七条原则:一,用一句话主题放在开头和结尾。二,选一个大隐喻贯穿全场,产出“隐喻回收地图”。三,每个核心概念配一个听众能在脑中演算的日常例子,顺序为例→模型做的事→为什么→意味着什么。四,每个主张只说一个数字,过多则用近似说法,并把数值放回幻灯片。五,术语首次出现时解释,一个概念只用一个名字。六,先说数量,再在段落之间搭桥。七,句子要短,结论段最短,韩语超过50字的句子考虑拆分,短文比例建议不低于60%。
工作流程:整理脚本为分节格式,提取主题与隐喻,制作隐喻回收地图,用脚本测量修改前指标,按清单逐节修改,通读检查衔接,再次测量并给出前后对比表。
使用方式:运行 python scripts/clarity_metrics.py deck/index.html --metaphor 陷阱 --aliases "注入,贴上,嵌入" 等命令测量;支持 HTML 演示文稿或 [编号 · 标题 · 秒] 格式的脚本文本。配套文件包括 references/checklist.md、references/examples-rsp.md 和 scripts/clarity_metrics.py。
限制:不修改事实与数字,只改说法;方向词需与幻灯片实际布局一致;时间标注按语速约每秒5至5.5字调整。相关技能包括 academic-slides-iterative、paper-section-rewrite、humanize-korean。