steffen74/to-slides

スライドへ

1ユニット分のスライドを構築します。COURSE-CANVAS.md、RESOURCES.md、DECISIONS.md、AGENTS.md の ## Agentic course creation セクション、およびユニットの承認済みセッションプランと参加者ページを読み込みます。スライドは計画から構築され、その逆はありません。セッションプランがまだ承認されていない場合は、停止して /draft-unit を提案します。

1. 形式を一度決める

形式は通常 /setup-course で決定されます。AGENTS.md に Slides: 行がない場合は、既存のもの（以前のデッキ、ブロック5のツール）から推奨事項を添えて質問します：

• 形式とツール：例：claude.ai Slidesアーティファクト、.pptx、Googleスライド、Markdownスライド（Marp、reveal.js）

• デッキの保存場所と閲覧者：クラス内でのみ表示、または参加者に公開。公開されたデッキは参加者資料です。

• テンプレート：既存のデッキやデザインシステムのルック＆フィールに従うもの。

• アウトラインの保存場所：セッションプランの隣のプライベートフォルダを推奨（例：slides/<unit>-outline.md）。アウトラインにはサンプル解答が含まれるためです。

回答を - Slides: <形式>, <デッキの場所>, <アウトラインの場所>, <参加者に公開: yes|no>, テンプレート <リンク> として AGENTS.md に書き、DECISIONS.md に記録します。

2. 計画からアウトラインを作成する

スライドよりも先にアウトラインをファイルに書き込みます。タイミング表（計画の時間、スライド数とブロックごとのスライドあたりの時間）を作成し、セッションプランの各ブロックを順に1エントリずつ記述します：

• オープニング：カバースライドと、計画のブロックと時間をリストしたアジェンダスライド（計画にリストがなくても）。

• インプットブロック：時間に応じたセクションサイズ（目安として、2〜3分に1つのコンテンツスライド）。各スライドが主張する内容とその出典（セッションプラン、サンプル解答、キャンバス、参加者ページ）をリストします。数値は計画のサンプル解答から取得するか、再度計算します。決して作成しません。計画にキーワード（「尺度の種類」）しかない場合、自分の知識で補完せず、スライドを「計画に内容が不足している」とマークし、決定事項とします。

• グループワーク：タスクスライド1枚。参加者ページと同じ文言のタスク、時間枠、期待される結果、作業場所（リポジトリ、データ、開始ノートブック）、提出先を記載します。learner-instructions を読み込みます。参加者ページにタスクが含まれていない場合（セッション内タスクはセッションプランにのみ存在することが多い）、計画の文言を使用し、その旨をフラグします。その場合、スライドが学習者がタスクを確認する唯一の場所となり、デッキが公開されなくても参加者資料となります。複数の解釈が可能なタスク（例：「平均」を日数で取るか行で取るか）はすべて決定事項としてフラグします。

• プレナリー：質問またはフィードバックの基準を示すスライド1枚。会場で生成されるコンテンツ（グループの回答、チャート）には、ライブで記入するための空のフレームを用意します。

• ビデオチェック：RESOURCES.md のクイズリンク（形式が許せばQRコードも）。質問は含めず、回答と説明はスピーカーノートのみに記載します。ユニットにクイズがない場合は、先に /to-quiz を提案します。

• 休憩、アウトルック：各1スライド。アウトルックでは、参加者ページの文言で宿題を繰り返します。

学習者がタスクに取り組む前にサンプル解答が明らかになるスライドはすべてマークします。これらはタスクスライドの後、非表示スライドまたはバックアップスライドとして配置するか、公開デッキから除外します。

アウトラインの最後に、必要な決定事項（過負荷ブロック、不足コンテンツ、あいまいなタスク、デッキを公開するかどうか）を、それぞれ選択肢と推奨事項とともに記載します。また、course-checks からアウトラインに対して実行できるスライドチェックの結果も記載します。これを表示し、インストラクターの入力を待ちます。これが停止ポイントです。内容の編集はまずセッションプランに行い、次にアウトラインに反映します。

3. 構築する

決定された形式とテンプレートでデッキを構築します：

• すべてのスライドに、その要点を述べるタイトル（「ほとんどの予測誤差は祝日に発生する」）を付けます。トピック（「結果」）ではありません。
• テキストは最小限に。インストラクターが話す内容はセッションプランから引用してスピーカーノートに記載します。
• すべてのリンク、リポジトリ名、コマンド、期限は、RESOURCES.md の信頼できる情報源と完全に一致させます。
• ライブデモには、デモが失敗した場合に備えてフォールバックスライド（スクリーンショットまたは期待される出力）を用意します。

4. チェックして引き渡す

course-checks からスライドチェック（計画および参加者ページとの整合性、タイミング、早期のサンプル解答表示の有無、リンク）を実行します。失敗したものを修正し、自信がないスライドのリストとともにデッキを表示します。

デッキは鏡です：セッションプランと参加者ページの事実（そのギャップを含む）を繰り返します。各デッキを RESOURCES.md のそれらの事実のミラーとして追加します。これにより、ページへの修正がそれを繰り返すデッキにも反映されます。

デッキが参加者に公開される場合、承認されたデッキをハンドブックに公開します：PDFとしてエクスポートします（スライドツールが手動でしかエクスポートできない場合は、インストラクターにエクスポートを依頼し、正確な保存場所を指示します）。ユニットにちなんだ名前を付け（例：week-02-slides.pdf）、AGENTS.md からハンドブックのアセットパスに配置し、エクスポートからスピーカーノートと非表示の回答スライドを削除し、ユニットの参加者ページの資料セクションからリンクします。後でデッキに変更が生じた場合は、新しいエクスポートが必要です。ハンドブック内のPDFはデッキのミラーです。

インストラクターがデッキを承認し、RESOURCES.md にユニットのステータス draft でリストされ、その場所がセッションプランからリンクされ、公開する場合はPDFがユニットの参加者ページからリンクされたら完了です。デッキが参加者に公開される場合は、次に /walk-through <unit> を提案します。そうでない場合は /review-unit <unit> を提案します。