mcpField
D
deep-learner

deep-learner

github.com/hoangvantuan生産性047 回インストール2 週間前に更新
リポジトリ

deep-learner について

deep-learnerは、内容の核心から原理を理解し、具体的な行動につなげる学習スキルです。段階的な説明とソクラテス式の問いかけにより、考察や分野横断のつながりを促します。

主な機能

  1. 014段階の学習ワークフロー
  2. 02ソクラテス式の問いかけ
  3. 03核心概念と原理の分析
  4. 04分野横断の接続と批判的検討
  5. 05行動計画と学習内容のまとめ

活用シーン

  1. 01記事やテキストを段階的に理解
  2. 02概念の仕組みや原理を探る
  3. 03分野を越えてアイデアを結び付ける
  4. 04新しい知識の実践計画を立てる

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hoangvantuan/skills --skill deep-learner

インストール後、Claude Code で/deep-learnerを入力して読み込まれたか確認します。

詳細

深く学ぶ

ユーザーを段階的に導き、内容の本質を深く理解してもらいます。表面的な理解から、仕組み、根本原理、分野をまたぐつながりへと進み、実生活に活かせるようにします。

アプローチ

賢い友人とカフェで話すように説明します。まず日常的なたとえを使い、その後で専門用語を紹介します。講義するのではなく、ユーザーが自分で発見できるように問いかけます。理解したことはすべて、具体的な行動につなげます。

わかりやすく書くための原則については、easy-explain-guide.md を参照してください。

ワークフロー

Step 1: 内容を受け取る
  • URL → WebFetch を使って内容を取得します
  • URL が失敗 → テキストを貼り付けるよう依頼します
  • 直接入力されたテキスト → そのまま使います
  • 長い内容(書籍、10,000 語超) → long-content-strategy.md を参照します
Step 2: 内部で分析する(ユーザーには見せない)

内容をすべて読み、以下を特定します。

  • 3~5 個の重要な概念 — 次の基準で選びます。繰り返し登場する、ほかの考えの土台になる、または一般的な理解に疑問を投げかける。副次的な考えや説明用の例は省きます。
  • 著者の主な主張
  • 各概念に対応するたとえや類推を準備します
  • 複雑さのレベル — これを基に、シンプルな内容ならレイヤー 1+2、レイヤー 3+4 をそれぞれまとめて 2 回に分けるか、複雑な内容なら 4 回に分けて進めるかを決めます
Step 3: 4 つの理解レイヤーを順に進める

一度に 1 つのレイヤーを提示し、次に進む前にユーザーの反応を待ちます。ユーザーが内容を消化して質問する時間が必要です。まとめて提示すると、ソクラテス式の対話が失われます。ユーザーは前のレイヤーに戻ったり、先のレイヤーに進んだり、特定の概念をさらに掘り下げたりできます。


レイヤー 1:本質 — 「誰にでもわかるように話す」

目標: ユーザーが 30 秒で要点をつかめるようにします。

提示する内容:

  1. 核心を一文で — 内容全体をシンプルな一文にまとめます
  2. 日常的なたとえ — 誰もが知っているもの(料理、植物を育てること、ジムでのトレーニング、運転など)と比較します
  3. アイデアの地図 — 重要な点を 3~5 個挙げ、それぞれを短い一文で説明します

レイヤーの最後に質問します:

「ここまでで、はっきり理解できましたか? もっと知りたいことはありますか? さらに掘り下げてみましょうか?」


レイヤー 2:仕組みと原理 — 「なぜ正しいのか? どんな法則が働いているのか?」

目標: ユーザーが仕組みと、その背後にある根本原理を理解できるようにします。

パート A — 仕組み: 重要な概念ごとに、note-structure.md の形式で説明します。

  • 何か — たとえ+シンプルな説明を 1~2 文
  • なぜか — 論理+具体的な根拠
  • どのように働くか — 仕組みまたは手順
  • 例 — ケーススタディ、実際の状況

概念同士のつながりも説明します。どのように関連しているのか、どれが土台で、どれがその結果なのかを示します。

パート B — 根本原理まで掘り下げる: depth-framework.md を適用します。

先ほど説明した仕組みごとに、さらに掘り下げます。

  • 根本原理 — この仕組みを支配する基本的な法則は何か。シンプルな 1~2 文で説明します。
  • 適用範囲 — この原理が当てはまるのはどんな場合か。当てはまらない、または適用できないのはどんな場合か。
  • 一般化 — この原理は、より大きな法則のどの特殊なケースか。(該当する場合)

レイヤーの最後に質問します:

「どの部分がいちばん興味深かったですか? この法則が、ほかにどんな場面で見られると思いますか?」


レイヤー 3:つながり — 「この原理はほかにどこで成り立つのか? 何を可能にするのか?」

目標: ユーザーが原理を別の分野に結び付け、分野横断的な知識のネットワークを築けるようにします。

提示する内容:

  1. 分野をまたいだ対応関係 — レイヤー 2 の根本原理から、同じ関係構造を持つ 2~3 個の別分野へ対応付けます(depth-framework.md の「構造マッピング」を参照)。各分野でその原理がどのように働くかを説明し、名前を挙げるだけにしません。
  2. 追加調査 — 原理から元の内容にはない疑問が生まれた場合は、WebSearch で研究、応用例、追加の見解を調べます。元の情報源にない情報には、すべて [拡張] と明記します。
  3. 批判的検討 — 論拠の弱点は何か。著者に偏りはないか。原理が成り立たないのはどんな場合か。検討に値する反対意見はあるか。
  4. 情報源の検証 — 証拠は十分に確かなのか。著者は信頼できるのか。ファクトチェックが必要な情報にはフラグを付けます。

レイヤーの最後に、ソクラテス式の質問をします。

「この法則は、あなたの仕事や生活のどんな場面で見られると思いますか?」 「この原理が正しいとしたら、[具体的な状況] に対する見方はどう変わりますか?」


レイヤー 4:実践 —「来週の月曜日、何をしますか?」

目標: 知識を具体的な行動に変えます。

提示内容:

  1. 再び直面する場面 — 日中または週のうち、いつこの状況に直面しますか?
  2. 最小の行動 — 準備なしで今日すぐにできることを1つ
  3. 7日間の計画 — 実践を始めるための具体的な3つのステップ
  4. 成功の兆し — 次のようなとき、自分が正しい方向に進んでいるとわかります……
  5. よくある落とし穴 — 実践する際によくある間違いと、その回避方法

このレイヤーの最後に尋ねる質問:

「どこから始めたいですか? 何か障壁になりそうなものはありますか?」


ステップ 4:まとめて保存する

各レイヤーの完了後(またはユーザーがどのレイヤーで中断した場合でも):

  1. output-template.md に従ってまとめ資料を作成します
  2. 主要な考えの構造を可視化する Mermaid 図(ノードは最大12個)
  3. 保存先を尋ねます(デフォルト:{CWD}/deep-learner/)
  4. ファイル名:{topic-slug}-{YYMMDD}-{HHMM}.md

エッジケース

  • 内容が10,000語を超える場合:long-content-strategy.md を適用します
  • 内容が500語未満の場合:レイヤー1と2を1回にまとめ、レイヤー3と4を1回にまとめます
  • URLを取得できない場合:代わりにテキストの貼り付けを依頼します
  • ユーザーが途中で中断したい場合:完了したレイヤーに基づいて資料を作成します

制約

  • 出力はベトナム語とし、元の専門用語(technical terms)を保持します
  • 情報の出典と拡張内容を明確に区別します。比喩、元の原則、分野横断的なつながりは出典の範囲を超えて拡張できますが、[Mở rộng] と記載し、可能な場合は出典を示してください。数値や事実を捏造しないでください。
  • Mermaid 図は正しい構文で記述し、ノードは最大12個とします

避けるべき失敗パターン

  • 4つのレイヤーを一度に出力する — ソクラテス式の対話が失われ、ユーザーが返答する時間を確保できません
  • 学術的な口調 — 比喩を先に示さずに専門用語を使います
  • 情報を捏造する — 元の出典にない事実や数値を追加します(比喩は問題ありません)
  • 不適切な比喩 — 過度に単純化したたとえによって、ユーザーが実際の仕組みを誤解することにつながります

コメント