steffen74/to-quiz

小テスト（To Quiz）

1ユニット分の小テストを作成し、公開します。事前にCOURSE-CANVAS.md、PLAN.md、RESOURCES.md、DECISIONS.md、AGENTS.mdの## Agentic course creationセクション、および小テストが対象とするユニットの教材（ビデオとタスク）を読み込んでください。また、assumed-knowledgeをロードします。

1. ツールとソース

AGENTS.mdには、/setup-courseで設定された行- Quizzes: <ソースファイル>, tool <ツール名>, connector <コネクタ名|none>が含まれている必要があります。これがない場合は、一度だけ質問し、推奨して書き込みます。

• ソース: プライベートコースリポジトリ内の1つのファイルに、すべての質問と選択肢、正解、解説が含まれます（CSV形式：列はsession, type, question, option_a, option_b, option_c[, option_d], correct, explanation、またはこれを反映したMarkdown）。小テストツールはコピーであり、ソースではありません。
• ツール: コースごとに一度選択します（例：Microsoft Forms や Formbricks）。採点はオプションです。ほとんどのビデオチェックでは、授業で議論するために回答分布のみが必要です。

2. 質問を書く

ユニットに対して3～5問の質問をドラフトします。各質問には以下を含めます。

• 学習者がセッション前に出会ったもの（前のユニットのビデオとタスク）に関する質問。セッション自体が導入する内容について質問してはいけません。
• 3つまたは4つの選択肢。1つが正解。誤った選択肢は、学習者が実際に持つ誤解（可能な場合はSIGNALS.mdから）に基づいており、引っかけ問題ではありません。
• 講師が授業で使用するための1～2文の解説。
• タイプ：video、task、skillのいずれかと、そのソース。

質問は教材の実際の内容に基づいて作成します。読めないビデオに基づく質問には、解説にタイトルのみからとマークし、講師がビデオと照合できるようにします。

質問を表示し、講師の応答を待ちます。その後、質問をソースに書き込みます。

3. ツールに作成する

• ツールにコネクタが接続されている場合: 作成される小テストを表示し、承認を待ち、下書きとして作成し、共有リンクを記録します。コネクタ独自のスキーマ（ツールの説明を読んでください。スキーマはバージョン間で変わります）を使用して小テストソースからリクエストを構築し、検証ツールがあればそれを最初に使用します。
  • Formbricks: 公式MCPサーバー（OAuthサインイン付き）があります（https://app.formbricks.com/api/mcp、またはセルフホストの場合はhttps://<domain>/api/mcp）。ツールにはlist_workspaces、validate_survey、create_surveyが含まれます。コースがFormbricksを使用していて接続されていない場合は、講師にエージェントに追加するコマンドを提供します（Claude Codeの場合：claude mcp add --transport http formbricks https://app.formbricks.com/api/mcp、その後/mcpでサインイン）。エージェント設定を自分で変更しないでください。
  • Microsoft Forms: 小テストを作成するAPIや公式コネクタはありません。以下のエクスポートを使用してください。
• コネクタがない場合: CSVソースからscripts/export_quiz.pyを使用してエクスポートします。
  • Formbricks: --format formbricksはManagement API用の調査本文を書き込み、curlコマンドを出力します。講師は環境変数から自身のAPIキーを使用して実行します。キーを求めたり、ファイルに書き込んだりしないでください。
  • Microsoft Forms: --format formsはクイックインポート用の.docxファイルと解答キーを書き込みます。クイックインポートは正解を取り込まないため、講師は解答キーから手動で正解をチェックします（採点を使用する場合のみ必要）。
  • その他のツール: 受け入れ可能な最も近いインポート形式、または貼り付け用のプレーンリストを書き込みます。

回答と解説は、学習者向けのファイルや公開場所に決して表示されません。

4. 引き継ぎ

小テストのリンクをRESOURCES.mdの該当ユニット（Quiz列）に記録します。スライドにはリンク（およびスライド形式が許せばQRコード）を表示します。質問自体は表示しません。/to-slidesはRESOURCES.mdからリンクを取得します。

質問がソースに書き込まれ、小テストがツールに下書きまたはインポートファイルとして存在し（指示付き）、そのリンクまたはステータスがRESOURCES.mdに記録された時点で完了です。