7.5
深览指数
产品人人都是产品经理·张佳的AI实战笔记··AI 生成
详细拆解 Pi Agent：产品经理搞懂 Agent 的最佳实践
作者把 OpenClaw 底层框架 Pi Agent 从会话循环、上下文装配、工具系统、状态管理到安全边界逐层拆开，提炼出 7 条可迁移的 Agent 产品原则，核心判断是「做 Agent 产品调的不是模型而是循环」。真正的增量在于它不止讲架构，而是把每条设计取舍（四个工具、不内置 MCP/Plan/子 Agent/权限弹窗、压缩只插条目不删记录）都还原成可判断的产品决策，适合想弄懂 Agent 机制而非堆功能的产品经理。尾部含课程软广，需自行过滤。原文 ↗
核心观点
- ▍做 Agent 产品，你调的不是一个模型，而是一个循环；模型只是这个循环里最显眼的一环。
- ▍最小内核 + 可编程扩展：不确定的产品判断不应写进内核，而应做成扩展点，把不确定性外包给生态。
- 01Pi 的系统提示词加全部工具定义不到 1000 token（Claude Code 的系统提示词就超 10000 token），默认只给 read/write/edit/bash 四个工具。
- 02Pi 拒绝内置 MCP：Playwright MCP 有 21 个工具、占 13700 token，还没干活就吃掉 7%–9% 上下文；替代做法是「写 CLI 工具配 README」，成本降到 225 token。
- 03循环分双层：纠偏（steering）在当前工具调用结束后立刻插入，追加任务（follow-up）等当前轮彻底干完再进；abort 后未发出的消息回到输入框。
- 04工具错误全部降级为一条工具结果消息回注给模型，既是协议要求（每次工具调用必须有对应结果），也因为错误文本是模型自我修正最重要的输入。
- 05一条工具结果拆成三份：给模型看的截断结果（约 2000 行 / 50KB，附「怎么继续读」提示）、给人看的 diff 与耗时、给程序看的结构化字段。
- 06会话存为带 id 与 parentId 的 JSONL 树：/tree 在同一文件内跳节点、/fork 从某条用户消息开新会话、/clone 复制当前分支；压缩只插入一条新条目，原始记录永不删除。
- 07系统提示按 8 个具名段落固定顺序装配，技能只挂名字加一句话描述（渐进披露），扩展可按名字覆盖同名段落。
- 08安全上不内置权限弹窗：能读本地文件 + 执行代码 + 访问网络即构成 Simon Willison 的 lethal trifecta，弹窗只制造 permission fatigue；Mario 称大部分编程 Agent 的权限系统是「安全剧场」。
反方 / 局限
- — 作者承认留白策略有代价：用户要自己判断该加什么、该信任哪些第三方包，Pi 并不适合想要开箱即用的用户。
- — Pi 的「项目信任门」只控制启动时加载哪些项目资源，文档自己写明它不是安全边界；且 AGENTS.md/CLAUDE.md 无论是否信任都会加载。
- — Terminal Bench 前五、GitHub 从 2.4 万涨到 11.8 万 star 等数据来自作者自述，「缓存命中率常能到 100%」也仅援引个别用户反馈，均为未经独立核实的单方陈述。
Pi AgentOpenClawMario ZechnerlibGDXClaude CodeCursorTerminal Bench 2.0TerminusMCP（模型上下文协议）Simon Willisonlethal trifecta（致命三件套）渐变披露prompt cache（提示词缓存）
24 分钟 · 5 卡片 · 12 资料
读原文 →