mcpField
T
technical-presentations

technical-presentations

github.com/melodic-softwareドキュメント2854 回インストール今日更新
リポジトリ

technical-presentations について

開発者向けに、技術トーク、デモ、アーキテクチャレビュー、知識共有、提案プレゼンの準備を支援するスキルです。What-Why-Howの構成を軸に、スライド、時間配分、ライブデモ、質疑応答の指針をまとめています。

主な機能

  1. 01What-Why-Howの構成
  2. 024種類のプレゼン形式
  3. 03スライドデザインの原則
  4. 04ライブデモの準備と復旧
  5. 05質疑応答と進行の指針

活用シーン

  1. 01技術トークの構成作成
  2. 02アーキテクチャレビューの準備
  3. 03製品デモの計画
  4. 04技術提案のプレゼン

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/melodic-software/claude-code-plugins --skill technical-presentations

インストール後、Claude Code で/technical-presentationsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
demo-playbook.md
presentation-checklist.md
slide-design-guide.md

詳細

技術プレゼンテーションスキル

開発者向けに、知識を伝え、説得し、関心を引く魅力的な技術プレゼンテーションを作成します。

キーワード

プレゼンテーション、スライド、講演、デモ、スピーキング、提案、アーキテクチャレビュー、技術トーク、ブラウンバッグ、ライトニングトーク、カンファレンス、ミートアップ、powerpoint、keynote、google slides

このスキルを使う場面

このスキルでは、開発者が次のことを行う際の指針を示します。

  • 技術プレゼンテーションや講演を構成する
  • 開発者向けの効果的なスライドを作成する
  • ライブデモを計画して実施する
  • アーキテクチャに関する決定や提案を説明する
  • ナレッジ共有のセッションを実施する
  • ステークホルダーに技術的なソリューションを提案する

基本フレームワーク:What-Why-How

技術プレゼンテーションはすべて、次の構成に従います。

┌─────────────────────────────────────────────────────────────┐
│  WHAT (10% of time) - The Hook                              │
│  "Here's the problem/opportunity we're addressing"          │
├─────────────────────────────────────────────────────────────┤
│  WHY (30% of time) - The Context                            │
│  "Here's why it matters and why you should care"            │
├─────────────────────────────────────────────────────────────┤
│  HOW (50% of time) - The Solution                           │
│  "Here's how we solve it / how it works"                    │
├─────────────────────────────────────────────────────────────┤
│  CLOSE (10% of time) - The Call to Action                   │
│  "Here's what you should do next / key takeaways"           │
└─────────────────────────────────────────────────────────────┘
WHAT:つかみ(最初の2~3分)

目標: 注意を引き、関連性を明確にします。

手法:

  • 聴衆が認識している問題から始める
  • 驚くような統計や事実を紹介する
  • 挑発的な質問をする
  • 課題を示す短いストーリーを語る

避けること:

  • 「今日は……についてお話しします」
  • 聴衆の関心を引く前にアジェンダのスライドを見せる
  • 定義や背景説明から始める
  • 何かについて謝る
WHY:背景(次の30%の時間)

目標: なぜ重要なのかを説明します。

含める内容:

  • 理解に不可欠な背景
  • 重要性(行動しなかった場合に起こること)
  • 可能性(何が実現できるか)
  • 今取り組む理由(緊急性やタイミング)

聴衆に合わせて調整する:

  • 技術者同士:背景説明を減らし、掘り下げを増やす
  • 混成の聴衆:背景説明を増やし、専門用語を減らす
  • リーダー層:ビジネスへの影響を重視する
HOW:ソリューション(本編-50%)

目標: 内容の要点を伝えます。

構成の選択肢:

  • 時系列(これまでの道のり)
  • 問題 → ソリューション → 検証
  • 例を交えた3つの重要なポイント
  • 変更前 → 変更 → 変更後

技術的な内容の場合:

  • アーキテクチャ図
  • コード例(簡略化したもの)
  • ライブデモ(バックアップを用意)
  • 指標とデータ
締めくくり:行動喚起(最後の10%)

目標: 印象に残し、行動につなげます。

含める内容:

  • 要約(重要なポイントは最大3つ)
  • 明確な次のステップ
  • さらに深く学ぶためのリソース
  • 質疑応答の時間

プレゼンテーションの種類

種類1:アーキテクチャレビュー/RFC

目的: 技術的なアプローチについてフィードバックを得ます。

構成:

  1. 問題提起(2分)
  2. 制約と要件(3分)
  3. 検討した選択肢(5分)
  4. 提案するソリューション(10分)
  5. トレードオフの明示(3分)
  6. 未解決の質問(2分)
  7. 議論(15分以上)

成功の鍵:

  • 資料を事前に共有する
  • 実装の詳細ではなく、決定事項に焦点を当てる
  • あえて行わないことを明確に伝える
  • 厳しい質問に備える
種類2:デモ/ウォークスルー

目的: 仕組みを実演します。

構成:

  1. 解決する問題(2分)
  2. 概要(3分)
  3. ライブデモ(15~20分)
  4. 内部の仕組み(任意、5~10分)
  5. 質疑応答(5~10分)

成功の鍵:

  • 必ずバックアップを用意する(スクリーンショット、動画)
  • 現実的でありながら安全なデータを使用する
  • 作業しながら、何をしているか説明する
  • 失敗した場合に備えてロールバック計画を用意する
種類3:ナレッジ共有/ブラウンバッグ

目的: 役立つ知識を教えます。

構成:

  1. このトピックが重要な理由(3分)
  2. 基本概念(10分)
  3. 実践での応用(10分)
  4. 注意点とヒント(5分)
  5. リソースと質疑応答(5分)

成功の鍵:

  • 聴衆の知識レベルを把握する
  • すぐに活用できる要点を含める
  • フォローアップ用のリソースを提供する
  • 双方向の進行にする
種類4:意思決定を促す提案

目的: 提案への賛同を得ます。

構成:

  1. 問題/機会(3分)
  2. 検討した選択肢(5分)
  3. 推奨案(10分)
  4. 代替案ではなくこの案を選ぶ理由(5分)
  5. リスクの軽減策(3分)
  6. 決定/次のステップの依頼(2分)

成功の鍵:

  • 推奨案を最初に示す(後回しにしない)
  • 反対意見を想定する
  • 主張を裏付けるデータを用意する
  • 何を求めているか明確にする

スライドデザインの原則

ルール
  1. スライドごとにアイデアは1つ - タイトルに「そして」が必要なら、分割します
  2. 箇条書きは5~7語 - スライドは台本ではなく、手がかりです
  3. テキストよりビジュアル - 図、スクリーンショット、コード
  4. デザインに一貫性を持たせる - 同じフォント、色、レイアウト
  5. 後方からでも読めるようにする - 本文は最低24pt
効果的な要素
要素良い例悪い例
タイトル行動を促す、具体的一般的、曖昧
箇条書きキーワードやフレーズ完全な文章
図シンプルで、ラベル付き情報過多、小さなラベル
コード重要な行を強調ファイル全体
データ明確なポイントが1つ複数のグラフ
スライドの種類

タイトルスライド: トピック、氏名、日付、背景情報

アジェンダスライド: 控えめに使い、つかみの後に配置

内容スライド: 1つのポイントとその裏付け

図解スライド: テキストを最小限にしたビジュアル

コードスライド: 構文を強調表示し、重要な行をマーク

まとめスライド: 重要なポイントを3つ

Q&Aスライド: 質問を促す

ライブデモのベストプラクティス

準備
  • 当日の朝にすべてをテストする
  • スクリーンショットや動画のバックアップを用意する
  • 現実的で安全なデータを使う
  • フォントサイズを大きくする(ターミナルでは18pt以上)
  • 通知を無効にする
  • ブラウザーのタブやウィンドウを事前に準備する
  • 復旧プランを用意する
実行
  • 何をしているか説明する
  • 聴衆が追いつけるように間を取る
  • 注目してほしい箇所を示す
  • 問題が起きたときは認める
  • 「窮地を脱する」プランを用意する
問題が起きたとき
  1. 簡潔に状況を伝えます
  2. 簡単な修正を1つ試します(最大30秒)
  3. それでも直らなければ、バックアップに切り替えます
  4. 自信を持って続けます
  5. 過度に謝罪しません

Q&Aへの対応

テクニック

質問を繰り返す: 全員に質問が聞こえるようにし、考える時間も確保できます。

必要に応じて確認する: 「XとYのどちらについての質問ですか?」

良い質問を評価する: 「とても重要なポイントですね……」

知らなくても問題ありません: 「その答えは分かりませんが、調べてお伝えできます。」

必要に応じて後回しにする: 「これはもっと大きなテーマですね。終了後に話し合いましょう。」

自分のメッセージにつなげる: 「それは……というポイントに関連しています。」

難しい質問
種類回答
アプローチへの異議「もっともな懸念です。私たちがどう考えたかをご説明します……」
範囲外の質問「良い質問です。今回取り上げた範囲外なので、終了後に話し合いましょう。」
敵対的な口調落ち着いて、口調ではなく内容に対応する
知識をひけらかす質問「興味深い指摘です。実践的な側面についてお答えします……」
要点がまとまらない質問「質問の内容を正しく理解できているか確認させてください……」

時間配分と進行

時間配分
所要時間内容Q&A
5~10分(ライトニングトーク)8分なし、または2分
20~30分(標準)20~25分5~10分
45~60分(詳細)35~45分10~15分
進行のヒント
  • 力強く始める(冒頭の数分を無駄にしない)
  • 話すときの勢いに変化をつける(単調にならないようにする)
  • 重要なポイントに向けて話を組み立てる
  • 沈黙を効果的に使う
  • 時間どおりに終える(できれば早めに!)
練習の手順
  1. 通読: スライドを声に出して読み、時間を計ります
  2. 口頭練習: スライドを見ずに練習します
  3. 通し練習: 誰かに発表するか、自分を録画します
  4. 思い切って削る: 時間を超える場合は、内容を削ります

参考資料

詳しいガイダンスについては、次を参照してください。

  • references/slide-design-guide.md - スライド作成の包括的なガイダンス
  • references/demo-playbook.md - ライブデモの準備と実施
  • references/presentation-checklist.md - 発表前の準備チェックリスト

関連コマンド

  • /soft-skills:structure-presentation - プレゼンテーションのアウトラインを作成
  • /soft-skills:write-cfp - カンファレンスへの応募書類を作成

避けるべきアンチパターン

  • 「今日は……についてお話しします」から始める
  • スライドをそのまま読み上げる
  • スライドにテキストを詰め込みすぎる
  • バックアップなしでライブデモを行う
  • 時間を超過する
  • 内容について謝罪する
  • Q&Aを省略する
  • 明確な要点がない

バージョン履歴

  • v1.0.0 (2025-12-26): 初回リリース

最終更新

日付: 2025-12-26 モデル: claude-opus-4-5-20251101

コメント