pi 系统学习手册 第 07 / 12 章 总目录 单页全本 架构图 GitHub

手册/第 07 章

07

刻意不做:五条「不」与它们的替代方案

这一节是 pi 与 Claude Code / Codex 分歧最大的地方,也是最容易被误解的地方。 每一条都不是「没做」,而是「想清楚了不做」。

不做理由(作者原话要点)替代方案
内置 TODO 列表 agent 自己写一个 TODO.md 就够了,不需要专门的工具和状态机 让模型用 write/edit 维护 md 文件
Plan mode 一个 PLAN.md 加一轮对话就是 plan mode,不需要第二套模式与状态 写 md + 人审 + 再执行
后台 bash 要进程追踪、输出缓冲、退出清理、向运行中进程发输入;且观测性差 tmux:可 attach、可列会话、可人机共调
Sub-agents 黑盒套黑盒,上下文传递不可控,出错难调 让它用 bash 再起一个 pi --print(可放 tmux 里)
MCP (已变化) 多数场景过重,工具定义常驻上下文开销大 CLI + README,按需阅读(渐进披露)

关于 MCP:一次公开的立场调整

博客里写得很绝对:

"pi does not and will not support MCP. […] MCP servers are overkill for most use cases, and they come with significant context overhead."
pi 不支持 MCP,将来也不会。……多数场景下 MCP 服务器属于杀鸡用牛刀,而且它们带来显著的上下文开销。
— 2025-11-30 博客

他给出的数字很有说服力:Playwright MCP 有 21 个工具、约 13.7k token;Chrome DevTools MCP 有 26 个工具、约 18k token。 也就是开工前 7–9% 的上下文窗口就没了,而其中大部分工具这次会话根本用不到。

但在当前仓库(commit 531340f,2026-10-27)里,MCP 已经是一等公民:

bash
pi mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem .
pi mcp add docs --url https://example.com/mcp --bearer-token-env-var DOCS_TOKEN
pi mcp list
# 会话内用 /mcp 查看连接、登录、重连、改暴露范围、启停

这个变化本身就是最好的学习材料:它说明「最小」不是教条,而是可以被真实需求推翻的假设。 值得注意的是实现方式——MCP 工具被当作工具命名空间注入(mcp__<server>__<tool>), 因此仍然服从统一的工具管线与 --tools 过滤,而不是另开一套机制。 这与「保持单一信任边界」的原则是一致的。

关于 sub-agent:不是否定,而是归位

"I'm not dismissing sub-agents entirely." / "models are still poor at finding all the context needed for implementing a new feature or fixing a bug."
我并不完全否定 sub-agent。/模型至今仍然不擅长找齐「实现新功能或修 bug」所需的全部上下文。

作者真正的观点比「不要 sub-agent」更锐利:在会话中途用 sub-agent 收集上下文,说明你没有提前规划。 正确做法是先在独立会话里把上下文收集好、产出成一份可复用的工件(artifact), 再开新会话带着它干活。这样既有完整可观测性,工件还能给下一个需求复用。

诚实提示 博客是 2025-11-30 的快照,仓库是 2026-10-27 的状态。两者有约 11 个月的差距。 本文所有「博客说」都标注了出处;涉及现状的都用源码或文档佐证。第 09 节专门列了差异表。

本章学习记录

记录仅保存在当前浏览器。