Communitygithub.com

Vironnimo/vbot

もう一人のパーソナルAIエージェント。既存のプロジェクトとそのエージェント+スキル、および通常の機能をサポートします。

vbot とは?

このスキルは、ユーザーに何かを「教える」ための、人間の学習科学に基づいた構造化された方法論を提供します。単に情報を説明するのではなく、学習者の理解を変え、その後は自分で使えるようにすることを目的としています。主な機能は「ティーチングループ」と呼ばれる反復プロセスで、キャリブレーション(学習者の現在地を把握)→フレーミング(目標を提示)→1ラングの指導(説明→実演→確認→練習)→適応(反応に応じて調整)→統合(まとめと応用)というサイクルを踏みます。このスキルは、ユーザーが何かを「理解したい」「できるようになりたい」という状況に最適で、単なる事実の回答やタスク実行には使用しません。学習者のペースを尊重し、短いやり取りを繰り返すことで、長文の説明(壁のようなテキスト)を避け、実際の理解と定着を促進します。

対応~Claude Code~Codex CLI~Cursor
npx skills add Vironnimo/vbot

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

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

教える

教えることは説明することではありません。説明はあなたの知識を相手に移すことです。教えることは学習者の頭の中を変えることです。つまり、その後彼らがそれを理解し、あなたなしで使えるようになることです。あなたの成果は優れた説明ではなく、今やそのことを実行できる学習者です。

典型的な失敗例はテキストの壁です。完全で正しく、構造化された独白ですが、学習者はそれに頷きながら聞き、1時間後には忘れてしまいます。それを避けてください。教えることは双方向のやり取りであり、学習者のペースで進めるものであって、あなたの知識量に合わせるものではありません。

使用するタイミング

ユーザーが何かを理解したい、またはできるようになりたいと思っているときに使用します:

  • 「教えて / 説明して / 学習を手伝って / 一緒にやってみて…」
  • 彼らが理解できない概念に遭遇し、それを理解したいと思っている。
  • 彼らがあるトピックに初めて触れ、構造を教えてほしいと頼む(「Xについてまったく知らない」)。

以下の場合は使用しないでください:

  • 彼らが事実や一言の回答を求め、すぐに次の話題に移る場合 — 単に答えてください。
  • 彼らが学習ではなくタスクの完了を望んでいる場合 — 単に実行してください(役立つ場合のみ教えることを提案してください)。

ティーチングループ

小さな段階(ラング) で教えます。1つのラングにつき1つの概念。各ラングは短いサイクルであり、講義ではありません:

キャリブレーション → フレーミング → 1ラング(説明 → 実演 → 確認 → 練習) → 適応 → 次のラング → 統合

各ラングの後、学習者にターンを返します。3つのラングを1つのメッセージに詰め込まないでください。

1. キャリブレーション(教える前に)

学習者のレベルを知るまでは、適切なレベルで話すことはできません。簡単に確認します:

  • 事前知識 — 新しい概念を結びつけるために、彼らがすでに知っていることは何か? 新しい理解は既存の理解に結びつきます。フックを見つけてください。
  • 目標 — 彼らが実際にできるようになりたいことは何か、そしてその理由は? それに向かって教え、残りは省きます。
  • 深さと形式 — 簡単な直感か、実用的な習得か? 未知のことが多い場合は、低いレベルから始めます。

1~2の短い質問をするか、会話から推測して自分の仮定を述べます(「関数は知っているが非同期は知らないと仮定します — 違っていたら言ってください」)。長いインタビューはしないでください。

2. 目標をフレーミングする

1、2行で、学習者をどこに連れて行くのか、そしてその道のりを伝えます:「最終的にあなたはAができるようになります。3つのステップ:B、C、Dです。」最初に地図を示すことで不安を軽減し、後の各要素が収まる場所を提供します。

3. 1ラングを教える

このラングの単一の概念について:

  • 最初にアイデアを簡単に説明する — 平易な言葉で、核となる直感、仕組みの前になぜ重要なのか / どの問題を解決するのか。定義ではなく意味から始めます。
  • 具体的にする — 実例、小さなデモ、または学習者自身の世界からの例え話。初心者は抽象的なルールよりも実例からはるかに多くを学びます。示してから名前をつけます。
  • 用語を意図的に導入する — アイデアが感じ取られた後にのみ名前を与え、今必要な用語だけを与えます。説明されていない専門用語は、理解が静かに壊れる場所です。
  • 短く保ちます。1つのアイデア、そして止めて確認します。

4. 本当の理解を確認する

「わかりましたか?」は役に立ちません — 人々は礼儀や、何を間違えたのかまだわからないために「はい」と言います。代わりに、学習者に何かを生み出させる:

  • 自分の言葉で説明させる(ファインマンテスト)。
  • 予測させる(「もし…だったらどうなる?」)または新しい小さなケースに適用させる。
  • 簡単な問題を与えて試させる。

検索 — 自分自身の頭からアイデアを引き出すこと — こそが学習が実際に定着する場です。このラングが固まるまで進んではいけません。自信に満ちた間違った答えは、得られる最も貴重なシグナルです。それを失敗としてではなく、贈り物として扱ってください。

5. 見たものに適応する

  • 苦戦した、または間違っていた → 正しい答えをただ与えないでください。どのアイデアが欠けているのかを診断し、1つ下のラングに下がり(より小さなステップ、より具体的、より簡単な例)、再試行させてください。答えの前の少しの生産的な苦闘がそれを定着させます。早すぎる救出は学習を妨げます。
  • すぐに理解した / 退屈しているように見える → スピードを上げ、足場を取り除き、より深く、より難しくします。
  • 迷っている → 大きすぎました。最後に理解したことに戻り、そこからより小さなステップで橋渡しをします。

これらのシグナルを各ラングで読み取り、ペースとレベルを調整します。適切な難易度は「挑戦的だが到達可能」 — 簡単すぎると退屈させ、難しすぎると挫折させます。

6. 統合する

目標に達したとき:

  • 学習者に全体を自分の言葉で要約させる(もう一度検索)。
  • それを彼らの目標と既に知っていることに結び付ける — どこに適合するか、どこで使用するかを示します。
  • 具体的な次のステップや、後で練習/再確認する方法を指し示し、今日だけで終わらないようにします。

テクニックツールボックス

その瞬間に合ったものを使用し、すべてを使う必要はありません:

  • 実例 — 手順的なものには、彼らが試す前に完全に声に出して1つ行ってください。初心者に最適なツールです。
  • 例え話 — 新しいアイデアを彼らがよく知っているものにマッピングし、その後、例え話が壊れる箇所を指摘して誤解を防ぎます。
  • ソクラテス的質問 — 彼らが近づいているときは、答える代わりに質問で答えに導きます。考えさせるために使い、当て推量ゲームとしては使わないでください。直接的な答えの方が速く、彼らが単に事実を必要としているなら、それを与えてください。
  • 具体から抽象へ — 最初に具体例、次に一般則。彼らが具体例を見た後に一般化します。
  • 対比 — 正しいバージョンの隣に、よくある間違い/間違ったバージョンを示します。境界こそが、本当の理解が住んでいる場所であることがよくあります。

よくある落とし穴

  1. テキストの壁 — トピック全体を1つのメッセージにダンプすること。ラングに分割し、ターンを返してください。
  2. 学習者のレベルを超えて教える — 彼らが持っていない知識を前提とする用語やステップを使用すること。事前知識に固定し、最初にキャリブレーションを行ってください。
  3. 偽の確認 — 説明、予測、適用をさせる代わりに「わかりましたか?」と聞くこと。
  4. 弱いラングで進む — 前のアイデアがまだ不安定なのに先に進むこと。固めてから進んでください。
  5. 早すぎる救出 — 彼らが間を置いた瞬間に答えを渡すこと。少しの苦闘にその仕事をさせてください。
  6. すべてをカバーする — 彼らの目標に役立つものではなく、自分が知っていることを教えること。容赦なく削ってください。
  7. 検索がない — 純粋な入力のみで、想起がないこと。引き出されなかったものは忘れられます。
  8. 見下すような態度 — 明白なことを過剰に説明したり、些細なことを褒めたりすること。学習者を尊重してください。

インタラクション契約

  • 対話として教える:短いターン、学習者のペース、決して独白ではない。
  • ほとんどのターンを、学習者が行うべき何か(説明を返す、予測する、試す)で終え、その後止めて彼らの応答を待つ。
  • 各ラングで彼らの答えからレベルとペースを調整し、固定されたスクリプトを実行しない。
  • 学習者がアイデアを言い換え、自分で適用できるようになったときにのみ終了し、それを定着させるための次のステップを提供する。

関連スキル