pstack 架构拆解
第 11 站 · 收束

一个 bug 从被说出
到落盘,穿过十层

检验你是否真的理解 pstack,最好的办法是跟踪一次调用。 场景:你说"登录态过一会儿就掉,修一下"。下面每个编号都标了它发生在哪一层。

图 11-1完整轨迹

时间向下 · 右侧标层号 H03 入口 ① 你说出这句话 50 个技能摘要里的 poteto-mode 被语义命中(入口 B),正文进上下文 H04 根 ② 根文件先做两件事 Non-negotiables 命中"非平凡改动 → how";Playbooks 表匹配到 bug-fix H05 剧本 ③ 打开 playbooks/bug-fix.md,六步逐字抄进 todolist 不许凭印象复述——这一步保证流程不漂移 H06 原则 ④ 第 1 步复现:两条原则同时压上来 prove-it-works 禁止"看起来好了"当证据;fix-root-causes 要求先复现再问为什么 回复里必须点名这两条,并说明各自改变了什么 H07 扇出 ⑤ 影响面不确定 → 派 swarm 同一条消息里并行 spawn,worker 各查一片,父级只收 PASS / ISSUES / BLOCKED 动机是 guard-the-context-window:大批量原始输出不进主线 H08 模型表 ⑥ 查 swarm workers 该用哪个模型 没有 pstack-models.mdc → 落回技能默认值(由 /setup-pstack 生成) H07 评审 ⑦ 修完之后 interrogate:三个只读 reviewer 同一 prompt 同一 rubric,靠模型多样性产生对抗信号;结论分四桶:Act on / Consider / Noted / Dismissed 不自动采纳 —— 判断权回到你和代码 H05 + H06 ⑧ 第 6 步跳 opening-a-pr 剧本 PR 描述先过 technical-writing 再过 unslop;提交前 deslop,评审前 no-comments H10 落盘 ⑨ 只有两种情况才写文件 你说"我去睡了" → decisions.tsv 记决策链;停机安全 → pause-safely 写 /tmp/<slug>-resume.md 与 wip: commit 普通的一次性修复不落任何文件 —— 这层是按需的,不是常驻的 H01 H02 全程 在场 定位 与 格式 不产生 步骤, 只保证 这些 文件 能被 读到
图 11-1 · 九个事件。注意 H08/H09 只在派生子代理时才被触碰,H10 只在长任务时才被触碰。

11-2三层收束:一句话记住整个架构

H01–H03
为什么 + 用什么装
纯文字 + 渐进加载。决定了它零依赖、可移植、但无强制力。
H04–H06
谁调度 + 按什么判
根文件路由到剧本,剧本引用原则。流程与判据彻底分离,这是整套件的骨架。
H07–H10
怎么放大 + 怎么续
扇出放大判断力,模型表控制规模,宿主绑死 Cursor,落盘层保证可接手。

11-3自测:能答上这七题就算学会了

11-4想继续动手,三条路

动作得到什么风险
跑 /setup-pstack生成 H08 那张覆盖表(~/.cursor/rules/pstack-models.mdc),把角色模型固定下来低,只写一个配置文件
读 playbooks/bug-fix.md 全文看清一个剧本的真实文体,比看任何解释都直接无
挑一条 principle-* 让我照它做一次改动体验"引用必须点名"的审计效果低
最后一句判断:pstack 值得学的不是那 50 个技能,而是它的分层决定—— 把"判断标准"和"执行流程"分开,把"能移植的部分"和"必须重写的部分"分开。 前者让它可审计,后者让它活过了 runtime 的更替。
上一站← H10 磁盘状态