Communitygithub.com

報告轉簡報

將技術報告、論文或專案轉變為口頭報告與投影片,審閱並潤飾現有簡報或講稿,並準備排練、發表與問答環節——包含論文答辯、專案進度報告、會議演講以及3-10分鐘的簡短陳述。支援以 asciidoctor-reveal.js (AsciiDoc) 或 LaTeX Beamer 建立含 PlantUML 圖表與講者備忘錄的投影片組,並透過投影片統計腳本進行檢查。當有人要求從報告或結果製作投影片、簡報或口頭報告,或要審閱、評論、改善投影片或講者備忘錄,或要將演講控制在 N 分鐘內,或要規劃答辯或進度更新,或要準備會後問答時,請使用此技能。

報告轉簡報 是什麼?

此技能專門用於將技術報告、論文或專案成果轉化為高品質的口頭簡報。它基於 H. Hering 與 K.-G. Heyne 所著的《如何撰寫技術與科學報告》第5章的方法論,強調「演講是全新的創作,而非報告的有聲朗讀」。技能涵蓋從框架設定、材料篩選、結構設計、投影片製作到最終簡報生成的完整流程,支援兩種主流格式:asidoctor-reveal.js (AsciiDoc) 和 LaTeX Beamer。此外,還提供現有簡報的審查功能,並包含排練、發表與問答的實用參考文件。其核心價值在於幫助使用者從觀眾視角出發,透過「窺鑰匙孔」的精心選擇,在有限的時間內傳達關鍵訊息,並確保內容兼具深度與可理解性。

相容平台~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 合著)《如何撰寫技術與科學報告》第 3 版(Springer 2025)第 5 章。

請判斷這是哪一項工作:

  • 創作:從報告或素材建立演講/投影片組 → 第 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 pt);使用無襯線字型;每張投影片最多使用兩種字型大小;節制使用顏色,且顏色必須有意義;黑底白字最清晰;彩色文字需要 1.5 倍的大小。
  • 避免每張投影片都重複的雜亂資訊:例如演講標題、姓名、日期、「第 x 頁,共 y 頁」計數器、長頁尾。一個小小的投影片編號是可以的。
  • 三張框架投影片:標題投影片;包含內容關鍵字的結構投影片(非「引言 / 主體 / 總結 / 謝謝」);以及一張鼓勵討論的最終投影片(關鍵影像、聯絡資訊)。「謝謝」和「有問題嗎?」是用說的,而不是用秀的。
  • 讓聽眾掌握方向:在轉換處再次顯示結構,並強調當前項目。
  • 動畫僅用於逐步建構清單或流程;禁止裝飾性的移動或音效。
  • 預先標記可跳過的投影片(儲備區)。

5. 建立投影片組(asidoctor-reveal.js 或 Beamer)

使用使用者慣用的格式:AsciiDoc 專案使用 asidoctor-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:影格、\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.

相關技能