amosblomqvist/learn：pi AIエージェントで作るパーソナル学習システムの全貌

「AIで何かを学ぶ方法」を題材にしたYouTube動画がバイラルとなり、GitHub上で1744スターを獲得したリポジトリが amosblomqvist/learn だ。これは人気AIコーディングエージェントフレームワーク「pi」（earendil-works/pi）向けに設計されたパーソナル学習設定パッケージであり、クイズ・リサーチエージェント・視覚的ダイアグラム生成を一体化した「自分専用AI家庭教師」を即座に構築できる。

amosblomqvist/learnとは：pi AIエージェント向けの学習システム設定

amosblomqvist/learnは、AIコーディングエージェントフレームワーク「pi」（earendil-works）の設定ディレクトリ（.pi）として動作するリポジトリだ。作者のAmosblomqvist（Eero Alvar）が自分用に構築したAI学習システムを、OSSとして公開したものである。

pi フレームワークとは

piはMario Zechnerが開発し、2026年5月にEarendil Worksへ移管されたオープンソースのAIコーディングエージェントフレームワーク。TypeScript拡張・スキル・プロンプトテンプレートでカスタマイズでき、Claude/GPT/Gemini等の複数LLMに対応する。Claude Codeが「即使える」ツールであるのに対し、piは「作って使う」ハーネスとして設計されており、エージェントの動作そのものを拡張できる点が特徴だ。

learnシステムの構成要素：4つのスキルと3つのエージェント

amosblomqvist/learnは以下のコンポーネントで構成されている。

スキル（スキルファイル）

スキル	機能
`teach.md`	教育哲学・学習プロセスの定義（クイズ前後の確認フロー等）
`visualize.md`	概念をダイアグラム（SVG/Mermaid）で視覚化するタイミングと手法を定義

拡張機能（Extensions）

拡張	機能
`ask-user-question`	UIポップアップで学習者に質問を表示する（クイズUI）
`quiz`	採点付きクイズ（正誤・正答・解説を即時フィードバック）
`md-log`	学習セッションをMarkdownファイルに自動記録
`visualize`	視覚化サブエージェントのツールセット

エージェント（サブエージェント）

エージェント	役割
`researcher`	学習内容の事実確認・深掘り調査を担当
`svg-maker`	SVGダイアグラム生成
`mermaid-maker`	Mermaidフローチャート生成

amosblomqvist/learnのインストールと基本的な使い方

インストール：git clone のみ

このリポジトリ自体が .pi ディレクトリとして機能する。

# 学習したいプロジェクトのルートでクローン
git clone https://github.com/amosblomqvist/learn .pi

# piを起動（learnsystmが自動ロードされる）
pi

前提条件

pi フレームワーク：npm install -g @earendil-works/pi でインストール
サブエージェント実装：pi-interactive-subagents（tmux必須）を推奨。これにより researcher・svg-maker・mermaid-makerが動作する
ask-user-question 拡張：このリポジトリにバンドルされたものを使用（既存の実装がある場合は置き換える）

学習セッションの流れ

学習したいトピックをpiに入力（例：「Reactのusual hooksを教えて」）
teachスキルが教育哲学に基づいて学習プロセスを制御
researcherエージェントが事実確認と補足情報を収集
概念が複雑な場合、svg-makerまたはmermaid-makerが視覚化ダイアグラムを生成
quiz拡張が採点付きクイズを実施
md-logが学習記録を自動保存

学習記録の活用

md-log 拡張が生成するMarkdownファイルには、学習日時・トピック・クイズの正答率・LLMが生成したサマリが含まれる。これを Obsidian や Notion に取り込んで二次利用することも可能だ。

# 生成された学習ログの例（.pi/logs/2026-09-14_react-hooks.md）
## 学習セッション: React hooks
- 日時: 2026-09-14 09:00
- クイズ正答率: 4/5
- researcherエージェント参照先: React公式ドキュメント v19

類似ツールとの違い：なぜ今このアプローチなのか

Anki・Duolingo・Courseraとの差別化

特徴	amosblomqvist/learn	Anki	Duolingo	Coursera
学習コンテンツ	任意（自分で指定）	フラッシュカード	語学のみ	固定カリキュラム
カスタマイズ	コード編集で自由	デッキ作成のみ	不可	不可
コスト	無料（LLM API費のみ）	無料～有料	無料～有料	月額有料
学習スタイル	対話型・探索的	繰り返し記憶	ゲーミフィケーション	動画講義

最大の差別化ポイントは「任意のトピックを即座に教育コンテンツ化できる」点だ。新しいAPIドキュメント・数学的概念・業務知識など、既存の学習プラットフォームにはないコンテンツも即座に学習対象にできる。

GitHub Copilot・Claude Code との違い

Claude CodeやGitHub Copilotはコーディング支援に特化しているが、amosblomqvist/learnは「知識の定着」に特化している。コードを書いてもらうのではなく、自分でコードが書けるようになるための学習システムだ。

こんな人に向いている：活用対象者と具体的なシナリオ

ソフトウェアエンジニア：新技術の高速キャッチアップ

新しいフレームワーク・ライブラリ・技術をキャッチアップしたいソフトウェアエンジニアに向いている。例えば、Rustを初めて学ぶバックエンドエンジニアが、リサーチエージェントに最新の所有権システムを調査させ、クイズで知識を定着させるシナリオが典型的だ。

データサイエンティスト：概念の視覚的理解

確率論・線形代数・ベイズ統計など視覚化が効果的な数学概念を学ぶデータサイエンティストにも有益だ。visualize スキルとmermaid-makerを組み合わせることで、抽象的な概念をダイアグラムで直感的に把握できる。

技術系学習者：自己ペース学習の記録

md-log拡張によって学習セッションが自動的にMarkdownファイルに記録されるため、学習の進捗を振り返ったり、後からノートを参照したりすることが容易になる。エンジニアリングブログ・個人ノートに転用もできる。

使う前に知っておきたいこと：制限と注意点

技術的制限

pi フレームワーク必須：Claude Code・Cline・Cursor等では動作しない。piを別途インストールする必要がある
サブエージェント機能はtmux必須：pi-interactive-subagentsはtmux環境でのみ動作する。Windowsネイティブ環境では設定が複雑になる
個人向け設計：「The teaching skill is written for one learner (me)」と明記されており、自分の学習スタイルに合わせた編集が前提

活用上の注意

LLM API費用が発生する：piはClaude/GPT等のLLM APIを使用するため、学習セッション量に応じたAPI費用がかかる
ask-user-question 拡張の排他性：既存のpi設定にask-user-questionがある場合、このリポジトリのものに置き換える必要がある
サブエージェントなしでも動作する：researcher・visualエージェントは省略可能。メインセッションのみで基本的な教育機能は使える

まとめ：AIで学ぶ新しいパラダイム

amosblomqvist/learnは、汎用のAIコーディングエージェントを「専門的な学習支援システム」に変身させる設定パッケージだ。git cloneのみで導入でき、TypeScriptでスキルを編集するだけで自分流にカスタマイズできる。piフレームワークを使い新しい学習アプローチを探しているソフトウェアエンジニア・技術系学習者に強くお勧めしたい。

この技術を学ぶ

AI・機械学習に興味を持った方には、UdemyのAI関連コースもおすすめです。

🎓 AIカテゴリのコース一覧 — セール時（最大90%OFF）を狙うとお得です