pstack 架构拆解
H01 / 十层 · 最上面那层

它不是工具箱,
是一份反对意见

要先理解 pstack 为什么长成后面那九层的样子,得先看它在反对什么。 它反对的不是"agent 能力不足",而是agent 看起来很努力、实际交付不可信。 这一层没有任何文件,它是后面所有文件存在的理由。

图 1-1四个毛病,四组对策

左边是作者观察到的固定失效模式。右边是它们被翻译成的具体机制。箭头不是比喻——每一根箭头都能指到一个真实文件。

SYMPTOM 症状 MECHANISM 机制(真实文件) ① 话多 · AI 腔 总结、修饰词、客套话填满整屏 unslopSKILL.md · 6,015 字节 frontmatter 里写着 Must always apply. —— 无条件生效 ② 过度抽象 三行能写完,偏要建四个文件加两个接口 principle-laziness-protocol 判据:偏向删除,写最小的 diff。同类还有 23 条 ③ 自称完成 代码没跑过就说"搞定了",用编译通过当证据 principle-prove-it-works 禁止代理证据:要读真实产出、跑真实功能 ④ 事事问人 + 讨好 可逆的小事也来确认;被问意见时无脑附和 poteto-mode 的 Autonomy 节 "No is an acceptable answer." 原文要求坦率 四个症状都不是 bug,是模型的默认行为 对策全部写成文字,靠每次重新加载生效
图 1-1 · 症状 → 机制。橙色框属于 H04 总编排,青色属于 H06 原则层,蓝色属于 H07 能力层。

1-2为什么用"文字"当对策

看到"把工程判断写成 markdown",第一反应通常是:这不就是 prompt 吗,能可靠吗? pstack 的答案是——单靠一句 prompt 不可靠,所以它做了三件事。这三件事定义了后面每一层的形状。

机制一
拆小
一条原则只讲一个判据,24 条分开放。agent 每次只读相关的那几条,而不是一篇长文。
机制二
要出处
poteto-mode 原文要求:"name each principle that shaped a decision"。引用必须点名,于是你能核对它是否真的照着做。
机制三
无畏并行
README 提出 "fearless parallelism":当单 agent 能够先深扎("go deep first")且严格自证,多 agent 扇出才能真正并行。

1-3它明确不做的事

理解一个系统的边界,比理解它的功能更快。pstack 的四条边界:

本层的检验问题:你能否说出 pstack 反对的四个毛病,以及每个毛病对应的机制在哪一层? 答得出就往 H02 走——那一层解释这些文字为什么能"每次都被重新加载"。
上一站← 总览