mcpField
C
create-lecture

create-lecture

github.com/pedrohcgsドキュメント1.7k66 回インストール4 週間前に更新
リポジトリ

create-lecture について

Beamer 講義の企画と作成を共同で進めるスキルです。承認済みのバッチごとに作業し、記法、教育設計、品質確認を工程に組み込みます。

主な機能

  1. 01事前の資料・記法確認
  2. 02講義構成の承認段階
  3. 035~10枚単位でのスライド作成
  4. 04記法と引用の確認
  5. 05コンパイルと品質レビュー

活用シーン

  1. 01初回講義と初期ナレッジベースの作成
  2. 02提供された論文から講義構成を作成
  3. 03講師のフィードバックを受けてスライドを作成
  4. 04完成した講義資料の確認と仕上げ

インストール

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

$npx skills add https://github.com/pedrohcgs/claude-code-my-workflow --skill create-lecture

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

詳細

講義作成ワークフロー

教育的に優れた、美しい Beamer 講義スライドを作成します。

これは、協力しながら反復して進めるプロセスです。講師がビジョンを示し、Claude が思考のパートナーを務めます。


制約(必須)

  1. まずナレッジベースを読む — 表記レジストリ、ナラティブの流れ、アプリケーションデータベース
  2. 新しい記号はすべて、表記レジストリと照合する
  3. 形式化の前に動機づけを行う — 例外なし
  4. すべての定義から2枚以内に、具体例を示す
  5. 色付きのボックスは1枚につき最大2つ
  6. \pause やオーバーレイコマンドは使用しない(プロジェクトのルールを確認する)
  7. 主要な概念の転換点にはトランジションスライドを入れる
  8. 少なくとも1つの実証的なアプリケーションを全体を通じて扱う
  9. すべての引用を参考文献と照合する
  10. 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/ 内の過去の講義がない場合)、そこで作業を止めて待たないでください。代わりに、次の手順を実行します。

  1. テンプレートが空であり、コースの初回講義を作成していることを伝えます。
  2. ユーザーのトピックに基づいて、最小限のスターターナレッジベースを提案します。規則を含む主要な記号を5~8個、継続して扱うアプリケーションを1~2個、簡潔なナラティブの流れ(導入 → 主なアイデア → 含意)を提示し、承認を得ます。
  3. 承認されたひな形をナレッジベーステンプレートに書き込み、以降の講義で引き継げるようにします。
  4. フェーズ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

相互参照

コメント