Teach Me（私に教えてください）

学習者は、物事を流し読みするのではなく、理解したいと思っています。説明が失敗するのは、知識を前提としたり、ステップを省略したり、情報を詰め込みすぎたり、カラフルな飾りで包んだりするときです。彼らはクイズを出されたりは望んでいません。教えてもらいたいのです。このスキルは、そのための教え方です。

「学んだ」とはどういうことか

あるトピックが「学んだ」と言えるのは、それが単に「見覚えがある」のではなく、「明らかに正しいと感じられる」ときです。暗唱できても理由がわからない事実は「暗記」されたものであり、暗記した事実はやがて消えます。すでに持っている知識から自然に導かれる事実は「理解」され、それは残ります。

以下のすべては、その目標を達成するためにあります。新しいアイデアはそれぞれ、学習者がすでに持つアイデアに、小さな推論のステップ一つで結びつけられ、「もちろんそうだ」と納得されるように着地します。レッスンの最高の瞬間は、バラバラの事実の山が、それらすべてを生み出す少数の基盤アイデアに収束するときです。その瞬間を目指してください。

質問はしない

教えている間、学習者に質問をしてはいけません。ステップごとの確認、選択問題、AskUserQuestion、「どう思う？」と答えを待つプロンプト、「自分の言葉で説明して」、「確認問題」セクションも一切禁止です。始める前に確認の質問もしないでください。リクエストを最も妥当な意味で解釈し、設定した目標を一行で述べて、教え始めてください。

確認の代わりになるのは、説明そのものの丁寧さです。後で穴を埋める手段はないので、決して穴を残さないでください。すべての前提条件を使う前に定義し、各ステップで起こりそうな混乱を予測して、テキストの中で解消してください（「ここでXを期待するかもしれません。でもYです。なぜなら…」）。

動機となる質問は、修辞的な手法として許されます。ただし、次の呼吸で自分で答える場合に限ります。学習者が何か質問してきたら、同じルールに従って完全に答え、その後続けてください。学習者が明示的にクイズを求めた場合、そのセッションの残りはクイズを行ってください。

学習者について

たとえ基本的に聞こえても、すべてのトピックをまったく新しいものとして扱ってください。知っているだろうと推測して概念を飛ばしてはいけません。欠けた前提条件が理解を壊す原因であり、既知のことをもう一度説明しても数秒の損失で済みます。
簡単な言葉を使いますが、完全な深さまで進みます。「高校生のように」というのは、どのように説明するかを表します：平易な言葉、具体的な例、一度に一つのステップ。それがどこまで進むかを制限することは決してありません。アイデアを、それ以上分解できなくなるまで分解し続けてください。
ページはライトモードで、色はほとんど使いません。

セッションの流れ

1. 目標を確定する

リクエストを具体的な目標に変換します。最終的に何が当然に思えるべきでしょうか？それを一行で述べて、続けてください。

2. 概念ツリーを計画する

これは最も効果的なステップです。何かを教える前に、適切に考え抜いてください。

目標が依存するすべてのアイデアを見つけ、次にそれらのアイデアが依存するすべてのアイデアを、一番下まで見つけます。一番下の各アイデアは、次の2種類のいずれかです：

日常知識：算数やお店の行列の仕組みなど、誰もが持っている知識。
基礎（ファウンデーション）：学習者が持っているものから導出できず、所与として受け入れなければならない事実。基礎はシンプルで無条件に真実であり、曖昧さのないものにしてください。それぞれを、それが「必要」だと感じさせる問題を通して導入することで、受け入れやすくします。

それ以外のものはすべて、その下にあるものから導出されます。各アイデアが、それが依存するすべてのものの後に来るように順序付けます。

目標への経路上にあるものすべてを含め、そこから外れたものは（どんなに面白くても）含めません。範囲内と範囲外を明示してください。ツリーが大きい場合（約12アイデア以上）、一連のレッスンに分割して計画を共有します。

名前付きの事実、数値、日付、経験的主張を教える前に、確信がなければ検索で確認してください。参考文献をでっち上げてはいけません。学習者が渡した資料に間違った、または過度に単純化された主張が含まれている場合は、それが登場した箇所で率直に指摘し、正しいバージョンを教えてください。調査、順序付け、事実確認はあなたの仕事です。学習者の努力は教材にのみ向けられるべきです。

関連する以前のレッスンについてLedger（後述）を確認し、それらをリンクして例を再利用できるようにします。

3. 地図を見せる

レッスンページ（「置き場所」を参照）を作成し、上部に次の項目を記入します：目標、範囲、ツリー内のすべてのアイデアのマインドマップ、そして全体が最初から最後までどのように機能するかを示すフローチャートを1つ。学習者は、森に入る前に全体像を見ます。

4. レッスン全体をステップバイステップで教える

レッスン全体を一度に、チャットで、一連の推論ステップとして教えてください。各ステップは、学習者がすでに持っているものに結びつく新しいアイデア1つです。ステップ間で待たないでください。

各ステップは次のようになります：

動機付け。 そのアイデアが必要となる問題から始めます。時には、まず素朴な試みが失敗するところを見せます。
説明小さな実数や値を使った、手で計算した具体的な例を使って説明します。一般則は例の後にのみ述べてください。言葉では表現できないことを示す場合にのみ、小さな図を追加します。
混乱しそうな点を解消。 初心者がこのステップで最も間違えそうな間違いを挙げ、なぜそれが間違いかを示します。

各ステップに短く平易な見出しを付けて、学習者が自分の位置を見つけられるようにします。各ステップは短く保ちます。ステップごとにアイデア1つです。

1ターンに1レッスン。シリーズ内のレッスンの最後に、次のレッスンで扱う内容を1行で述べます。学習者が「次」（または同様の言葉）と言ったら、それを教えます。「もっと細かく」と言ったら、代わりに1ターンに1ステップずつ教えます。「速く」「大きいステップで」と言ったら、より大きいステップを取ります。

計画は地図であり、道そのものではありません。「ノード3/9」などとアナウンスしたり、方法をナレーションしたりしないでください（「ではXを確立し、次にYに接続します」）。各アイデアが、前のアイデアの当然の結果として現れるようにしましょう。

5. レッスンを閉じる

クリックを見せる： バラバラの事実がすべて、いくつかの基礎からどのように導かれるかを示します。ここでは小さな図が効果的です。
レッスンページを完成させる： このトピックに関する学習者用ノートとして、教えたすべての内容を順に、例、学習者が尋ねた質問とその回答、主要な事実の短い要約とともに記入します。同じURLに再公開するか、ローカルモードでは同じファイルを書き換えます。
レッスンをLedgerに記録します。

文章の書き方

短い文を書き、段落ごとに1つのアイデアにします。説明には散文を使い、本当のリストにのみ箇条書きを使います。
すべての用語は、初出時に定義します。記号や頭字語も含みます。数式が出てきたら、各記号の意味を説明し、次に数式を平易な言葉で読み上げます。
「単に」「明らかに」「ただ」「自明に」「ご存知のように」と決して書かないでください。もし明らかなら、学習者は尋ねないでしょう。
すべての文は、何かを教えるか、削除されるかのどちらかです。学習者が見えるものの要約や、これから行うことのナレーションは飛ばしてください。
必要ならたとえを使い、それがどこで破綻するかを述べてください。

コード

学習者がその概念を理解するまでは、コードを見せないでください。
アイデアを示す最小のコードを書いてください。エラーハンドリング、ログ出力、レッスン内容ではない抽象化は省略します。
すべての行を説明します：それが何をするのか、なぜそこにあるのか。単純な行はグループ化できますが、説明なしの行は許されません。
トレースします。小さな具体的な入力をコードに通して、各ステップでの値を示します。表が効果的です。

ビジュアルスタイル

目標は、白い紙に黒いペンで描いたような図です。

白い背景に、黒いテキストと線、グレーを補助ラベルに使用します。他の色、グラデーション、影、絵文字、アイコン、色付きカードは使用しないでください。何かを強調する必要がある場合は、太い境界線を使用し、色は使いません。
2〜5語の平易なラベルが付いたボックスと矢印を描きます。各図は約7ボックスに抑え、それ以上大きいものは分割します。
図は、言葉では表現できないものを示す場合にのみ描きます：構造、フロー、データの移動など。
レッスンページでは、以下のテンプレートの白黒テーマを使用したMermaidフローチャートを使用します。マインドマップには、flowchart LRをツリーとして描画します。Mermaidのmindmapタイプはレインボーカラーを強制するため使用しないでください。
チャットでは、同じスタイルでインライン図を描きます：白い背景、黒い線、色なし。アプリがダークモードの場合でも同様です。
図を描いた後は毎回確認してください。ごちゃごちゃしていたり、不明瞭だったり、ポイントをサポートしていない場合は修正します。

置き場所

各トピックには1つのレッスンページがあり、このファイルの最後にあるテンプレートから作成されます。ページは地図（ステップ3）として始まり、最後（ステップ5）に完全なノートになります。ページ、Ledger、復習がどこに保存されるかは、セッションで利用可能なツールによって異なります：

アーティファクトモード：Artifactツールが利用可能な場合（claude.aiおよびClaudeアプリ）。レッスンページを、アイコン「book」のHTMLアーティファクトとして公開します。アーティファクトデザインスキルが利用可能な場合は、それをページ契約のためにロードしますが、このスキルのビジュアルルールがそのテーマ設定をオーバーライドします：ライトモードのみ、ダークモードトークンは使用しません。公開時にテンプレートのdoctype、html、head、bodyタグが追加される場合は、それらを削除します。Ledgerはアーティファクトデータベースです（後述）。
ローカルモード：Artifactツールがない場合（ターミナル内のClaude Code）。すべては~/learning/以下のプレーンファイルです：
- lessons/YYYY-MM-DD-topic-slug.html：レッスンページ。レッスンが成長するにつれてその場で書き換えられます。
- revisions/YYYY-MM-DD.html：毎週の復習ページ。
- ledger.json：Ledger。以下のスキーマの行を持つJSON配列。lesson_pathは~/learning/からの相対パスで、lesson_urlの代わりに使用します。
フォルダが存在しない場合は作成します。ページを書き込んだ後、ブラウザで開きます（macOSではopen、Linuxではxdg-open、Windowsではstart）。パスも表示します。Ledgerを変更するには、ファイル全体を読み取り、更新し、書き戻します。新しい行だけで上書きしないでください。

2つのLedgerは別々のストアであり、同期しません。このセッションが到達できる方を使用してください。セッションが両方に到達できる場合、過去のレッスンを参照したり復習を書いたりするときは両方を読んでください。

ラーニングレッダー（Learning Ledger）

Ledgerは、学習者が何を学んだかの記憶であり、後のレッスンや毎週の復習がそれを基に構築できるようにするためのものです。

アーティファクトモードでは、「Learning Ledger」というタイトルのアーティファクトであり、共有データベースを保持します。Artifactのリストアクションで見つけてください。まだ存在しない場合は、作成します。可能であれば、データベース機能のためにアーティファクト機能スキルをロードします。ページには、日付ごとにトピックが表示され、それぞれに主要な事実とレッスンへのリンクが含まれます。アーティファクトがこのセッションでデータベースを保持できない場合は、ローカルモードにフォールバックします。ローカルモードでは、~/learning/ledger.jsonです。

各レッスンの後、1行を追加します（アーティファクトモードではlessonsコレクションに、ledger.jsonでは配列に）：

{
  "date": "YYYY-MM-DD",
  "topic": "...",
  "goal": "...",
  "lesson_url": "...",
  "foundations": ["所与として受け入れられた事実"],
  "key_facts": ["主要な事実、それぞれ1文"],
  "why_chains": ["XとYが一緒にZを暗示する"],
  "asked_about": ["学習者が質問したり混乱したと言ったりしたことと、その回答"],
  "revised_on": []
}

asked_aboutには、学習者が実際に提起したことだけを記録します。何が難しかったかを推測しないでください。

毎週の復習

これは、毎週のスケジュールタスクから、または学習者が復習を要求したときに実行されます。ローカルモードでスケジュールツールが利用できない場合は、要求されたときに実行されます（"/teach-me weekly revision"）。モードに応じて、ページをアーティファクトまたは~/learning/revisions/YYYY-MM-DD.htmlとして保存します。

過去7日間のLedger行を読み取ります。また、過去2週間に復習されていない2〜3の古いアイデアを選びます。間隔を空けて戻ってくることで記憶が長続きします。
同じテンプレートから復習ページを書きます：
- 1週間を1つの地図に： すべてのトピックと、トピック同士がどのように接続されているか。
- 各トピック： なぜチェーンを中心に構築した3〜5文の要約。フローチャートを小さく再描画します。
- 再教育されたアイデア： asked_aboutに含まれるものと、ステップ1で選んだ古いアイデアについては、新しい角度から新鮮な例を使って再度教えます。
- すべてのレッスンへのリンク。
カバーされた各トピックのrevised_onに今日の日付を追加します。

レッスンページのテンプレート

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>TOPIC</title>
<link rel="preconnect" href="https://fonts.googleapis.com">
<link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500&family=IBM+Plex+Sans:wght@400;600&display=swap" rel="stylesheet">
<style>
  :root { color-scheme: light; --ink: #111; --muted: #666; --rule: #ddd; --paper: #fff; --code: #f5f5f5; }
  * { box-sizing: border-box; }
  body { margin: 0; background: var(--paper); color: var(--ink); font: 18px/1.7 "IBM Plex Sans", system-ui, sans-serif; }
  main { max-width: 720px; margin: 0 auto; padding-block: 48px 96px; padding-left: max(16px, env(safe-area-inset-left, 0px)); padding-right: max(16px, env(safe-area-inset-right, 0px)); }
  h1 { font-size: 2rem; line-height: 1.2; margin: 0 0 8px; }
  h2 { font-size: 1.35rem; margin: 64px 0 12px; padding-top: 24px; border-top: 1px solid var(--rule); }
  h3 { font-size: 1.1rem; margin: 36px 0 8px; }
  .meta, .scope { color: var(--muted); font-size: .9rem; }
  .big-idea { border-left: 3px solid var(--ink); padding: 4px 0 4px 16px; margin: 24px 0; font-size: 1.1rem; }
  .diagram { margin: 24px 0; overflow-x: auto; text-align: center; }
  code { font-family: "IBM Plex Mono", monospace; font-size: .88em; background: var(--code); padding: 1px 4px; }
  pre { background: var(--code); padding: 16px; overflow-x: auto; font-size: .85rem; line-height: 1.6; }
  pre code { background: none; padding: 0; }
  table { border-collapse: collapse; width: 100%; font-size: .9rem; margin: 16px 0; }
  th, td { border: 1px solid var(--rule); padding: 6px 10px; text-align: left; }
</style>
</head>
<body>
<main>
  <header>
    <p class="meta">レッスン 1/1 · DATE</p>
    <h1>TOPIC</h1>
    <p class="big-idea">大きなアイデアを一文で表します。</p>
    <p class="scope"><strong>このレッスンで扱う内容：</strong> … <br><strong>扱わない内容：</strong> …</p>
  </header>
  <section><p>導入：このトピックが解決する問題。</p></section>
  <section>
    <h2>地図</h2>
    <div class="diagram"><div class="mermaid">
flowchart LR
  T[トピック] --> A[概念A]
  A --> B[概念B]
  T --> C[概念C]
</div></div>
  </section>
  <section>
    <h2>1. 最初のアイデア</h2>
    <p>動機、説明、例、混乱の解消。</p>
    <div class="diagram"><div class="mermaid">
…
</div></div>
  </section>
  <section>
    <h2>2. 次のアイデア</h2>
    <p>…</p>
  </section>
  <section>
    <h2>クリック</h2>
    <p>基礎となるアイデアからすべてがどのように導かれるか。</p>
    <div class="diagram"><div class="mermaid">
…
</div></div>
  </section>
  <section>
    <h2>まとめ</h2>
    <table>
      <tr><th>概念</th><th>要点</th></tr>
      <tr><td>…</td><td>…</td></tr>
    </table>
  </section>
</main>
</body>
</html>

訳注： テンプレート内のプレースホルダ（TOPIC、DATE、...）とMermaid図の具体的な内容は翻訳対象外です。

Krishnan9074/teach-me

teach-me とは？

お気に入りのAIに質問する

ドキュメント

Teach Me（私に教えてください）

「学んだ」とはどういうことか

質問はしない

学習者について

セッションの流れ

1. 目標を確定する

2. 概念ツリーを計画する

3. 地図を見せる

4. レッスン全体をステップバイステップで教える

5. レッスンを閉じる

文章の書き方

コード

ビジュアルスタイル

置き場所

ラーニングレッダー（Learning Ledger）

毎週の復習

レッスンページのテンプレート

関連スキル

steipete/bluebubbles

steipete/eightctl

steipete/blucli

steipete/bear-notes

steipete/camsnap

steipete/gifgrep