ログイン
セクション

そのコード、読んでいますか。それとも、読んだことにしていますか。

AIに任せるほど変更は速く積み上がります。しかし理解は先送りできてしまうのが厄介なところです。動いているから困らない。困らないから読まない。そうやって積み上がった理解の空白は、静かに認知的負債になります。

——コミットする前に、解説と小テストを必ず通す。その「学習ゲート」という仕組みの設計と導入を解説するのがこの講座です。

Claude Codeスキル実践: /learn 学習ゲート

解説→小テスト→合格→受領証。コミット前に理解を精算する仕組みの設計と導入

こんな経験、ありませんか

  • AIが書いたコードをよく読まずにマージして、後から「自分のプロジェクトのはずなのに説明できない箇所」が増えていた
  • コードレビューでdiffを眺めたが、結局「読んだつもり」で承認ボタンを押していた
  • AIに任せるほど開発は速くなるのに、自分の理解だけがどんどん置いていかれる感覚がある
  • トラブルが起きたときに、AIが書いた箇所を自分の言葉で説明できず立ち往生した

これは注意力や意志の問題ではありません。理解を強制するタイミングと仕組みが、開発フローのどこにも用意されていないだけです。

この講座で学べること

この講座では、実際に日常運用されている「学習ゲート付き開発ループ」——/learn コマンド・MCPクイズサーバー・pre-commitフックの3点セット——を教材に、「なぜそのルールが必要なのか」を設計意図から一つずつ解説します。全8章の構成は次の通りです。

  • 1. なぜ学習ゲートか — 理解の先送りが認知的負債になる構造と、小テストを理解のブレーキとして使う発想
  • 2. 全体アーキテクチャ — /learn（対話）とpre-commit（門番）を分離し、受領証と履歴DBという2系統のストアで支える設計
  • 3. /learnコマンド — 差分読解から解説、設問方針、受領証発行までの7手順と3つの禁止事項
  • 4. quiz-server — ブラウザクイズとサーバー採点、カンニングできない設計の作り方
  • 5. 受領証とpre-commit — 差分ハッシュを鍵にする理由と、賢いことをしない門番の実装
  • 6. /reviewと間隔反復 — 間違えた論点ほど早く出題される間隔反復（SM-2簡易）の仕組み
  • 7. 体験クイズ — この場で実際に学習ゲートのクイズを解いてみる
  • 8. 導入と運用 — 導入手順とCLAUDE.mdの書き方、ファイル一式のダウンロード

コマンド・MCPサーバー・フックのファイル一式はダウンロードできます。そのまま自分の Claude Code に入れて使えます。

対象者

この講座は主に以下の方を対象にしています。

  • Claude Code などのAIコーディングエージェントで、日常的にコードや文書を書いている方
  • AIに任せる範囲が増えるほど、自分の理解が追いついていない感覚がある方
  • チーム開発やレビューで「読んだつもり」のまま変更を通してしまうことに課題を感じている方

gitやClaude Code自体の基本操作ができれば読めます。学習ゲートの仕組みは、AIエージェントを使わない開発チームのレビュー運用にも応用できる考え方です。

本講座の特徴

実際に運用されている仕組みをそのまま解剖する

教材用に作った架空の例ではなく、実際のコミットのたびに動いている /learn コマンド・quiz-server・pre-commitフックの3点セットを扱います。設計の一つひとつに、実際の運用で見つかった抜け道や失敗への対処が反映されています。

「なぜ」を最優先で解説する

仕組みの丸暗記では、自分のプロジェクトに合わせて調整するときに応用できません。各部品を「仕組み → なぜ必要か → 何を防いでいるか」の順で解説し、判断基準ごと持ち帰れるようにしています。

この場でクイズを体験できる

第7章では、実際に学習ゲートが出すクイズをこの場で2問だけ体験できます。読むだけでなく解いてみることで、「小テストというブレーキ」の感触を確かめられます。

講座の構成

章内容
1. なぜ学習ゲートか理解の先送りが認知的負債として積み上がる構造と、小テストを理解のブレーキとして使う発想。「1コミット=1学習」という運用単位の理由まで扱う土台の章です。
2. 全体アーキテクチャ
——対話と門番の分離		/learn（対話）とpre-commit（門番）という2つの起点、受領証（使い捨て）と履歴DB（durable）という2つのストア。役割を分けることでこの仕組みが壊れにくくなっている理由を解説します。
3. /learnコマンド
——解説からクイズ、受領証まで		ステージ確認・差分読解・既存概念の再利用・直感優先の解説・設問方針・全問正解までの反復・受領証発行という7手順と、コマンドが守る3つの禁止事項を解説します。
4. quiz-server
——ブラウザクイズとサーバー採点		回答するまでツールの実行が進まないMCP Elicitation URLモード、正解キーを埋め込まないサーバー採点、選択肢シャッフル。カンニングできない設計を一つずつ確認します。
5. 受領証とpre-commit
——賢いことをしない門番		受領証のキーがHEADではなくステージ済み差分のハッシュである理由。16行のシェルスクリプトを1行ずつ読み、理由を残して通すソフトゲートと縁ケースまで扱います。
6. /reviewと間隔反復回答履歴は全プロジェクト横断の学習資産になります。間違えた論点ほど早く再出題される間隔反復（SM-2簡易）の仕組みと、間隔を伸ばせる条件を解説します。
7. 体験
——学習ゲートのクイズを解いてみる		実際に/learnが出題するクイズを、この場で2問だけ体験できます。些末な事実ではなく設計意図を問う、という設問方針を体感する章です。
8. 導入と運用コマンド・フック・quiz-serverのセットアップ手順、AIにゲートを迂回させないためのCLAUDE.mdの書き方、LEARN_SKIPの使いどころ。ここでファイル一式をダウンロードできます。

本講座で扱わないこと

  • gitやClaude Code自体の基礎 — コミットの仕組みやAIエージェントの基本操作は別講座の領分です。本講座は学習ゲートという「仕組みの設計」に集中します
  • Turso（データベースサービス）のアカウント作成手続きの詳細 — 履歴DBの保存先として利用しますが、サービス自体のサインアップ手順は公式ドキュメントに譲ります
  • SM-2アルゴリズムの数学的な厳密解説 — 間隔反復の考え方は解説しますが、正答率の計算式や係数の導出といった数式レベルの厳密さまでは踏み込みません

そのコード、読んでいますか。それとも、読んだことにしていますか。

AIに任せるほど変更は速く積み上がります。しかし理解は先送りできてしまうのが厄介なところです。動いているから困らない。困らないから読まない。そうやって積み上がった理解の空白は、静かに認知的負債になります。

——コミットする前に、解説と小テストを必ず通す。その「学習ゲート」という仕組みの設計と導入を解説するのがこの講座です。

Claude Codeスキル実践: /learn 学習ゲート

解説→小テスト→合格→受領証。コミット前に理解を精算する仕組みの設計と導入

こんな経験、ありませんか

  • AIが書いたコードをよく読まずにマージして、後から「自分のプロジェクトのはずなのに説明できない箇所」が増えていた
  • コードレビューでdiffを眺めたが、結局「読んだつもり」で承認ボタンを押していた
  • AIに任せるほど開発は速くなるのに、自分の理解だけがどんどん置いていかれる感覚がある
  • トラブルが起きたときに、AIが書いた箇所を自分の言葉で説明できず立ち往生した

これは注意力や意志の問題ではありません。理解を強制するタイミングと仕組みが、開発フローのどこにも用意されていないだけです。

この講座で学べること

この講座では、実際に日常運用されている「学習ゲート付き開発ループ」——/learn コマンド・MCPクイズサーバー・pre-commitフックの3点セット——を教材に、「なぜそのルールが必要なのか」を設計意図から一つずつ解説します。全8章の構成は次の通りです。

  • 1. なぜ学習ゲートか — 理解の先送りが認知的負債になる構造と、小テストを理解のブレーキとして使う発想
  • 2. 全体アーキテクチャ — /learn（対話）とpre-commit（門番）を分離し、受領証と履歴DBという2系統のストアで支える設計
  • 3. /learnコマンド — 差分読解から解説、設問方針、受領証発行までの7手順と3つの禁止事項
  • 4. quiz-server — ブラウザクイズとサーバー採点、カンニングできない設計の作り方
  • 5. 受領証とpre-commit — 差分ハッシュを鍵にする理由と、賢いことをしない門番の実装
  • 6. /reviewと間隔反復 — 間違えた論点ほど早く出題される間隔反復（SM-2簡易）の仕組み
  • 7. 体験クイズ — この場で実際に学習ゲートのクイズを解いてみる
  • 8. 導入と運用 — 導入手順とCLAUDE.mdの書き方、ファイル一式のダウンロード

コマンド・MCPサーバー・フックのファイル一式はダウンロードできます。そのまま自分の Claude Code に入れて使えます。

対象者

この講座は主に以下の方を対象にしています。

  • Claude Code などのAIコーディングエージェントで、日常的にコードや文書を書いている方
  • AIに任せる範囲が増えるほど、自分の理解が追いついていない感覚がある方
  • チーム開発やレビューで「読んだつもり」のまま変更を通してしまうことに課題を感じている方

gitやClaude Code自体の基本操作ができれば読めます。学習ゲートの仕組みは、AIエージェントを使わない開発チームのレビュー運用にも応用できる考え方です。

本講座の特徴

実際に運用されている仕組みをそのまま解剖する

教材用に作った架空の例ではなく、実際のコミットのたびに動いている /learn コマンド・quiz-server・pre-commitフックの3点セットを扱います。設計の一つひとつに、実際の運用で見つかった抜け道や失敗への対処が反映されています。

「なぜ」を最優先で解説する

仕組みの丸暗記では、自分のプロジェクトに合わせて調整するときに応用できません。各部品を「仕組み → なぜ必要か → 何を防いでいるか」の順で解説し、判断基準ごと持ち帰れるようにしています。

この場でクイズを体験できる

第7章では、実際に学習ゲートが出すクイズをこの場で2問だけ体験できます。読むだけでなく解いてみることで、「小テストというブレーキ」の感触を確かめられます。

講座の構成

章内容
1. なぜ学習ゲートか理解の先送りが認知的負債として積み上がる構造と、小テストを理解のブレーキとして使う発想。「1コミット=1学習」という運用単位の理由まで扱う土台の章です。
2. 全体アーキテクチャ
——対話と門番の分離		/learn（対話）とpre-commit（門番）という2つの起点、受領証（使い捨て）と履歴DB（durable）という2つのストア。役割を分けることでこの仕組みが壊れにくくなっている理由を解説します。
3. /learnコマンド
——解説からクイズ、受領証まで		ステージ確認・差分読解・既存概念の再利用・直感優先の解説・設問方針・全問正解までの反復・受領証発行という7手順と、コマンドが守る3つの禁止事項を解説します。
4. quiz-server
——ブラウザクイズとサーバー採点		回答するまでツールの実行が進まないMCP Elicitation URLモード、正解キーを埋め込まないサーバー採点、選択肢シャッフル。カンニングできない設計を一つずつ確認します。
5. 受領証とpre-commit
——賢いことをしない門番		受領証のキーがHEADではなくステージ済み差分のハッシュである理由。16行のシェルスクリプトを1行ずつ読み、理由を残して通すソフトゲートと縁ケースまで扱います。
6. /reviewと間隔反復回答履歴は全プロジェクト横断の学習資産になります。間違えた論点ほど早く再出題される間隔反復（SM-2簡易）の仕組みと、間隔を伸ばせる条件を解説します。
7. 体験
——学習ゲートのクイズを解いてみる		実際に/learnが出題するクイズを、この場で2問だけ体験できます。些末な事実ではなく設計意図を問う、という設問方針を体感する章です。
8. 導入と運用コマンド・フック・quiz-serverのセットアップ手順、AIにゲートを迂回させないためのCLAUDE.mdの書き方、LEARN_SKIPの使いどころ。ここでファイル一式をダウンロードできます。

本講座で扱わないこと

  • gitやClaude Code自体の基礎 — コミットの仕組みやAIエージェントの基本操作は別講座の領分です。本講座は学習ゲートという「仕組みの設計」に集中します
  • Turso（データベースサービス）のアカウント作成手続きの詳細 — 履歴DBの保存先として利用しますが、サービス自体のサインアップ手順は公式ドキュメントに譲ります
  • SM-2アルゴリズムの数学的な厳密解説 — 間隔反復の考え方は解説しますが、正答率の計算式や係数の導出といった数式レベルの厳密さまでは踏み込みません