create-lecture について
Beamer 講義の企画と作成を共同で進めるスキルです。承認済みのバッチごとに作業し、記法、教育設計、品質確認を工程に組み込みます。
主な機能
- 01事前の資料・記法確認
- 02講義構成の承認段階
- 035~10枚単位でのスライド作成
- 04記法と引用の確認
- 05コンパイルと品質レビュー
活用シーン
- 01初回講義と初期ナレッジベースの作成
- 02提供された論文から講義構成を作成
- 03講師のフィードバックを受けてスライドを作成
- 04完成した講義資料の確認と仕上げ
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ pedrohcgs/ claude-code-my-workflow --skill create-lectureインストール後、Claude Code で/create-lectureを入力して読み込まれたか確認します。
詳細
講義作成ワークフロー
教育的に優れた、美しい Beamer 講義スライドを作成します。
これは、協力しながら反復して進めるプロセスです。講師がビジョンを示し、Claude が思考のパートナーを務めます。
制約(必須)
- まずナレッジベースを読む — 表記レジストリ、ナラティブの流れ、アプリケーションデータベース
- 新しい記号はすべて、表記レジストリと照合する
- 形式化の前に動機づけを行う — 例外なし
- すべての定義から2枚以内に、具体例を示す
- 色付きのボックスは1枚につき最大2つ
\pauseやオーバーレイコマンドは使用しない(プロジェクトのルールを確認する)- 主要な概念の転換点にはトランジションスライドを入れる
- 少なくとも1つの実証的なアプリケーションを全体を通じて扱う
- すべての引用を参考文献と照合する
- 5~10枚ずつ作業する — まとめて大量に出さず、フィードバックをもらう
ワークフロー
フェーズ0:インテークとコンテキスト(事前確認レポート必須)
入力を読み、フェーズ1を始める前に、回答内で事前確認レポートを作成してください。
読む入力:
.claude/rules/knowledge-base-template.md— 表記レジストリ、ナラティブの流れ、アプリケーション.claude/rules/content-invariants.md— INV-1~INV-8 はスライドの内容を規定します- ユーザーが提供したソース論文や既存のスライド
- 前回の講義の
.tex(最後のセクションと終了スライド)。存在する場合
必須の事前確認レポートブロック:
## Pre-Flight Report
**Sources read:**
- [source 1]: [one-line takeaway — what notation, what result, what diagram]
- [source 2]: ...
**Notation registry check:**
- New symbols this lecture will introduce: [list]
- Symbols reused from prior lectures: [list, with the lecture each was introduced in]
- Conflicts detected: [none / specific clashes]
**Narrative position:** [Where does this lecture sit in the course arc? What did the previous lecture end on? What does the next lecture need you to set up?]
**Pedagogical goal:** [one sentence]
**Running application:** [which real-world example threads through this deck]
教育上の目標を示し、ユーザーの確認を得てからフェーズ1に進みます。
初回講義の場合のフォールバック(新規フォークで、ナレッジベースが空の場合)。 .claude/rules/knowledge-base-template.md に未記入のプレースホルダーテーブルが残っている場合(表記レジストリの項目、アプリケーション、Slides/ 内の過去の講義がない場合)、そこで作業を止めて待たないでください。代わりに、次の手順を実行します。
- テンプレートが空であり、コースの初回講義を作成していることを伝えます。
- ユーザーのトピックに基づいて、最小限のスターターナレッジベースを提案します。規則を含む主要な記号を5~8個、継続して扱うアプリケーションを1~2個、簡潔なナラティブの流れ(導入 → 主なアイデア → 含意)を提示し、承認を得ます。
- 承認されたひな形をナレッジベーステンプレートに書き込み、以降の講義で引き継げるようにします。
- フェーズ1に進みます。
これにより、新たにフォークするたびに /create-lecture が行き詰まるのを防ぎます。
フェーズ1:論文の分析(論文が提供された場合)
- 内容を分割し、重要なアイデアを抽出する
- 論文の表記をコースの表記に対応づける
- スライドに適した内容を特定する
- 承認を得るために要約を提示する
フェーズ2:構成案の提案
- アウトライン(5幕構成または3部構成のテンプレート)を提案する
- 必要な TikZ 図と R の図を列挙する
- 新たに導入する表記を列挙する
- ゲート:フェーズ3の前にユーザーの承認を得る
フェーズ3:スライドの草稿作成(反復)
- 5~10枚ずつ作業する
- 表記を確認し、作成パターンを適用する
- 草稿作成中に品質チェックを行う
フェーズ4:図とコード
- 規約に従って R スクリプトを作成する
- Beamer ソース内に TikZ 図を作成する(信頼できる唯一の情報源)
- 今後の Quarto との統合に備えて RDS を保存する
フェーズ5:仕上げとコンパイル
- 3パスで全体をコンパイルする
- Devil's Advocate を実行する
- Substance Review を実行する(分野のレビュアーが設定されている場合)
- 新しい表記でナレッジベースを更新する
作成後のチェックリスト
[ ] Lecture compiles without errors
[ ] No overfull hbox > 10pt
[ ] All citations resolve
[ ] Every definition has motivation + worked example
[ ] Max 2 colored boxes per slide
[ ] 2-3 Socratic questions embedded
[ ] Transition slides between sections
[ ] At least 1 running application threaded throughout
[ ] New notation added to knowledge base
[ ] Session log updated
[ ] Devil's Advocate run
相互参照
.claude/skills/translate-to-quarto/SKILL.md— 完成した Beamer スライドを Quarto RevealJS ミラーに移植します。.claude/skills/qa-quarto/SKILL.md— Beamer と Quarto の同等性を厳密に確認します(差異がなくなるまで繰り返します)。.claude/skills/deploy/SKILL.md— 講義をレンダリングし、GitHub Pages に公開します。.claude/skills/scaffold-exercises/SKILL.md— 講義に添える問題セットと解答を作成します。
コメント
Markdown 対応