关于 write-talk-script
write-talk-script 为学术演讲者根据幻灯片、论文和确切时长编写逐页讲稿,并提供计时预算与预设删减方案。它还支持计时检查,帮助准备演练和超时应对。
主要功能
- 01按幻灯片分配讲稿字数预算
- 02根据演讲速度计算累计时间
- 03撰写逐页讲稿与过渡语
- 04计时检查并定位超时页面
- 05标注可删减段落与节省时间
适用场景
- 01为会议报告准备定时讲稿
- 02将幻灯片转为演练用讲者备注
- 03为闪电演讲规划内容删减
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ shaishavmaisuria/ research-paper-lifecycle-skills --skill write-talk-script安装后在 Claude Code 中输入/write-talk-script确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/script-craft.mdtiming-and-cuts.mdscripts/script_timer.pyword_budget.py详细介绍
撰写演讲稿
撰写一份符合准确演讲时长的讲稿:按演讲者的实际语速为每张幻灯片分配字数预算,标注累计时间,写出过渡语,并标记可删减内容,这样即使现场超时,也能按预先制定的方案应对。幻灯片告诉观众该看什么;这份讲稿则是演讲者实际要说的话。这是 make-slides 在论文录用后的配套内容。
适用场景
- “为我的 12 分钟 SIGSPATIAL 演讲写讲稿”/“15 分钟的演讲时段,其中包括 3 分钟问答——我该说什么?”
- “把我的幻灯片整理成可以用来排练的演讲备注”
- “我的演讲超时了——该删掉哪些内容?”
- “我要做一个 5 分钟的闪电演讲/专题演讲”
- 使用
make-slides后、首次计时排练前。
输入
- 准确的演讲时段:总时长,以及问答是否包含在时段内。以主办方的演讲者说明和录用邮件为准,而不是凭记忆或场地资料。
- 幻灯片或大纲(按顺序列出幻灯片标题)。还没有幻灯片?请先运行
make-slides。 - 论文(优先使用终稿)——这是口头讲述的所有数字和论断的唯一可靠来源。
- 可选:
venues/conferences/<venue>-<year>.yml,用于了解会议信息;也可提供演讲者实测的每分钟字数。
流程
-
确定场次信息。 询问:总时长、问答环节是否计入、演讲语言,以及主持人是否使用计时牌。如果有场地档案,只将其用作背景参考,并通过实时的
cfp_url/ 场地网站再次核实——档案不包含演讲时长信息,而且时长每年都会变化。常见安排如下(务必核实,切勿想当然): 完整论文:12–20 分钟,含问答;CHI 历来约为演讲 10 分钟 + 问答 5 分钟;闪电演讲/重点报告:1–7 分钟。详情见 references/timing-and-cuts.md。 -
校准语速。 默认按 130 wpm 计算——这是适合会议演讲的从容语速。如果演讲者能完成 1 分钟朗读校准(timing-and-cuts.md §2),则使用其测得的语速;对于非母语演讲者或技术内容密集的材料,建议使用 110–120 wpm。切勿超过 150。
-
创建大纲文件。 每张幻灯片占一行(使用
-项目符号或##标题),并按幻灯片顺序排列。需要固定时长的幻灯片,在行尾标注| <minutes>(例如- 核心观点 | 2)。标题页和总结页通常标注为 0.5。 -
计算字数预算。 运行:
python3 scripts/word_budget.py --minutes 15 --qa 3 --outline outline.md \ [--wpm 120] [--venue-profile venues/conferences/<venue>.yml]另存机器可读格式,供第 6 步使用:
python3 scripts/word_budget.py ... --json > budget.json。 脚本会预留安全缓冲时间(默认为 0.5 分钟),确保演讲提前结束,而不是卡着铃声结束。还没有大纲?--slides N会将时长均分。 -
逐张幻灯片撰写讲稿, 每张幻灯片都不得超出其字数预算,并采用口语表达——句子简短、使用缩略形式和路标语,数字写成实际说出来的形式。关于文件格式(每张幻灯片使用一个
##标题、用[方括号]标注舞台指示和时间、每张幻灯片以写明的过渡句结尾)、开场和结尾模式,以及图表讲解,请遵循 references/script-craft.md。每项事实性论述都必须能追溯到论文——引用论文中的数字,再将其改写成适合口头表达的形式。 -
计时检查草稿。 运行:
python3 scripts/script_timer.py talk-script.md --budget budget.json(或者在没有预算文件时使用
--minutes 15 --qa 3)。对于超时的幻灯片,应通过删减文字解决,而不是打算加快语速;反复运行,直到结果为WITHIN BUDGET。退出代码:0 表示在预算内,1 表示超时,2 表示输入有误。 -
列出删减内容。 用
…标记 2–3 段可删减内容,总计占演讲内容的 10–15%(每个标记单独占一行,不得嵌套,也不得跨越幻灯片边界)。关于优先删减的内容和绝不能删减的内容,参见 timing-and-cuts.md §6。重新运行script_timer.py——它会报告每处删减可节省的秒数,以及应用所有删减能否解决超时问题。 -
完成排练材料包。 在每个幻灯片部分的顶部插入预算中的时间标记(例如
[4:30]),添加问答交接语,并附上排练流程和台上演讲超时应对流程(timing-and-cuts.md §8–9)。告知用户,只有至少完成一次计时的全程朗读排练后,才能确认时长合适。
输出
talk-script.md— 每张幻灯片对应一个##部分:时间标记、字数、带舞台指示的口语稿、过渡句和删减段落;文末附问答交接语和排练检查清单。budget.json— 每张幻灯片的预算,可在每次重新计时中重复使用。- 计时报告(由
script_timer.py生成),展示演讲时长符合要求,并列出删减内容及每处删减可节省的秒数。
适配你的学科
默认设置面向计算机科学会议演讲(12–20 分钟、按幻灯片展开、英语)。对于其他领域,请调整大纲中的各部分占比(例如方法内容较多的医学演讲)、语速(--wpm)以及 timing-and-cuts.md 中的场地惯例——这些脚本不受学科限制。
护栏
- 绝不为演讲稿杜撰结果、数字、引言或引用——
讲出的每项论断都必须来自用户的论文。新增参考文献
必须先通过
verify-citations核验。 - 时间只是估算,并非保证:未经实际计时排练,绝不告诉用户演讲 “时间合适”;按字数计算时长会忽略紧张、激光笔使用时的临场发挥和翻页器故障(这正是设置缓冲时间和删减清单的原因)。
- 场地配置绝不能覆盖演讲者的指示或录用邮件中规定的演讲时长;撰写演讲稿前,
必须对照当前的
cfp_url再次核实。 - 保留演讲者的语气和精确的技术论断——口语化改写是为了便于听众理解, 不是简化科学内容,也不是照读论文段落。
- 绝不将演讲稿或幻灯片上传到任何演讲者门户,也绝不代替用户提交任何内容。