Communitygithub.com

报告演讲与幻灯片制作

将技术报告、论文或项目转化为演讲和幻灯片,审查和润色现有幻灯片或讲稿,并为排练、演讲和问答环节做好准备。支持论文答辩、项目进展报告、会议演讲和3-10分钟的简短陈述。使用 AsciiDoc (asciidoctor-reveal.js) 或 LaTeX Beamer 构建带有讲者备注和 PlantUML 图表的幻灯片,并通过幻灯片统计脚本进行检查。

报告演讲与幻灯片制作 是什么?

该技能旨在帮助用户将技术报告、论文或项目成果转化为高质量的演讲和幻灯片。它基于 H. Hering 的方法论(《How to Write Technical and Scientific Reports》第5章),强调演讲不是报告的复述,而是一个全新的、适合听觉和视觉的创作。该技能支持多种演讲场景,包括论文答辩、项目状态会议、学术会议演讲以及3-10分钟的简短发言。用户可以创建新幻灯片(使用 asciidoctor-reveal.js 或 LaTeX Beamer),审查和润色现有幻灯片或讲稿,并规划排练、演讲和问答环节。其核心功能包括一个详细的框架规划表、演讲结构设计模板、幻灯片设计指南,以及一个统计脚本 (`deck_stats.py`),用于自动检查幻灯片的信息密度、时间分配和常见问题(如幻灯片超载、缺少讲者备注、无效的标题等),确保演讲在给定时间内完美呈现。该技能强调以听众为中心,通过“第三规则”混合不同难度内容,并使用“保留”材料来应对时间不足或问答环节。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/larsw/report-writing-skills/tree/HEAD/skills/report-presentation

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

技术演讲

演讲是一个全新的创作,而不是对报告的口头复述。 报告触及头脑;演讲则直击内心。读者可以自己掌控阅读节奏和距离(30–40厘米);而听众在听讲的同时,只能在几秒钟内从10米外看清每张幻灯片。几个月的工作成果不可能压缩进20分钟的演讲里:演讲提供了一个精心挑选的“钥匙孔”,让每位听众都能跟上并记住要点。

方法遵循 H. Hering(与 K.-G. Heyne 合著)《How to Write Technical and Scientific Reports》第5章(第3版,Springer 2025)。

确定当前的任务类型:

  • 创建 从报告或材料中制作演讲/幻灯片 → 第1–5节
  • 审查 审查现有的幻灯片或讲稿 → 第6节
  • 排练、演讲、回答问题 → references/delivery.md
  • 简短陈述(3–10分钟,通常无需准备幻灯片) → references/delivery.md,"简短陈述"

1. 框架与目标(先写下来)

使用 references/talk-planning.md 中的框架表格,根据用户提供的信息填写;只询问那些会改变演讲内容的问题:

  • 主题和演讲标题(比报告标题更短、更易记,但仍需准确)
  • 听众:谁,先备知识,兴趣,期望,谁有决策权
  • 场合和确切的时间段(不含讨论时间 / 含讨论时间)
  • 类型:讲座(告知)、技术报告(告知与影响)、说服性演讲、偶尔的致辞
  • 带权重的目标,例如 70% 告知结果,20% 展示能力,10% 轻松幽默;及其背后的目的(评分、资金、决策、后续项目)
  • 房间、媒体、远程/混合设置;前一位和后一位演讲者
  • 保密性:在外部演讲前,必须与导师、老板或客户(以及公司市场营销部门)进行明确的信息披露

2. 选择材料

只保留对于该听众和目标而言至关重要、有意义且具有代表性的内容。其余内容放入保留材料(备用幻灯片、“可以”讲的内容),用于应付富余时间或回答问题。删除所有主要是作者自己感兴趣的内容。

3. 创建演讲结构

跳出报告章节的框架,站在听众的立场上考虑。构建少量简短且易于记忆的要点,并辅以戏剧性的编排:

  • 以能制造悬念的内容开场(一个问题、一个带有具体后果的问题、一个引人注目的例子);在结尾回答它。
  • 对于20分钟的演讲,时间分配大致为 约20% 引言 / 约70% 主体 / 约10% 结论(4/14/2分钟)。对于60分钟的演讲,引言和结论的时长比例会小于线性增长(8/48/4)。
  • 针对混合听众的主体部分(第三规则),内容需交错安排,而非严格分块:众所周知的例子和概述(约1/3)→ 在大多数人能跟上的层面提供新见解(约1/6)→ 专家细节(约1/3),并经常返回到一般层面 → 每个人都能理解的总结、结论和评价(约1/6)。不应该让任何听众产生“这些我都知道”或“这个太难了”的想法。
  • 引言:建立联系、演讲目标、流程(结构幻灯片)、划定范围(你不会讲的内容)。
  • 结论:再次强调关键结果、简短展望、没有新内容、明确的结尾。

在结构设计图中记录下来(模板见 references/talk-planning.md),标明每个部分的时间。一份135页的报告可能只需要一个开场问题、一个包含三个子要点的主体部分和一个结论。

4. 幻灯片

在编写幻灯片之前,请阅读 references/slide-design.md。要点如下:

  • "越少越好。" 每张幻灯片5–7个元素;使用关键词,而非句子(最终的总结幻灯片可以使用简短的陈述句)。
  • 每个标题都用口语陈述该幻灯片的信息("集成式抽吸装置可去除90%的烟雾"),并与当前的结构条目清晰对应。
  • 优先可视化,而非文字;为了投影重新设计报告中的图表:减少元素,加粗线条,放大标签。绝不要直接粘贴报告或期刊中的图表。
  • 文字高度不小于幻灯片高度的约1/30(在经典幻灯片上约为18磅);使用无衬线字体;每张幻灯片最多使用两种字号;谨慎使用颜色,且每次使用都应有明确含义;白底黑字最易辨认;彩色文字需要1.5倍的尺寸。
  • 避免每张幻灯片上出现重复的杂乱信息:不要出现演讲标题、姓名、日期、“第x页,共y页”的计数器、过长的页脚。一个小的幻灯片编号是允许的。
  • 三张框架幻灯片:标题幻灯片;包含内容关键词(而不是“引言/主体/总结/谢谢”)的结构幻灯片;邀请讨论的结尾幻灯片(关键图片、联系方式)。“谢谢”和“有问题吗?”是口头说的,而不是显示在幻灯片上的。
  • 保持听众的方向感:在内容过渡时再次显示结构图,并高亮当前条目。
  • 动画仅用于列表或流程的逐步构建;不要使用装饰性的动作或声音。
  • 预先标记可跳过的幻灯片(保留材料)。

5. 构建幻灯片集(使用 asciidoctor-reveal.js 或 Beamer)

使用用户工作的格式:针对 AsciiDoc 项目使用 asciidoctor-reveal.js,当报告使用 LaTeX 或需要 PDF 幻灯片集时使用 LaTeX Beamer(如果不清楚,请询问)。

  • reveal.js:references/revealjs-asciidoc.md:每张幻灯片使用一个 == 节,每个内容幻灯片使用 [.notes] 讲者备注,使用 [%step] 进行逐步构建,使用 PlantUML 图表并设置幻灯片适配的字体大小,自定义 CSS 中为结构幻灯片添加高亮类。
  • Beamer:references/beamer.md:每张幻灯片使用一个带有信息标题的 frame,使用 \note{…} 讲者备注,使用叠加进行逐步构建,使用 \AtBeginSection + \tableofcontents[currentsection] 显示结构幻灯片,关闭导航符号和重复的页脚。

在两种格式中,讲者备注都应写成关键词而非完整文本,并标记为 MUST / SHOULD / CAN(必须说的内容、时间不够时可以删减的内容、作为保留材料的内容),并且在每个结构条目处设置一个 "done by mm:ss" 的检查点。

然后使用脚本进行检查:

python3 scripts/deck_stats.py deck.adoc --minutes 20      # 本技能目录
python3 scripts/deck_stats.py talk.tex --minutes 20       # Beamer:统计 frames、\frametitle、\note、\appendix 后的备用幻灯片

该脚本会列出每张幻灯片的可见字数、元素和备注数量,根据备注估算演讲时间(默认130词/分钟),并标记超载的幻灯片、幻灯片上的完整句子、缺少标题的幻灯片、"谢谢"/"有问题吗?"幻灯片、通用的议程项以及没有备注的幻灯片。调整直到计划时间低于时间段(现场演讲通常会比备注提示的时间更长),并且每个标记要么已修复,要么是经过深思熟虑的选择(例如,一张简短但信息密集的专家幻灯片可以是有意为之)。

交付物:幻灯片文件(及自定义CSS)、框架表格和结构设计图、时间表以及保留幻灯片列表。建议进行一次完整计时的、有听众的试讲(参见 references/delivery.md)。

6. 审查现有幻灯片或讲稿

  1. 获取框架信息:听众、时间段、目标。没有这些信息,对幻灯片的反馈只是猜测。
  2. 运行 deck_stats.py(针对 AsciiDoc 或 Beamer 幻灯片集)或提取幻灯片文本(.pptx/PDF)并通过阅读进行同样的计数。
  3. 从整体上检查演讲:它是一个全新的创作,还是报告目录的幻灯片版?是否有悬念开场和已回答的问题?是否符合20/70/10的时间分配?是否遵循了第三规则混合(幻灯片对专家来说太肤浅,或对其他人来说术语太多?)。是否理论在前、例子在后(常见错误)?中间是否有分节总结?是否有保留材料?是否有明确的结尾?
  4. 根据 references/slide-design.md 检查每张幻灯片。
  5. 按严重程度报告(严重:不符合时间段、听众水平错误、没有信息;重大:幻灯片超载或不可读、报告图表未修改、缺少结构指引;次要:风格细节)。对于每个发现问题的幻灯片,给出幻灯片编号/标题以及具体的修改建议(新的标题、删减的列表、重新设计的图表描述)。如果需要对话语的演讲进行评分式评估,请使用 references/delivery.md 中的评审表格。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

report-copyedit

Copyedit and line-edit technical and scientific writing (reports, theses, lab reports, papers, specifications, design docs, technical documentation) for clarity, precision, consistent terminology and correct notation, without changing the technical content. Use this whenever someone asks to copyedit, proofread, line-edit, tighten, simplify, polish the language of, improve the readability or flow of, or "fix the English in" a technical text, AsciiDoc, LaTeX or Markdown file; to make terms, units, abbreviations, hyphenation or capitalization consistent; or to build a style sheet from an existing draft. For a whole-document pre-submission review (structure, figures, references, checklist) use report-review instead.

report-drafting

Draft the content of technical and scientific reports - introduction, state of the art, methods/test setup, results, discussion, summary/conclusions, abstract, appendices - together with their figures, tables, PlantUML diagrams, charts, formulas, computations and citations, in AsciiDoc, LaTeX or plain prose. Use this whenever someone asks to write, draft, expand, or turn notes, data, measurements, code or bullet points into a section of a report, thesis, lab report, design report, project report or technical documentation; to create or improve a figure, diagram, chart, caption, table or evaluation/decision matrix for one; to set up equations or a load calculation; or to add citations and a reference list - even if they just say "write up these results".

report-outline

Plan a technical or scientific report before and while drafting it - analyze the assignment, write and test title variants, condense the core message into one sentence, grow a 4-point then 10-point then detailed outline, pick a structure pattern for the report type (lab/test report, design report, project report, thesis, manual, research paper), and set up a style sheet and an AsciiDoc or LaTeX skeleton. Use this whenever someone is starting or reorganizing a report, thesis, lab report, design report, project report or technical documentation and asks for an outline, structure, table of contents, chapter plan, section order, working title or title ideas, or asks "how should I organize this?" - and also to check an existing outline or ToC for logic (lone subsections, unequal siblings, vague headings).

report-review

Review a technical or scientific report, thesis, lab report, design report or technical document as a whole before submission or release - structure and logic, completeness, clarity for a reader without project knowledge, figures and tables, citations and reference list, formulas and notation, terminology consistency, cross-references, open TODO markers and output quality - using a mechanical AsciiDoc/LaTeX linter plus a checklist, and produce a prioritized findings report with concrete fixes. Use this whenever someone asks to review, check, audit, assess, give feedback on, "look over", or do a final/pre-submission/QA pass on a report or thesis (AsciiDoc, LaTeX, Markdown, PDF or Word), asks "is this ready to hand in?", or wants supervisor-style feedback on a draft chapter.

相关技能