レッスンを作成する — 概要¶
Adaptive Learner はコンテンツによって成り立っています。独自の レッスンを作成 — アプリ内で直接、またはコンテンツリポジトリ形式の ファイルとして — し、コミュニティと共有できます。このページは 概要を示します。詳しい形式の詳細はリンク先の資料にあります。
レッスンを作成する 2 つの方法¶
1. アプリ内:レッスンクリエイター¶
/create-lesson にあるレッスンクリエイターは 4 ステップの
アシスタント(メタデータ → カードエディタ → 演習ジェネレーター →
保存/共有)で、AI キーは不要です。
- カードをドラッグ&ドロップで並べ替えるか、CSV からインポート。
- カードから演習を自動生成(5 つの演習タイプすべて)するか、 手動で微調整。
- テンプレート(空白/語彙/文法/会話)とドラフトの自動保存。
- 保存前に実際のレッスンビューアでプレビュー。
- ローカルに保存するか、プルリクエストで共有。
入口はコンテンツブラウザとダッシュボードにあります。
2. ファイルとして:コンテンツリポジトリ形式¶
レッスンはコンテンツセット内の JSON ファイルです。セットは
公開 GitHub リポジトリに置かれ、固定のディレクトリツリー
(sets/{ソース言語}/{ターゲット言語-レベル}/)に従います。
正式なガイドはコンテンツリポジトリにあります。
- はじめに:
docs/GETTING-STARTED.md - レッスン形式:
docs/LESSON-FORMAT.md
参考にしてコピーできる完成済みのスターターキットは
astrapi69/adaptive-learner-content-test
です。
プルリクエストで共有する¶
レッスンを共有すると、実際のプルリクエストが作成されます (フォーク → コミット → PR)。アプリは正しいパスと連番の ファイル名を自動的に提案し、重複/バリエーションを検出します。 コンテンツリポジトリの検証パイプラインは、PR のたびに提出 された各レッスンを検査します(スキーマ、言語ペア、品質の最低 基準)。これにより、整ったコンテンツだけがカタログに入ります。 オプションで AI 支援のコンテンツチェックもあります。それが共有を ブロックすることは決してありません。
関連ページ¶
- レッスンコンテンツを作成する(開発者向け) — スキーマの詳細、アセット、コード/数式カード
- 書籍の推薦 —
books.yamlの管理 - 複数のコンテンツリポジトリ — 自分のリポジトリを接続する