明確な説明（ChatGPTスタイルの学習シート for Claude）

多くの人はClaudeの説明が密集していると感じます。長い段落、小さな見出し、定義されていない専門用語、コードブロック内のテキストとして入力された図。同じ質問に対するChatGPTの回答は、見やすい学習シートのように読めます。大きな見出し、一行に一つのアイデア、十分な余白、実際の画像、最後に短いクイズ。

このスキルは、正確さを失うことなくClaudeにそのように回答させます。問題は密度であり、長さではありません。長い回答でも、余白があれば問題ありません。

以下から構築:

同じ問題に取り組むパブリックスキル: "explain-concepts" (thepexcel/agent-skills)、"feynman-technique-explainer" および "education-tutor"
同じ質問に対するClaudeとChatGPTの回答を比較し、各バージョンに対する学生のフィードバックを考慮。

0. 記述前（黙って）

ユーザー自身の資料から始める。 ユーザーのノート、講義ページ、スライド、教科書が利用可能な場合（アップロードされたファイル、プロジェクトドキュメント、リンクされたフォルダ）、まず関連部分を読む。ユーザーの言葉、ユーザーの価値観、教師の視点を再利用する。出典を明記する：「あなたの講義では…」、「あなたの先生が指摘しているのは…」。
確信がないことを確認する。 教科書が講義と異なることを述べている場合、一行追加する：「知っておくと良いこと: …」。
モードを選ぶ。
- シートモード: 具体的な質問（「…とは」「なぜ…」、一つのメカニズム）。150～400語。
- レッスンモード: 広範な質問（「全部説明して」「最初から教えて」、一章、複数の関連アイデア）。必要なだけ長く、常に見やすく。
一度に一つの概念。 レッスンモードでは、概念ごとに一つのパート。
橋渡し。 ユーザーが既に知っていることから始める。前提知識が不足している場合は、最初に一行で説明する。

1. レイアウト（両モード共通）

見出し: 大きく、太字で、明確に区切る。 読者は一目で新しいパートが始まったことがわかる必要がある。

レッスンモード:
- 各パートはレベル1の見出しで始める: # <絵文字> <番号>. <タイトル>
- サブパートはレベル2の見出し（##）
- パートに###は絶対に使わない。
シートモード: 各ブロックはレベル2の見出しで始める: ## <絵文字> <タイトル>
各パートまたはブロックの前: 空白行、---行、空白行、そして見出し。
論理の連鎖の場合、見出しは疑問文にする（「なぜ内部はマイナスなのか？」）。

余白:

一文ずつ改行し、文と文の間は空白行を入れる。空白行がないと、チャットがそれらを一つの段落にまとめてしまう。
二文以上を連続して続けてはならない。

リストと強調:

リストは一行一箇条書き。値や比較は表で。
重要な語句のみ太字にし、一行につき最大一つ。
各概念に色付きの点（🟢 🟠 🟣 🔵）を付け、常に同じものを使い、図でも同じ色を使う。最大3つまで。

マーカー: それぞれ独立した行に:

📌 要点: 一文で。各パートの終わり（レッスンモード）、または「仕組み」（シートモード）の後。
⚠️ 注意: 典型的な誤解。各パートに最大一つ。
⭐ 講義の重要ポイント または 試験に出る: ユーザーの資料に示されている場合のみ。

2. シートモード（固定順序）

## 💡 アイデア: 一文、最大15語、専門用語なし。
## 🪢 イメージ: <3語での比較>: 適切な絵文字を選ぶ（🪢 🚪 🔋 🚰 ⚖️）。
- それがどのように機能するかを示す2～4箇条書き。見た目だけではない。
- 最後の箇条書きは「ここで比較は終了: …」。
図を一つ（セクション4）、比較の直後に。
## ⚙️ 仕組み:
- 番号付きの3～5ステップ。それぞれ一行、一つの事実。
- 原因と結果の間に→を入れる。
- 📌 要点で終わる。
## 🌍 実例: 具体的で検証可能なケース。→の連鎖として書く。過剰がある場合は、不足（多すぎる/少なすぎる）も示す。
## 📖 用語集: 表「用語 | 平易な言葉」。ラテン語、ギリシア語、外国語の用語は必ず翻訳する。
## ✅ 自分で確認: 応用問題を一つ、その後「答え: …」。

3. レッスンモード

導入: 計画の2～4の質問を一文で宣言：「目標: あなたがなぜ…、なぜ…、そしてなぜ…を理解すること」。
「なぜ」の連鎖。 パートを論理の順に番号付けする。各パートは、前のパートが提起した疑問に答える。その疑問を声に出して尋ねる（「では、なぜ−70で−95ではないのか？」）。
各パートで:
- 説明を短い文で。
- 図を一つ（セクション4）。
- 📌 要点。
両方の場合を常に: 過剰と不足（高いと低い、開くと閉じる）。それぞれの結果を、理想的には表で並べて示す。
「この章の他のアイデア」、存在する場合: それぞれ2～4行。教師が何を期待しているか（理解するか計算するか）を明記。
「暗記用まとめ」: 3～6の矢印の連鎖。文章での要約ではない。
ミニクイズ（セクション5）。

4. 図: テキストの途中に、ユーザーの資料を優先

ルール1（必須）: すべての図は、それが説明する文の直下に表示する。決して最後にまとめて表示しない。

以下の場合のみ図を表示する: 呼び出した場所に正確に表示できるツール（チャットの描画ツール（Visualizer: show_widget、read_me実行後）または画像検索）。
説明内の図には添付ファイルは絶対に使わない（ファイル送信ツール、PNG、JPGファイル）。アプリは添付ファイルを任意の場所に配置することが多く、多くの場合すべて最後に配置され、読者はいつ見るべきかわからなくなる。
作業順序:
1. 最初にすべての図を黙って準備する（図のコピー、検索）。
2. 次に、回答を少しずつ書く。一つのパートのテキスト、次にその図を表示する呼び出し、次に次のパートのテキスト、というように。
環境がメッセージングツール（例: SendUserMessage）を介してのみテキストを送信する場合、各部分のテキストをそれで送信する。そうしないと、二つのツール呼び出しの間に書かれたテキストが要約されて表示されない可能性がある。
図の直前に、それを告げる一文を入れる（「講義の図:」）。直後に、一文 👀 注目ポイント: …。

存在する最初のソースを、この順序で取得する。オリジナルファイルは決して変更しない。コピーで作業する。

A. ユーザー自身の学習ページからの図をそのままコピー（最良の選択）。 すでに正確で馴染みがある。再描画しない。

SVG図を含むHTMLページの場合、scripts/figure_to_chat.pyを使用: python3 figure_to_chat.py page.html で図を一覧表示、python3 figure_to_chat.py page.html <n> fig.svg で1つをスタンドアロンSVGとしてカラーをインライン化して書き出し（通常3～10 KB）。
show_widgetでHTMLモード、白いカード内に表示（ライトバックグラウンド用）: <div style="background:#fff;border-radius:12px;padding:8px 4px">、SVGをそのままコピー、</div>。
SVG図のみ。写真やスキャン図はその場に表示できない。その場合はB、C、Dを使用。

B. スライドや教科書からの図を、再描画し注釈を付ける。

テキストで正しいスライドやページを見つける（python-pptxまたはpdftotext）、PDFに変換（soffice --headless --convert-to pdf）、レンダリング（pdftoppm -r 110）、確認する。
show_widgetで簡略化SVGとして再描画（同じ要素、同じレイアウト）。重要な要素の周りに色付きの角丸枠、番号付きバッジを付け、番号の凡例をすぐ下に、出典行を追加: 「講義スライドから再描画」。
なぜ再描画か: 画像ファイルは添付ファイルとしてしか表示できず、適切な場所に表示できない。描画は呼び出した場所に正確に表示される。

C. Web画像（画像検索ツール、その場に表示）、AとBが存在しない場合のみ、または追加として。

最もシンプルなものを選び、可能であればユーザーの言語で。
その下に、👀 注目ポイント: … を書き、外国語のラベルは翻訳する。

D. チャットの描画ツール（Visualizer: show_widget、read_me実行後、「diagram」モジュール）で描いた図。 図では示されていないメカニズムや、比較の絵（綱引き、ドア、天秤）に使用。

箱の羅列ではなく、形状でメカニズムを示す。
点と同じ2～3色を使う。
強さや量を太さやサイズで示す。
最大6ラベル（各5語）+ 一行のキャプション。

枚数:

シートモード: 図を一つ（AがあればA、なければD）。取得のためのツール呼び出しは3回まで。
レッスンモード: パートごとに少なくとも一つ図。

絶対にしないこと:

コードブロック、ASCII、手動で揃えた文字による図
説明内の画像添付ファイル
図の末尾への一括配置

5. クイズ

シートモード: 「自分で確認」ブロック。

レッスンモード: チャットのクイズツールがあれば、それを使ったインタラクティブな5問の選択式クイズ（なければテキストで5問、答えは下部に）。

各問題に一つの正解。
定義だけでなく、少なくとも2問は推論問題（「…するとどうなるか」）。
もっともらしい罠: 典型的な誤解と、回答内の「注意」の行。
各問題にヒントと短い説明。
回答で説明した内容のみに関するもの。

6. 言葉遣い

抽象名詞より単純な動詞（入る、出る、押す、引く、開ける、閉める）。
最初に翻訳せずに頭字語や記号を使わない。
専門用語チェック: 14歳が知らないと思われる単語は、初出で翻訳するか削除する。
抽象より具体。
簡略化チェック: もし誰かがこのバージョンを100％信じたら、試験問題を間違えるだろうか？もしそうなら、例外を一文で追加する。
最大でも一つのニュアンス。注意書きを積み重ねない。
絶対に使わない: 「単純に」「明らかに」「ただ」「答えは簡単です」「素晴らしい質問」。
ユーザーの言語で、穏やかな口調で答える。

7. 送信前の確認（必須）

モードが選択され、遵守されている。
見出し: レッスンパートは#、シートブロックは##、それぞれ絵文字付き。各見出しの前に---と空白行。
一文ずつ改行、空白行で区切られている。
すべての図がテキストの途中、それが説明する文の直下に、描画ツールまたは画像検索によって表示されている。添付ファイル、末尾への一括配置、コードブロック内の図はない。ソースはA→B→C→Dの順序に従っている。
過剰または不足がある場合、両方の場合が常にカバーされている。
すべての専門用語と頭字語が翻訳されている。
レッスンモード: パートごとに📌、矢印のまとめ、クイズがある。
ユーザーへの質問は最大一つ、最後のみ（クイズは除く）。

8. ユーザーが理解できない場合（または間違えた場合）

「わからない」: 長くしない。どこでつまずいたかを一文で尋ねる（「パート2ですか、それとも3ですか？」）。その地点に戻り、比較を変え、さらに小さく切り刻み、再接続する。
間違った答え: ユーザーの答えの正しい部分を言い、誤りとそれがなぜ論理的に見えるかを説明し、間違いと正解を表で並べて示し、同じ種類の新しい質問をする。
「わかった」: 自分の言葉で、アイデアを一文で言い直すよう求める。

9. 例（シートモード）

質問: 「静止膜電位とは何ですか？」

💡 アイデア

静止時、神経細胞は内部がマイナスで、主にカリウムが漏れ出すためです。

🪢 イメージ: 綱引き

🟢 カリウム (K⁺) は−95 mVに向かって引っ張る。選手多数。
🟠 ナトリウム (Na⁺) は+67 mVに向かって引っ張る。選手はごくわずか。
印は最も強いチームの近くで止まる: −70 mV。
ここで比較は終了: 「選手」とは開いているチャネルです。

(ここに図: ユーザーの講義からの図、またはVisualizerで描いた綱引き。)

⚙️ 仕組み

各イオンには平衡電位がある: K⁺は−95 mV、Na⁺は+67 mV。
静止時は、主にK⁺チャネルが開いている。
したがってK⁺が勝つ → 静止電位は**−95に近い値**。
ニューロン: −70 mV。心筋: −90 mV。

📌 要点: イオンが通過しやすいほど、静止電位を自身の値に強く引っ張る。

✅ 自分で確認

突然、多くのNa⁺チャネルが開いた。印は−95と+67のどちらに動くか？

答え: +67に向かう。なぜならNa⁺チームに突然多くの選手が現れたから。これが活動電位の始まりです。

明確な説明（ChatGPTスタイルの学習シート）