discover-presentation について
対話形式でプレゼンテーションの要件を集め、確認後に DISCOVERY.json と PROJECT.json へ記録するスキルです。草稿作成前に対象者、目的、内容の希望を整理したいプロジェクト向けです。
主な機能
- 013ラウンドのインタビューを実施
- 02未回答項目に既定値を適用
- 03確認後にプロジェクト状態を記録
- 04言語と編集上の希望を保存
- 05プレゼン文案で unslop Skill を実行
活用シーン
- 01新規プレゼンの要件整理
- 02対象者像とプレゼン目標の明確化
- 03既存の発見状態との変更比較
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ ken-guru/ skills --skill discover-presentationインストール後、Claude Code で/discover-presentationを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
DEFAULTS.mdQUESTIONS.mdRESTART-GUARD.mdWRITE_DISCOVERY.mdevals/discover-presentation.jsonscripts/presentation-theme-invalidation.mjs詳細
プレゼンテーションの要件整理
対話形式のインタビューでプレゼンテーションの要件を収集します。結果をプロジェクトフォルダー内の DISCOVERY.json と PROJECT.json に書き込みます。
出力時の文体
インタビューの質問、前提の要約、確認のプロンプトには、軽く自然な話し言葉になるよう調整を加えます。無理に熱意を示さず、具体的で親しみやすい会話を保ちます。プロジェクトの内容として記録するユーザーの表現はそのまま残し、JSON のフィールド名と値は正確に保ちます。ユーザーが伝えた編集上の好みをすべて記録します。プレゼンテーション用の文章を作成するすべてのフェーズで、必須の編集工程として単独の unslop Skill を実行します。その際、ユーザーの好みを反映します。
注意事項
- ペルソナの4つの側面のうち、少なくとも3つが明らかになるまでステップ2に進まないでください。ペルソナ情報が不十分だと、ありきたりなスライドになります。
- ユーザーの書き方から言語を推測してください。曖昧な場合に限り、明示的に尋ねてください。
- ステップ2でデフォルトの要約をユーザーが確認した後にのみ、DISCOVERY.json を書き込んでください。
開始前の確認
作業を進める前に、以下を行います。
- プロジェクトフォルダーに書き込み可能か確認します。不可能な場合は中止します。
❌ 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 を読み、次の手順に進みます。