mcpField
W
write-talk-script

write-talk-script

github.com/shaishavmaisuria文档处理5797 次安装4 天前更新
代码仓库

关于 write-talk-script

write-talk-script 为学术演讲者根据幻灯片、论文和确切时长编写逐页讲稿,并提供计时预算与预设删减方案。它还支持计时检查,帮助准备演练和超时应对。

主要功能

  1. 01按幻灯片分配讲稿字数预算
  2. 02根据演讲速度计算累计时间
  3. 03撰写逐页讲稿与过渡语
  4. 04计时检查并定位超时页面
  5. 05标注可删减段落与节省时间

适用场景

  1. 01为会议报告准备定时讲稿
  2. 02将幻灯片转为演练用讲者备注
  3. 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.md
timing-and-cuts.md
scripts/
script_timer.py
word_budget.py

详细介绍

撰写演讲稿

撰写一份符合准确演讲时长的讲稿:按演讲者的实际语速为每张幻灯片分配字数预算,标注累计时间,写出过渡语,并标记可删减内容,这样即使现场超时,也能按预先制定的方案应对。幻灯片告诉观众该看什么;这份讲稿则是演讲者实际要说的话。这是 make-slides 在论文录用后的配套内容。

适用场景

  • “为我的 12 分钟 SIGSPATIAL 演讲写讲稿”/“15 分钟的演讲时段,其中包括 3 分钟问答——我该说什么?”
  • “把我的幻灯片整理成可以用来排练的演讲备注”
  • “我的演讲超时了——该删掉哪些内容?”
  • “我要做一个 5 分钟的闪电演讲/专题演讲”
  • 使用 make-slides 后、首次计时排练前。

输入

  1. 准确的演讲时段:总时长,以及问答是否包含在时段内。以主办方的演讲者说明和录用邮件为准,而不是凭记忆或场地资料。
  2. 幻灯片或大纲(按顺序列出幻灯片标题)。还没有幻灯片?请先运行 make-slides。
  3. 论文(优先使用终稿)——这是口头讲述的所有数字和论断的唯一可靠来源。
  4. 可选:venues/conferences/<venue>-<year>.yml,用于了解会议信息;也可提供演讲者实测的每分钟字数。

流程

  1. 确定场次信息。 询问:总时长、问答环节是否计入、演讲语言,以及主持人是否使用计时牌。如果有场地档案,只将其用作背景参考,并通过实时的 cfp_url / 场地网站再次核实——档案不包含演讲时长信息,而且时长每年都会变化。常见安排如下(务必核实,切勿想当然): 完整论文:12–20 分钟,含问答;CHI 历来约为演讲 10 分钟 + 问答 5 分钟;闪电演讲/重点报告:1–7 分钟。详情见 references/timing-and-cuts.md。

  2. 校准语速。 默认按 130 wpm 计算——这是适合会议演讲的从容语速。如果演讲者能完成 1 分钟朗读校准(timing-and-cuts.md §2),则使用其测得的语速;对于非母语演讲者或技术内容密集的材料,建议使用 110–120 wpm。切勿超过 150。

  3. 创建大纲文件。 每张幻灯片占一行(使用 - 项目符号或 ## 标题),并按幻灯片顺序排列。需要固定时长的幻灯片,在行尾标注 | <minutes>(例如 - 核心观点 | 2)。标题页和总结页通常标注为 0.5。

  4. 计算字数预算。 运行:

    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 会将时长均分。

  5. 逐张幻灯片撰写讲稿, 每张幻灯片都不得超出其字数预算,并采用口语表达——句子简短、使用缩略形式和路标语,数字写成实际说出来的形式。关于文件格式(每张幻灯片使用一个 ## 标题、用 [方括号] 标注舞台指示和时间、每张幻灯片以写明的过渡句结尾)、开场和结尾模式,以及图表讲解,请遵循 references/script-craft.md。每项事实性论述都必须能追溯到论文——引用论文中的数字,再将其改写成适合口头表达的形式。

  6. 计时检查草稿。 运行:

    python3 scripts/script_timer.py talk-script.md --budget budget.json
    

    (或者在没有预算文件时使用 --minutes 15 --qa 3)。对于超时的幻灯片,应通过删减文字解决,而不是打算加快语速;反复运行,直到结果为 WITHIN BUDGET。退出代码:0 表示在预算内,1 表示超时,2 表示输入有误。

  7. 列出删减内容。 用 … 标记 2–3 段可删减内容,总计占演讲内容的 10–15%(每个标记单独占一行,不得嵌套,也不得跨越幻灯片边界)。关于优先删减的内容和绝不能删减的内容,参见 timing-and-cuts.md §6。重新运行 script_timer.py——它会报告每处删减可节省的秒数,以及应用所有删减能否解决超时问题。

  8. 完成排练材料包。 在每个幻灯片部分的顶部插入预算中的时间标记(例如 [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 再次核实。
  • 保留演讲者的语气和精确的技术论断——口语化改写是为了便于听众理解, 不是简化科学内容,也不是照读论文段落。
  • 绝不将演讲稿或幻灯片上传到任何演讲者门户,也绝不代替用户提交任何内容。

评论

支持 Markdown