xiaomoBoy/pi-bluebook

What it solves

Pi 学习蓝皮书は、中国語の初心者向けの非公式学習マニュアルであり、まったく経験のない人がゼロから Pi Coding Agent（ミニマルなターミナル Coding Harness）を習得できるように支援します。解決する中心的な問題は、公式ドキュメントが散在し、用語が多く、初心者がどこから始めればよいかわからず、Agent が本当にタスクを完了したかを検証する方法もわからないことです。この本は、実際に操作可能な学習ルートを通じて、読者がまず小さなタスクを完了し、結果を独立して確認し、その後、セッション、コンテキスト、拡張機能、長期ワークフローを段階的に理解できるようにします。機能リストを暗記するだけではありません。

How it works

本書は「シナリオ → 概念 → 実践 → 検証」の構造で構成されており、各レッスンで読者が実際にコマンドを実行し、出力を確認することを要求し、Agent が「完了した」と自称することを完了とはみなしません。メインラインは macOS をベースとし、Windows ユーザー向けに独立した Git Bash 中国語インストールパスも提供します。内容は、導入、序章、5 つのモジュール（全 14 課）、さらに原理を結びつける 1 つの記事と 8 つの付随ケースで構成され、インストール、ログイン、最初のタスク、セッションとコンテキスト管理、Skill と Extension、サブ Agent の役割分担、長期タスクと安全な検証をカバーしています。変更されやすいバージョン、認証、モデル、コマンド情報にはすべて検証日が記載され、Pi 公式ドキュメントとソースコードが基準となります。リポジトリ自体は VitePress ウェブサイトであり、ローカルで実行してプレビューでき、Pi やモデルアカウントのインストールは不要です。

Who it’s for

主に中国語の初心者、特に Pi Coding Agent に初めて触れる人、ターミナル操作に不慣れな人、または Agent のワークフローに困惑している人を対象としています。また、Pi を起動できるが、セッション、コンテキスト、拡張機能、安定したワークフローを体系的に補完したい読者にも適しています。コードが書けなくても、問題のフィードバックや実践記録の追加を通じて、この本の改善に参加できます。

Highlights

• 実際の学習ルート：抽象的な機能リストではなく、インストール、ログイン、最初の検証可能なタスクから始めます
• 独立した検証を重視：各レッスンは「シナリオ → 概念 → 実践 → 検証」で展開され、結果を自分で確認することを要求します
• 中国語に親しみやすい：macOS と Windows Git Bash の両方のパスを提供し、コマンドと操作説明を分けて配置します
• 継続的な検証と更新：バージョン、認証、モデル、コマンドなどの変更されやすい情報に検証日を記載し、公式ドキュメントとソースコードを基準とします
• 完全なパス：5 つのモジュール、14 課、1 つの原理記事、8 つの付随ケースで、入門から安全な検証までをカバーします
• コミュニティ保守：詰まった場所、無効なコマンド、不足している資料、間違ったリンクの指摘を歓迎します。貢献者はコードを書く必要はありません