Communitygithub.com

技術発表・プレゼンテーション作成

技術レポートや論文、プロジェクトをトークとスライドに変換し、既存のスライドやトークスクリプトのレビュー、リハーサル、本番、質疑応答の準備を支援します。AsciiDoc(asciidoctor-reveal.js)またはLaTeX Beamerでスライドデッキを作成し、PlantUML図表やスピーカーノートを組み込み、デッキ統計スクリプトでチェックします。

技術発表・プレゼンテーション作成 とは?

このスキルは、技術レポートや論文、プロジェクトの成果を効果的なプレゼンテーション(トークとスライドデッキ)に変換するための包括的な方法論と実装ツールを提供します。レポートを単に読み上げるのではなく、聴衆の興味を引き、記憶に残る新しい発表を創り出すことを重視します。対象プラットフォームは、AsciiDocベースのプロジェクトにはasciidoctor-reveal.js、LaTeX環境にはBeamerであり、どちらでもPlantUMLによる図表作成とスピーカーノートの記述をサポートします。このスキルは、新しいデッキ作成、既存デッキのレビュー、リハーサル・本番・質疑応答の準備の3つのユースケースに対応します。付属のリファレンスファイル(talk-planning.md, slide-design.md, delivery.md)が各フェーズの詳細なガイドラインを提供し、deck_stats.pyスクリプトがスライドの負荷、時間配分、見出しの有無などを自動チェックします。これにより、発表者はスロットに合った、視覚的にも内容的にも洗練されたデッキを効率的に作成できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/larsw/report-writing-skills/tree/HEAD/skills/report-presentation

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

技術プレゼンテーション

トークとは 「レポートの読み上げ」ではなく、新たに創り出すものです。 レポートは頭に届きますが、トークは直感にも響きます。読み手は自分のペースと距離(30~40cm)を選べますが、聴き手は各スライドを数秒間、10m離れた場所から見ながら、同時に聞いています。何ヶ月もの仕事を20分に収めることはできません。トークは、誰もが追いかけられ、記憶に残る、厳選された「鍵穴からのぞく」ようなものを提供します。

方法論は H. Hering(K.-G. Heyne 共著)How to Write Technical and Scientific Reports(第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ページのレポートが、1つの導入質問、3つのサブ項目を持つ1つの主要項目、そして結論になることもあります。

4. スライド

スライドを書き始める前に references/slide-design.md を読んでください。要点:

  • 「少なければ少ないほど良い。」 スライド1枚あたり5~7要素。キーワードであって、文章ではない(最終サマリースライドでは短いステートメントを使用してもよい)。
  • 各見出しは、そのスライドのメッセージを話し言葉で述べる(「統合吸引によりヒュームの90%を除去」)、そして現在の構造項目に明確に対応する。
  • 書く代わりに視覚化する;投影用にレポートの図を再デザインする:要素を減らし、線を太く、ラベルをはるかに大きく。レポートやジャーナルの図をそのまま貼り付けてはいけない。
  • テキストはスライド高さの約1/30(標準スライドで約18pt)以上。サンセリフ体。1枚のスライドで最大2フォントサイズ。色は控えめに、常に意味を持たせて使用する。白地に黒が最も読みやすい。色付きテキストは1.5倍のサイズが必要。
  • すべてのスライドに繰り返される雑多な情報は避ける:トークタイトル、名前、日付、「x / y スライド」カウンター、長いフッター。小さなスライド番号は可。
  • 3つのフレームワークスライド:タイトルスライド;コンテンツキーワード付き構成スライド(「導入/本論/まとめ/ありがとう」ではなく);ディスカッションを促す最終スライド(キーイメージ、連絡先)。「ありがとう」や「質問は?」は言うものであり、表示するものではない。
  • 聴衆の方向性を維持する:トランジション時に現在の項目をハイライトした構成スライドを再表示する。
  • アニメーションは、リストやプロセスの段階的な表示にのみ使用。装飾的な動きや音は使わない。
  • スキップ可能なスライド(予備)は事前にマークする。

5. デッキを構築する(asciidoctor-reveal.js または Beamer)

ユーザーが使用するフォーマットに従います:AsciiDocプロジェクトでは asciidoctor-reveal.js、レポートがLaTeXまたはPDFデッキが必要な場合(不明な場合は尋ねる)はLaTeX Beamer。

  • reveal.js:references/revealjs-asciidoc.md:スライド1枚につき1つの == セクション、すべてのコンテンツスライドに [.notes] スピーカーノート、ビルドには [%step]、スライドサイズのフォントのPlantUML図、構成スライド用のハイライトクラスを持つカスタムCSS。
  • Beamer:references/beamer.md:スライド1枚につきメッセージタイトルを持つ1つの frame、\note{…} スピーカーノート、ビルド用オーバーレイ、構成スライド用 \AtBeginSection + \tableofcontents[currentsection]、ナビゲーション記号と繰り返されるフットラインはオフ。

両方のフォーマットで、スピーカーノートは完全な文章ではなくキーワードで書き、MUST / SHOULD / CAN でタグ付けし(必ず言うべきこと、時間がないときにカットできるもの、予備のもの)、各構造アイテムに「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.

関連スキル