レッスンを作成する - 概要¶

Adaptive Learner はコンテンツによって成り立っています。独自のレッスンを作成 - アプリ内で直接、またはコンテンツリポジトリ形式のファイルとして - し、コミュニティと共有できます。このページは概要を示します。詳しい形式の詳細はリンク先の資料にあります。

レッスンを作成する 2 つの方法¶

1. アプリ内：レッスンクリエイター¶

/create-lesson にあるレッスンクリエイターは 4 ステップのアシスタント（メタデータ → カードエディタ → 演習エディタ → 保存／共有）で、AI キーは不要です。

カードをドラッグ＆ドロップで並べ替えるか、CSV からインポート。カードにはアップロードした画像を付けられます。
メタデータのステップでは知識ドメインを選べます（例：言語、プログラミング、心理学、犬のトレーニング、交通知識）。
カードから演習を自動生成するか、ステップ 3 で完全に自分で編集できます。すべてのコア演習タイプを作成・変更・手動追加でき、目立つ単一選択／複数選択の切り替えを備えたネイティブな 多肢選択も含まれます。
ディクテーション（音声ディクテーション）は演習タイプのピッカーから直接使えます。音声クリップはファイルとしてアップロードする（レッスンに埋め込まれます）か、アセットパスを入力します。レッスンは自動的に拡張依存としてマークされます。
拡張作成アシスタントは、5 つの拡張演習タイプすべて（分類、誤り訂正、読解、採点付きクイズ、ディクテーション）を AI 支援で作成します。
テンプレート（空白／語彙／文法／会話）とドラフトの自動保存。
保存前に実際のレッスンビューアでプレビュー。
ローカルに保存するか、プルリクエストで共有。

入口はコンテンツブラウザとダッシュボードにあります。

テキストからの知識レッスン（書籍モード）¶

5 番目のテンプレートカード「テキストからの知識レッスン」は、専用の 3 ステップフロー（メタデータ → 書籍テキスト → レビュー）を開始します。教科書の 1 セクション（例：1 つの章）を貼り付けると、 AI がそれを自分の言葉で理論ステップとして書き直し（決してコピーではありません）、それぞれの理論ステップにリンクする演習を生成します。オプションで書籍情報（タイトル、著者、URL、 ISBN/ASIN）を付けられ、後でレッスンを編集しても保持されます。

テキストを貼り付ける代わりに、書籍ファイルをアップロードすることもできます（EPUB、DOCX、TXT、Markdown のいずれか、最大 20 MiB）。ファイルは完全にブラウザ内で解析され - 何もアップロードされません - 検出された章はチェックボックスのリストとして表示されます。前付け・後付けに見えるセクション（前書き、用語集、索引 …）は、ヒューリスティックにより デフォルトでチェックが外されますが、表示されたまま選択できます。

1 つのセクションを選択 - テキストフィールドに取り込まれます（プレビュー付き。フィールドが空でない場合は先に確認されます）。
複数のセクションを選択 - 一括生成がセクションごとに 1 つのレッスンを作成し、複数レッスンセットとしてまとめて保存します。

複数レッスンセットを編集するときは、レッスンピッカーがどのレッスンを開くかを尋ねます。書籍テキストのレッスンは直接演習エディタを開きます。

カードベースの方法と異なり、このモードには設定済みの AI キーが必要です。あなたが権利を持つテキスト、または私的利用を想定したテキストだけを貼り付けてください。

2. ファイルとして：コンテンツリポジトリ形式¶

レッスンはコンテンツセット内の JSON ファイルです。セットは公開 GitHub リポジトリに置かれ、固定のディレクトリツリー（sets/{ソース言語}/{ターゲット言語-レベル}/）に従います。正式なガイドはコンテンツリポジトリにあります。

はじめに： docs/GETTING-STARTED.md
レッスン形式： docs/LESSON-FORMAT.md

参考にしてコピーできる完成済みのスターターキットは astrapi69/adaptive-learner-content-test です。

プルリクエストで共有する¶

レッスンを共有すると、実際のプルリクエストが作成されます（フォーク → コミット → PR）。アプリは正しいパスと連番のファイル名を自動的に提案し、重複／バリエーションを検出します。コンテンツリポジトリの検証パイプラインは、PR のたびに提出された各レッスンを検査します（スキーマ、言語ペア、品質の最低基準）。これにより、整ったコンテンツだけがカタログに入ります。オプションで AI 支援のコンテンツチェックもあります。それが共有をブロックすることは決してありません。