mcpField
D
discover-presentation

discover-presentation

github.com/ken-guruドキュメント184 回インストール1 週間前に更新
リポジトリ

discover-presentation について

対話形式でプレゼンテーションの要件を集め、確認後に DISCOVERY.json と PROJECT.json へ記録するスキルです。草稿作成前に対象者、目的、内容の希望を整理したいプロジェクト向けです。

主な機能

  1. 013ラウンドのインタビューを実施
  2. 02未回答項目に既定値を適用
  3. 03確認後にプロジェクト状態を記録
  4. 04言語と編集上の希望を保存
  5. 05プレゼン文案で unslop Skill を実行

活用シーン

  1. 01新規プレゼンの要件整理
  2. 02対象者像とプレゼン目標の明確化
  3. 03既存の発見状態との変更比較

インストール

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

$npx skills add https://github.com/ken-guru/skills --skill discover-presentation

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

同梱ファイル

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

DEFAULTS.md
QUESTIONS.md
RESTART-GUARD.md
WRITE_DISCOVERY.md
evals/
discover-presentation.json
scripts/
presentation-theme-invalidation.mjs

詳細

プレゼンテーションの要件整理

対話形式のインタビューでプレゼンテーションの要件を収集します。結果をプロジェクトフォルダー内の DISCOVERY.json と PROJECT.json に書き込みます。

出力時の文体

インタビューの質問、前提の要約、確認のプロンプトには、軽く自然な話し言葉になるよう調整を加えます。無理に熱意を示さず、具体的で親しみやすい会話を保ちます。プロジェクトの内容として記録するユーザーの表現はそのまま残し、JSON のフィールド名と値は正確に保ちます。ユーザーが伝えた編集上の好みをすべて記録します。プレゼンテーション用の文章を作成するすべてのフェーズで、必須の編集工程として単独の unslop Skill を実行します。その際、ユーザーの好みを反映します。

注意事項

  • ペルソナの4つの側面のうち、少なくとも3つが明らかになるまでステップ2に進まないでください。ペルソナ情報が不十分だと、ありきたりなスライドになります。
  • ユーザーの書き方から言語を推測してください。曖昧な場合に限り、明示的に尋ねてください。
  • ステップ2でデフォルトの要約をユーザーが確認した後にのみ、DISCOVERY.json を書き込んでください。

開始前の確認

作業を進める前に、以下を行います。

  1. プロジェクトフォルダーに書き込み可能か確認します。不可能な場合は中止します。 ❌ Cannot write to <path>.

すでに DISCOVERY.json が存在する場合は、読み込んで変更比較用に保持します。まだ何も削除しないでください。

手順

ステップ1:インタビュー

QUESTIONS.md にある質問を、3つのラウンドに分けて、各ラウンドにつき1メッセージずつ尋ねます。自由回答から構造化データを抽出します。部分的な回答も受け入れ、残りは DEFAULTS.md のデフォルトで補います。

言語の判定: ユーザーの書き方からプレゼンテーションの言語を推測します。ノルウェー語で書かれている場合は、デフォルトでノルウェー語ブークモールを使用します。英語またはその他の言語で書かれている場合は、その言語を使用します。判定した言語は DISCOVERY.json に記録し、その後のすべてのフェーズで遵守する必要があります。生成するすべてのコンテンツ(スライド、発表者ノート、用語集)は、その言語で作成してください。

ステップ2に進む前に、ペルソナの詳細を確認します。ペルソナの4つの詳細項目(経験レベル、目標、懸念事項、得られること)のうち、少なくとも3つが明らかになっていれば、十分な情報があるとみなします。

ステップ2:デフォルトを確認

ファイルを書き込む前に、確認事項を一度にまとめて提示します。

📋 Default assumptions — correct anything that doesn’t fit:

- Topic: [topic]
- Audience: [audience]
  - Experience level: [experience_level]
  - Goal: [goal — implement / understand]
  - Concerns: [top_concerns]
  - Top 3 takeaways: [top_takeaways]
- Duration: [duration]
- Occasion: [occasion]
- Language: [language]
- Presentation style: [narrative structure from DEFAULTS.md]
- Presentation Theme: [Editorial / Signal / Field Notes] ([identifier])
- Editorial preferences: [tone, preferred styles, and styles to avoid — or none]
- External Font Override: [exact family or none]
- Pagination: Yes
- Max bullet points per slide: 5–6
- Visual preference: [Picture / Diagram / None]

ファイル名とフォルダー名も確認します。

ファイル/フォルダーデフォルト
アジェンダAGENDA.md
プレゼンテーションPRESENTASJON.md
画像images/
動画videos/
ドキュメントdocs/
ソースdocs/sources/
テーマthemes/

次のように尋ねます。「デフォルトの名前を使用しますか。それとも変更しますか?」

ステップ3に進む前に、ユーザーの承認または修正を待ちます。

以前の Discovery の状態がある場合は、ここで確定した値と比較します。実際の差分に基づき、RESTART-GUARD.md に従って、テーマのみ、フォントのみ、または全般のいずれかの手順を選択して実行します。新しい状態を書き込む前に、ガード処理を完了してください。

ステップ3:状態ファイルを書き込む

ステップ2でユーザーがデフォルトを確認した後に限り、外部ポインターファイル WRITE_DISCOVERY.md を読み、次の手順に進みます。

コメント