mcpField
K
k2f-conference-handout

k2f-conference-handout

github.com/suzhengドキュメント3754 回インストール2 週間前に更新
リポジトリ

k2f-conference-handout について

会議発表を参加者向け配布資料の設計図にまとめるエージェント向けスキルです。内容構成とデザイン意図を定め、K2Fでの制作につなげます。

主な機能

  1. 01発表から配布資料の設計図を作成
  2. 02参加者向けの4層構成
  3. 03ライブデモの静的な代替案
  4. 04編集・デザインの品質チェック

活用シーン

  1. 01会議発表の印刷用資料の準備
  2. 02発表内容を参加者向け資料に要約
  3. 03ライブデモの静的な代替内容を記述

インストール

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

$npx skills add https://github.com/suzheng/k2f --skill k2f-conference-handout

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

詳細

K2F Conference Handout — AI-Native Aesthetic Design

目的

参加者向けの参照資料となる content_and_design.md の作成方法をエージェントに教えます。講演から何を残すか、紙または PDF で読みやすいようにどう階層化するか、デザインの意図(トーン、階層、情報密度)をどう表現するかを扱います。K2F パッケージの構築やエクスポート方法は扱いません。

K2F の上に構築

このスキルは、カンファレンス配布資料を .K2F パッケージとして作成します。作成時には k2f スキルに従い、ワークスペースを展開または初期化し、セマンティックツリーを編集して、パッケージ化・検証・エクスポートを行います。K2F では、エージェントはピクセル座標ではなく、意味(セクション、要点、図)に集中できます。エンジンがレイアウト、タイポグラフィ、テーマをコンパイルし、PDF やその他の形式で一貫した出力を生成します。

作成を始める前に、コアスキルをインストールしてください:npx skills add suzheng/k2f --skill k2f。

使用するタイミング

  • 講演の概要ができた後、または採択された後。スライドの作成前でも後でも構いません。
  • CFP でも、スライド全体のエクスポートでも、登壇者用ノートでもなく、ユーザーが参加者の手元に残るものを求めているとき。
  • ワークショップ、ミートアップ、カンファレンスのセッションで、印刷または PDF を配布するとき。

ワークフロー

ステップ 1. content_and_design.md を生成する

セマンティックコンテンツと美的意図を組み合わせた設計図を作成します。後から k2f スキルがページに割り当てられるよう、ラベル付きのブロックを使用します。

サブステップ

  1. セッションの確定 — イベント、セッションタイトル、持ち時間、対象者の役割と状況(「開発者」ではなく具体的に)、ベンダー中立かベンダー主催のトーンか、製品名を使用してよいかを記載します。配布資料の目的も明記します。マーケティングではなく、講演後に参照できる資料です。

  2. 情報の骨格 — 講演の流れに沿って、各項目の所要時間の目安を 2 段階で記載します。それぞれの要点に 残す、圧縮する、または 削除する の印を付けます。配布資料が反映するのはスライドの枚数ではなく、講演の展開です。

  3. 参加者向けの階層 — コンテンツを次の 4 層で構成します。

    • ざっと見る(10 秒):タイトル、登壇者、イベント/日付、必要に応じて QR コードまたは URL。
    • 素早く確認する(1 分):持ち時間に合わせて調整した、動詞から始まる要点を 2~4 個(ライトニングトーク:アイデア 1 つ、要点 1 つ。標準:課題 1 つ、アクション 2~3 個)。
    • 読む(5~10 分):情報の骨格に沿った短縮版のセクション。導入、図、表、会場でリアルタイムに把握しきれなかったコードなど。
    • 後で参照する:リンク、リポジトリ、参考資料、前提条件、連絡先。短くまとめ、ユーザーから提供された情報を使用します。
  4. 段階的な展開 — ライブ講演で段階的な公開やデモを行った場合は、デザイン文書に静的な代替表現を指定します(番号付きの手順、変更前後の比較、スクリーンショットの説明、最終的なコードの状態など)。アニメーションがないと意味が通じないセクションを残してはいけません。

  5. 削減の見直し — 宣伝が先行する導入、書籍並みの範囲、登壇者の歩みを中心にした構成、「理解する/評価する」といった箇条書きを削除します。参加者の視点に立った文と、月曜日から実行できるアクションに置き換えます。

  6. デザインの意図 — エンジン向けに、トーン、階層、情報密度、配色を記録します(JSON は使用しません)。

    • トーン:参加者向け。課題 → アプローチ → 成果の順に構成し、登壇者が出典を示せる根拠や数値を使用します。
    • 階層:要点とセクションタイトルでストーリーを伝え、本文で補足します。脚注やリンクは控えめにします。
    • 情報密度:スライドより情報量を増やし、論文よりは余白を残します。長い段落より箇条書きやコールアウトを優先し、ユーザーが上限を指定していない場合は約 800~1,200 語に収めます。
    • 配色:落ち着いたプロフェッショナルなベースカラーに、要点や警告用のアクセントカラーを 1 色加えます。印刷時に十分なコントラストを確保し、コードや図は全幅またはインラインで配置することを明示します。

ルールと制約

  • 配布資料 1 つにつき切り口は 1 つ:課題と全体を貫く筋道を 1 つに絞ります。複数のトピックを扱う講演は、別々の配布資料に分けます。
  • 要点の確認:すべての要点は動詞から始まり、持ち時間に見合うものでなければなりません。25 分の講演に要点が 8 つある場合は不合格です。
  • 参加者の視点で書く:「私たちの歩みを紹介します」を、読者が得られるものを伝える表現に書き換えます。
  • 正確性の確認:ベンチマーク、顧客、引用を捏造してはいけません。講演で触れられなかった情報の不足は明記します。
  • 静的アセットのみ:動画、iframe、ライブデモは、設計図内でスクリーンショット、手順、またはリポジトリへのリンクに置き換えます。

よくある失敗例

失敗例修正方法
スライドの内容をそのまま掲載背骨となるラベルを残し、タイトルだけのスライドは削除して、価値の高い要点だけを展開します。
発表者ノートを貼り付ける「ファシリテーター」向けの任意資料として分け、既定のドキュメントは参加者専用にします。
段階的に表示される内容が不足している段階的に展開する各要点について、最終状態の図、コード、または番号付きリストを追加します。
隠れた売り込み問題から始め、製品は話題の設定として扱い、見出しにはしません。
どこにでもあるタイトル発表の内容から、システム、規模、または緊張感を加えます。
コードの羅列代表的なスニペットを1つだけ載せてリンクを添え、重要な行に注釈を付けます。
抽象的な持ち帰り事項動詞+対象+文脈にします(「リージョン間レプリケーションを有効にする前に、送信トラフィックを監査する」)。

品質チェックリスト

  • セッションの範囲と対象者が明確で、トーンがイベントの種類に合っている。
  • 背骨を「残す/圧縮する/削除する」に分類し、明確な切り口を1つ定めている。
  • 動詞から始まる持ち帰り事項が2~4個あり、持ち時間に合っている。
  • ライブでしか見られない要点すべてについて、静的な代替手段を記載している。
  • 売り込み優先や登壇者中心の導入がなく、出典付きの数値または具体的なシステムを1つ以上含んでいる。
  • 文字数の目安が明記され、リンクと前提条件は「後で」レイヤーにある。
  • デザインの意図に、トーン、階層、密度、配色が含まれている。
  • すべての主張の出典を、ユーザーが提供した資料までたどれる。
ステップ 2. content_and_design.md と k2f スキルを使って K2F ファイルを生成し、適切なファイル形式でエクスポートします。

k2f に従ってブループリントからページを作成し、デザインの意図に基づく役割を適用して検証したうえで、参加者向けの配布資料をエクスポートします(通常は印刷または共有用の PDF)。

コメント