极简系统提示词、四个工具够用论、上下文工程至上,以及 pi "坚决不做"的功能清单——理解 pi 为什么长成这样。

pi-ai(LLM 统一抽象)→ pi-agent-core(事件驱动 agent loop)→ pi-coding-agent(终端 harness),逐层讲透职责与接口。

十章递进式实战:从一次裸 fetch 调用开始,逐章加入工具、流式、会话树、上下文压缩,最终用 pi 官方包重构出 mini-pi。

带着地图读源码:coding-agent 的目录结构、工具实现细节、会话与运行时如何组装出四种运行模式。