check-understanding について
AI Engineering from Scratch を学ぶ人向けの理解度チェック用スキルです。段階番号やトピックから教材を特定し、8 問の選択式テストを作成して、段階的な出題と復習案内を行います。
主な機能
- 01段階番号・名称から教材ディレクトリを特定
- 02テストごとに8問を作成
- 03概念問題と実践問題を出題
- 041問ずつ提示して回答を待機
- 05採点して復習テーマを提示
活用シーン
- 01学習段階の完了後に理解度を確認
- 02Transformer など特定テーマを復習
- 03次の段階へ進めるか判断
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/check-understandingを入力して読み込まれたか確認します。
詳細
理解度チェック
AI Engineering from Scratch の完了済みステージについて、学習者の理解度をテストします。
起動方法
ユーザーが次のようなことを言ったときに、このスキルを有効にします。
/check-understanding 3または/check-understanding deep-learning- 「第 2 ステージの理解度をテストして」
- 「第 1 ステージをテストして」
- 「transformer の理解度を確認して」
- 「第 3 ステージを習得できていますか」
- 「次のステージに進む準備はできていますか」
入力
ステージ番号（0-19）またはステージ名を引数として受け付けます。引数がない場合は、全 20 ステージを一覧表示して、どのステージをテストするかユーザーに尋ねます。
ステージの対応表
引数を phases/ 以下の正しいステージディレクトリに対応付けます。
| 入力 | ディレクトリ | ステージ名 |
|---|---|---|
| 0, setup, tooling | 00-setup-and-tooling | 環境設定とツール |
| 1, math, math-foundations | 01-math-foundations | 数学の基礎 |
| 2, ml, ml-fundamentals | 02-ml-fundamentals | 機械学習の基礎 |
| 3, deep-learning, dl | 03-deep-learning-core | 深層学習のコア |
| 4, cv, computer-vision, vision | 04-computer-vision | コンピュータビジョン |
| 5, nlp | 05-nlp-foundations-to-advanced | NLP：基礎から応用まで |
| 6, speech, audio | 06-speech-and-audio | 音声とオーディオ |
| 7, transformers | 07-transformers-deep-dive | Transformer の詳細解説 |
| 8, generative, gen-ai, genai | 08-generative-ai | 生成 AI |
| 9, rl, reinforcement-learning | 09-reinforcement-learning | 強化学習 |
| 10, llms, llm, llms-from-scratch | 10-llms-from-scratch | LLM をゼロから構築 |
| 11, llm-engineering, llm-eng | 11-llm-engineering | LLM エンジニアリング |
| 12, multimodal | 12-multimodal-ai | マルチモーダル AI |
| 13, tools, protocols, mcp | 13-tools-and-protocols | ツールとプロトコル |
| 14, agents, agent-engineering | 14-agent-engineering | Agent エンジニアリング |
| 15, autonomous | 15-autonomous-systems | 自律システム |
| 16, multi-agent, swarms | 16-multi-agent-and-swarms | マルチ Agent とスウォーム |
| 17, infrastructure, production, infra | 17-infrastructure-and-production | インフラストラクチャと本番環境 |
| 18, ethics, safety, alignment | 18-ethics-safety-alignment | 倫理、安全性、アラインメント |
| 19, capstone, projects | 19-capstone-projects | 総合プロジェクト |
手順
ステップ 1：ステージを解析する
引数を解析します。数字の場合は、0 から 19（両端を含む）の範囲内か検証します。範囲外の数字の場合は、ユーザーに ステージ [N] は存在しません。有効なステージは 0-19 です。 と伝え、その後、選択できるように全リストを表示します。名前またはキーワードの場合は、上記のステージ対応表で検索します。キーワードがどの項目にも一致しない場合は、ユーザーに 不明なステージ「[keyword]」です。以下のリストから選択してください： と伝え、全 20 ステージを表示します。引数が指定されていない場合は、全リストから選ぶようユーザーに求めます。
ステップ 2：ステージの内容を読む
リポジトリがクローン済みの場合（現在のディレクトリまたはその親ディレクトリに phases/ がある場合）、phases/<phase-dir>/ 以下のすべてのレッスンディレクトリを見つけ、各レッスンの docs/zh.md を読みます。クローンされていない場合は、README の Contents セクションからそのステージのレッスン一覧を取得し（https://raw.githubusercontent.com/fancyboi999/ai-engineering-from-scratch-zh/main/README.md を取得）、同じ raw base URL から各レッスンの docs/zh.md を取得します。これらのドキュメントを出題の根拠とします。
そのステージの全範囲を網羅するのに十分な数のレッスンドキュメントを読みます。ステージのレッスン数が多い（15+）場合は、冒頭の数レッスン、中盤の数レッスン、最後の数レッスンを代表的に選んで優先的に読みます。
ステップ 3：8 問を作成する
読み込んだレッスン内容に基づいて、選択式問題をちょうど 8 問作成します。
第 1-4 問：概念問題（何か／なぜか） 考え方、定義、推論についての理解をテストします。例：
- 「X の目的は何ですか？」
- 「Z が存在するとき、なぜ Y が発生するのですか？」
- 「A と B の関係を最も正確に説明しているのはどれですか？」
- 「X はどのような問題を解決しますか？」
第 5-8 問：実践問題（どう行うか／構築するか） 知識の応用と実装に関する理解をテストします。例：
- 「X をどのように実装しますか？」
- 「Y を正しく解決する方法はどれですか？」
- 「Z を構築する正しい手順はどの順番ですか？」
- 「トレーニング中に X が観察された場合、どうすべきですか？」
各問題には、A、B、C、D のラベルが付いた選択肢をちょうど 4 つ用意し、正解は 1 つだけにします。不正解の選択肢はもっともらしいものにしますが、教材をしっかり学習した人なら明らかに誤りだと分かるものにしてください。
各問題に出典となるレッスンを記載します（例：「第 03 課：行列変換」）。
ステップ 4：問題を 1 問ずつ提示する
AskUserQuestion ツール（または同等の対話型プロンプト）を使い、一度に 1 問ずつ提示します。形式：
第 1/8 题（概念题）——来自第 03 课：矩阵变换
特征值的几何解释是什么？
A) 矩阵施加的旋转角度
B) 特征向量在变换中被缩放的倍数
C) 变换矩阵的行列式
D) 变换后矩阵的秩
ユーザーが回答してから、次の問題に進みます。
回答の秘匿
学習者が現在の問題に回答する前に、正解と解説は必ず非公開にします。回答形式の案内で、実際の正解の文字、推測できる選択肢、生成した回答の分布を決して使わないでください。プレーンテキストで案内する必要がある場合は、必ず次の形式を厳守します：A、B、C、D のいずれか 1 文字だけで回答してください：<A|B|C|D>。
ステップ 5：記録して採点する
以下を継続して記録します。
- 8 問中の正解数
- 各不正解の問題：問題番号、ユーザーの回答、正解、出典となるレッスン
ステップ 6：結果を表示する
8 問すべてに回答したら、得点と評価を表示します。
正解が 7-8 問：習得済み
ステージ 19（総合プロジェクト）の場合：あなたは第 19 ステージ、そして最後のステージを習得しました。カリキュラムの残りすべてを完了したことを確認できる場合（現在のディレクトリにある LEARNING.md のパス表で、ステージ 0-18 がすべて Done または Skip と表示されている場合）のみ、おめでとうございます。カリキュラムをすべて完了しました。 を追加できます。単一のステージテストだけでは、カリキュラム全体の完了を確認できません。
それ以外の場合：第 N ステージの理解は確かです。第 N+1 ステージ：[次のステージ名] に進めます。
正解が 5-6 問：習得間近
基礎はしっかりしています。続ける前に、以下の具体的な内容を復習してください：
続けて、不正解に関連するレッスンを列挙します。
正解が 3-4 問：理解を深めている途中
理解は深まっていますが、以下のレッスンを復習する必要があります：
続けて、不正解の各問題と、読み直す必要があるレッスンを列挙します。
正解が 0-2 問：やり直し
このステージには、まだ時間をかける必要があります。最初からレッスンを学び直し、以下の内容に重点を置いてください：
続けて、習得できていないテーマをすべて列挙します。
ステップ 7：不正解の解説
ユーザーが間違えた各問題について、以下を表示します。
第 N 题：[题目文本，缩写]
你的答案：B
正确答案：C —— [正确选项文本]
原因：[用 1-2 句解释 C 为什么正确]
复习：第 NN 课 —— [课程名称] (phases/<phase-dir>/NN-<lesson-slug>/docs/zh.md)
ステップ 8：次にすること
最後に、次の 3 つの選択肢を提示します。
- このテストを再受験する —— 同じステージについて、新しい 8 問を作成します
- 別のステージをテストする —— テストする別のステージを選びます
- テーマを解説する —— 不正解に関連する概念について質問します
ユーザーが選択してから実行します。
ルール
- 再受験では、問題バンクを使い切るまでは問題の重複を避けます。問題バンクを使い切った後に限り、以降の再受験では問題を並べ替えたり、書き換えたりできます。
- 問題はレッスンドキュメントに直接基づく必要があり、一般知識に基づいてはいけません。
- ユーザーが回答する前に、正解を表示してはいけません。
- 学習者の回答形式の例に、実際の正解の文字を含めてはいけません。プレースホルダーとして
<A|B|C|D>を使用します。 - 問題文は簡潔にし、1～2 文までにします。
- 不正解の選択肢はもっともらしいものにし、冗談のような回答は設定しないでください。
- あるステージのレッスン本文がまだ公開されていない場合（
docs/zh.mdファイルを基準とする）、ユーザーに第 N ステージのレッスン内容はまだ提供されていません。完了済みのステージを選んでテストしてください。と伝えます。