エージェント構築に役立つ、Pi-Agent SDKのバイリンガル解説とサンプルコード、AIアシスタント向けスキル
hahhforest/pi-textbook
TypeScriptでPi風のコーディングエージェントを作る手順を、15個の実行可能なGitチェックポイントで学べる中国語の教科書。
- スター
- 1,407
- フォーク
- 83
- 未解決の Issue
- 1
- 最終コミット
- 3 か月前
これは何?
TypeScriptでPi風のコーディングエージェントをゼロから構築するコースです。オフラインのエージェント軌跡から始め、各チェックポイントでメッセージとモデルのプロトコル、ストリーミング、プロバイダーアダプター、ツール、エージェントループ、セッションツリー、コンテキスト圧縮、拡張機能、スタンドアロンの評価ハーネスを順に追加していきます。
各章には教科書の本文、コース用リポジトリの実際のコミット、的を絞ったテスト、障害注入の実験が含まれています。コースのコードは疑似コードではなく、各段階でチェックアウトして実行・検証できるGit履歴です。オンライン書籍としても、npmで構築するローカル開発サーバーとしても利用できます。
このコースは非公式のコミュニティ制作です。コードにはMITライセンス、教科書のコンテンツにはCC BY 4.0ライセンスが適用されます。また、学習エージェントと一緒に使うチェックポイントや演習用ディレクトリを準備する補助CLIも付属しています。
主な機能
- 01実際のコミットとしてチェックアウトして実行できるチェックポイントが15個あります。
- 02メッセージ型やストリーミングから、プロバイダーアダプター、ツール、エージェントループまでを一通り扱います。
- 03長い会話に対応するセッションツリーの永続化とコンテキスト圧縮を含みます。
- 04最後に、拡張機能システムと完成したエージェント向けのスタンドアロン評価を扱います。
- 05チェックポイントへの移動や、解答なしの演習用ディレクトリの生成に使えるCLIを提供します。
ユースケース
- 自分でコーディングエージェントを作りながら、その内部の仕組みを学ぶ。
- 判別可能なユニオン、イベントストリーム、ランタイム検証などのTypeScriptのパターンを、実践的なプロジェクトを通して学ぶ。
- AIチューターエージェントと併用する、ガイド付きの演習コースとしてチェックポイントを活用する。
クイックスタート
- 1
教科書のリポジトリをクローンする
git clone https://github.com/hahhforest/pi-textbook.git - 2
プロジェクトディレクトリに移動する
cd pi-textbook - 3
依存関係をインストールする
npm install - 4
ローカルの開発サーバーを起動する
npm run dev
使う前に知っておきたいこと
- 教科書は中国語で書かれているため、英語話者には主な内容が理解しにくい場合があります。
- コースのコードは別の fork ブランチにあるため、チェックポイントを実行するにはそのブランチをクローンする必要があります。
トピック
よくある質問
- pi-textbook とは?
- TypeScriptでPi風のコーディングエージェントを作る手順を、15個の実行可能なGitチェックポイントで学べる中国語の教科書。 TypeScriptでPi風のコーディングエージェントをゼロから構築するコースです。オフラインのエージェント軌跡から始め、各チェックポイントでメッセージとモデルのプロトコル、ストリーミング、プロバイダーアダプター、ツール、エージェントループ、セッションツリー、コンテキスト圧縮、拡張機能、スタンドアロンの評価ハーネスを順に追加していきます。
- pi-textbook は無料で使えますか?ライセンスは?
- pi-textbook は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- pi-textbook は今もメンテナンスされていますか?
- 半年以内に更新あり。pi-textbook の最終コミットは 2026年7月23日 です。
- pi-textbook は何に使えますか?
- 自分でコーディングエージェントを作りながら、その内部の仕組みを学ぶ。 判別可能なユニオン、イベントストリーム、ランタイム検証などのTypeScriptのパターンを、実践的なプロジェクトを通して学ぶ。 AIチューターエージェントと併用する、ガイド付きの演習コースとしてチェックポイントを活用する。
- pi-textbook のインストール方法は?
- 教科書のリポジトリをクローンする: git clone https://github.com/hahhforest/pi-textbook.git プロジェクトディレクトリに移動する: cd pi-textbook 依存関係をインストールする: npm install ローカルの開発サーバーを起動する: npm run dev
- pi-textbook はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/hahhforest/pi-textbook
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
Claude APIを使ったコーディングエージェントの作り方を、ファイル・シェル・検索ツールを順に追加しながら学ぶ、Goのハンズオンワークショップです。
Pi Coding Agentのターミナルハーネスを基礎から学べる、非公式の中国語ガイド
IDE拡張、ターミナルCLI、デスクトップアプリ、SDKとして動作するオープンソースの自律型コーディングエージェント。
LSP、デバッガー、ブラウザー、サブエージェント用ツールを内蔵し、60以上のモデルプロバイダーに対応するターミナル向けコーディングエージェント。