01 / Architecture

五层,不是一张技能目录。

把 pstack 看成文件夹,你会以为它是插件。把它看成组织,你会看见每层只做一种决策。混层是自己搭 stack 时最常见的失败。

Mode

策略层

poteto-mode 是控制面,不是百科全书。它只做路由、策略和文风。它知道「跨函数边界要先 architect」「并行覆盖用 swarm 不用 arena」。它不包含修 bug 的每一步。那些在 playbook 里。

每一层只回答一个问题

价值层回答「什么叫做好」。策略层回答「这是哪种工作,该走哪条纪律」。流程层回答「这类工作不可省略的步骤是什么」。工序层回答「这一步具体怎么做」。执行层回答「谁做、用哪种模型、写到哪里」。

一个文件不该同时当原则、路由表和实现手册。poteto-mode 很大,但它仍然只持有索引和触发器。原则全文在叶子技能里。修 bug 的复现步骤在 Bug fix playbook 里。竞技的嫁接规则在 arena 里。

原则是判断启发式,不是装饰

21 条原则可以分成几簇。缩小代码:懒惰协议、先减后加、降低阅读负荷。塑造结构:为领域建模、边界纪律、类型纪律、幂等。定义证据:证明它能工作、修根因、把工作切成可验证单元。委托:保护上下文窗口、不要堵在人身上。元层:把教训编进结构,而不是再写一遍叮嘱。

使用方式不是 /laziness-protocol。你在任务中途叫它的名字,用来转向。回复必须说出它改了哪个决定。只重复名字不算。

Playbook 是任务类型,不是清单模板

调查停在被引用的答案。Bug 必须先复现。功能从数据形状开始,跨边界先 architect。重构先记录现有行为。性能先有基线。Hillclimb 是对一个指标的多轮假设,不是一次性加速。Prototype 用最小抛弃物回答经验问题,避免把本该实验的事丢给人类。

长任务另有一层。Autonomous run 驱动一个谓词直到成立。Orchestrate 是多日、多 PR、车队级协调。Autopilot 处理队列。这些不是「听起来很大就上」。一个代理能在本轮预算里做完的,不要升级成项目。

规模纪律

不是每个改动都配得上整套仪式。改一个配置、挪一个日期,不需要竞技场和决策日志。边界交叉、难回退、过夜无人值守,才把梯子往上爬。

自己搭的时候,先写最小梯子:调查、修缺陷、做功能、验证、一次第二意见。等某种失败重复出现,再加一层。pstack 的体积来自两年内部失败,不是来自「技能越多越强」。