Repolode
hahhforest

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. 1

    教科書のリポジトリをクローンする

    git clone https://github.com/hahhforest/pi-textbook.git
  2. 2

    プロジェクトディレクトリに移動する

    cd pi-textbook
  3. 3

    依存関係をインストールする

    npm install
  4. 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 の数値は毎日更新されます。

関連プロジェクト