第18章:pstack:从 Cursor 到 Claude Code 的工程工作流

第18章:pstack:从 Cursor 到 Claude Code 的工程工作流

"If you want to go fast, go deep first."

「想走得快,先往深处走。」

—— Lauren Tan,pstack README

第 16 章的 agent-skills 把生产级工程纪律写成了一份份技能文件,第 17 章的图工程把并行编排从循环升级成了图。这一章看另一个方向的实践:有人把一整个工程团队的工作方式打包成了插件。它叫 pstack,作者 Lauren Tan,发布在 Cursor 官方插件仓库里。上线 8 个月,社区出现了两个移植:open-pstack 把它搬到 Claude Code 和 Codex,cstack 在 Claude Code 上长出了 46 个技能。三个项目共享同一套理念,也共享那句口号。

18.1 先深后广:一套工作流的理念

pstack 的作者 Lauren Tan(网名 poteto)是 React 核心团队成员,参与维护 React Compiler,此前在 Meta 和 Netflix 写过几百万行代码,现在在 Cursor 做工程。

她发布 pstack 时写了一段开场白。AI 生成的 slop 代码越来越多,她同意这个判断:「我不想像一支由 20 个 slop 写手组成的团队那样发布代码。没有质量的吞吐量不是我要的目标。想走得快,先往深处走。」

pstack 是她的答案。里面是她每天在 Cursor 写代码用的同一批技能,目标是把 Cursor 变成一支真正的工程团队。README 里把目标说得反直觉:pstack 帮你写更少的代码,质量更高。

这套工作流的另一半叫 fearless parallelism(无畏并行)。当你能把一个 agent 调教得可深挖、可信、产出可验证,才敢真的并行开多个 agent。pstack 的技能就是为此准备的:每个开起来的 agent 都按同一套工程原则干活。

效果有两个数字。她在 Denis Labelle 的访谈里自述,靠这套流程一个月合进了 1,000 个 PR;上线第一周,pstack 的技能被调用了 9,000 次,这是第三方统计。两个数字都出自宣传口径,听听量级就好。

pstack 发布在 cursor/plugins 仓库。这个仓库收官方插件规范和官方插件,2026 年 1 月创建,已有 8,700 多 star,pstack 是里面名气最大的插件。

18.2 poteto-mode:一条命令,23 个 playbook

安装一行:/add-plugin pstack。上手两步:

  1. /setup-pstack:选推理预算,选每个角色用哪些模型,写成配置规则。
  2. /poteto-mode:凡是需要严谨的工程工作,从这条命令进。

poteto-mode 是主路由。它读你的请求,从 23 个 playbook 里挑一个合适的,开一个 todo 列表,第一项就是把 playbook 的步骤原样拷进来,然后按步骤需要调用其他技能。你不用记住 20 多个命令,一条 /poteto-mode 进去,剩下它自己排。

23 个 playbook 覆盖的面很宽。只读的调查(investigation)、带运行时证据的 bug 修复(bug fix)、对着基线做度量的性能优化(perf 和 hillclimb)、活体诊断(runtime forensics,从内存泄漏到 CPU 空转)、画像分析(trace forensics,读 cpuprofile 和 heap snapshot)。

另一批覆盖交付全程:babysit 管 PR 到 merge-ready,shipping 独立验证绿了的栈再自底向上合入,autopilot-full 让独立的 PR 各带一个 owner 跑到合并,每轮有 swarm 仲裁。还有管 agent 自身状态的:session pickup 接手上一个 agent 的半成品,pause safely 把在途工作干净地挂起。

模型分配写在默认面板里:opus 5.5 / sol / grok。代码委托(feature、refactoring、bug fix、perf、hillclimb)发给 grok,最难的变更、文字和判断留给 opus 5.5,sol 是 Codex 那一侧内置的模型。/setup-pstack 可以改任何一项。

图:pstack 的主干工作流。poteto-mode 选定 playbook 后,how、architect、tdd、interrogate 等技能并行展开,最后以真实应用的运行证据收尾,产出可评审的 PR(图来自 open-pstack 仓库)。

pstack 还有不少面向 agent 管理层的设计。/automate-me 观察你实际怎么干活,给你起草自己的 -mode 技能。她强调多模型工作流:每个前沿模型各有强弱,很多技能按模型的长处分工。

18.3 值得抄的几个技能

pstack 的技能可以单独用,不一定走 poteto-mode。挑几个最有辨识度的:

技能 干什么
/how 并行探索者给你讲清一个子系统怎么运作,再由评审团攻击这份讲解
/why 运行时发现可用的 MCP,并行查询每类证据(源码管理、issue 单、长文档、聊天记录、可观测性、错误追踪、数仓),给带出处的答案
/architect 跨函数边界写代码前,先把调用方用法、类型和模块形状定下来
/arena 同一件事开 N 个并行尝试,挑一个当基底,把落选者的好部件嫁接进来
/swarm N 个 worker 分片并行,最后汇总成一份报告
/interrogate 让几个不同的模型轮番攻击一个 diff,包括严格的代码质量视角

这批技能的共性是证据文化。open-pstack 的文档把它说得很直白:跑代码,检查真实行为,而不是停在「测试都过了」。这是三个项目共同的底线。

18.4 open-pstack:社区移植的标准做法

Cursor 之外的社区想要这套工作流。Eric Litman 的 open-pstack 是跟进最紧的一个,仓库简介写明:pstack for Claude Code and Codex, tracking Cursor pstack upstream。MIT 协议,带 CI。

它的定位很清楚:主力环境是 Cursor,用 Lauren 的原版;主力环境是 Claude Code 或 Codex,用这个仓库。

Claude Code 里三条命令装好:

/plugin marketplace add ericlitman/open-pstack
/plugin install pstack@open-pstack
/reload-plugins

Codex 走命令行:codex plugin marketplace add ericlitman/open-pstack --ref main,codex plugin add pstack@open-pstack,再在 ~/.codex/config.toml 里打开 multi_agent,让 pstack 能并行比较工作。

依赖有两层。本地工具用 Bun 跑,负责在宿主应用之外启动其他模型。要跑完整的四模型会审,得装好并登录 Claude Code、Codex 和 Grok 三个命令行工具;模型不全也能用核心工作流。模型分布的规则:Claude 模型留在 Claude Code 里,sol 留在 Codex 里,其余通过各自登录的命令行调用。

open-pstack 的信任观值得单独抄下来:pstack 不要求你第一天就信任 agent,它帮 agent 留下你能检查的证据。先做有监督的工作,等它在你自己的仓库里用检查结果赢回信任,再让它并行跑更多。

版本纪律同样克制。仓库维护两个版本号:上游版本号标记跟随 Lauren 的哪一版,包版本号标记 Claude Code 和 Codex 的打包。它不承诺即时同步,只承诺记录跟随的版本、按序评审新变更、只改移植必须改的部分。新行为尽量先落在上游。

18.5 cstack:46 个技能的独立移植

第二个移植走得更远。irg1008 的 cstack,2026 年 9 月 11 日建仓,仓库简介:46 skills and 2 agents for Claude Code。编排、对抗式评审、真实验证,外加 21 条工程原则。README 第一屏就写着那句 If you want to go fast, go deep first.

安装三条命令:

/plugin marketplace add irg1008/cstack
/plugin install cstack@cstack
/setup-cstack

/setup-cstack 只跑一次:检查 Bun,写入每个角色的模型选择。

cstack 把渐进采用写成了规则。加 marketplace 什么都不装。Slack 自动化(cstack-benny,一个 issue 机器人)放在第二个插件里,不想碰就不用碰。多数技能可以单独用,/how 和 /unslop 第一天就有用,不用装齐整套。

技能表挑几行:

你要做什么 跑什么 得到什么
改没读过的代码 /how 并行探索者讲解,评审团攻击
查代码为什么长这样 /why 并行查 MCP(git、工单、文档、聊天、Sentry、数仓),带出处的答案
上手非平凡任务 /architect 写代码前定好类型、签名和模块形状
两个方案难决断 /arena N 个候选并行做,选一个当基底,嫁接落选者的长处
发布有风险的 diff /blast-radius diff 之外会破坏什么,用跑代码证明,不靠推理
评审前先挨一顿打 /interrogate 四个评审从独立角度攻击
清理 agent 写的代码 /deslop 再 /no-comments 先剥 slop,再删掉旁白式注释
清理 agent 写的文案 /unslop 从文档、PR 和 commit 里去掉 31 种 AI 腔
一周没来,接着干 /recall 把你的历史重建成一份当前状态简报
交给 agent 过夜 /poteto-mode 完整风格:22 个 playbook、决策日志、验证门

这些技能的组合方式是一张路由图:/poteto-mode 把工作路由到四个阶段。understand 调 /how、/why、/teach、/recall、/blast-radius;design 调 /architect、/arena、/figure-it-out;build 调 /swarm、/tdd 和 21 个 principle-* 技能;prove 调 /interrogate、/deslop、/no-comments、/unslop、/create-verification-skill。最后落到 /show-me-your-work:一份 TSV 决策日志,每行一个决策,记做了什么、为什么、证据、结果。默认留在本地,评审人需要审计时才提交进仓库。

成本算得很诚实:cstack 每个会话多花约 2,700 tokens,其中 21 条原则占约 1,000。自动触发的技能只有 6 个(deslop、how、why、unslop、typescript-best-practices、setup-cstack),其余 39 个关掉了模型自动调用,只能你敲命令或由 /poteto-mode 路由。README 解释了原因:45 个技能都抢着自动触发,比没有还糟。代价是你得知道这些命令存在,所以那张路由表才放在 README 第一屏。

对上游的忠实度也有交代:poteto-mode 的脚本逐字节保留上游代码,只改了文案。

18.6 三套实现怎么选

pstack open-pstack cstack
宿主 Cursor Claude Code、Codex Claude Code
规模 23 个 playbook 加全套技能 贴上游移植 46 技能加 2 个 agent
姿态 官方原版 跟随上游,克制 独立发展,功能更全
特别之处 宿主集成最深:模型面板、浏览器、Design Mode 双版本号,四模型会审 show-me-your-work 决策日志,token 成本透明

选法跟着宿主走。Cursor 用户直接用原版。Claude Code 用户在两个移植之间挑:想要贴近 Lauren 的原版,用 open-pstack;想要 blast-radius、deslop、unslop 这些扩展,用 cstack。Codex 用户目前只有 open-pstack。

两条风险提示。社区移植天然滞后上游,open-pstack 自己也写明不承诺即时同步。cstack 是 2026 年 9 月才出现的个人项目,star 还是个位数,指望它有 open-pstack 那样的评审纪律为时过早。好在这三套东西都遵循 SKILL.md 格式,技能文件互通,迁移成本就是换个安装命令。

18.7 和本书其他章节

和第 2 章 Mattpocock Skills 是同一条路线。 都是把工程纪律写成 SKILL.md 文件,让 agent 按清单干活。pstack 把这个思路推到了团队规模:多模型分工、并行探索、评审团。

和第 6 章 superpowers 共享「技能即文件」的底座。 superpowers 面向通用能力增强,pstack 面向工程工作流的完整性:从调查、设计、构建到证明,每个阶段都有对应的技能和 playbook。

和第 16 章 agent-skills 信念相同。 第 16 章的反合理化表阻止 agent 跳过工序,pstack 的验证门和 show-me-your-work 阻止 agent 谎报完成。制度性的手段不同,目标一致:逼 agent 拿出真实证据。

和第 20 章 Anthropic 官方插件是下一站的对照。 pstack 是个人发布在 Cursor 官方仓库的明星插件,第 20 章是平台方出的领域知识合集。两种供给方式都在验证同一个判断:技能文件是这个时代的知识分发单位。

18.8 本章小结

pstack 的出发点是一句反直觉的话:想走得快,先往深处走。Lauren Tan 把她每天用的工程纪律打包成 23 个 playbook 和一整套技能,换来的东西叫 fearless parallelism:单个 agent 可信,并行才有意义。

三套实现,一个理念。Cursor 里的原版集成最深;open-pstack 把它带上 Claude Code 和 Codex,版本纪律和信任梯子都写得明明白白;cstack 长出 46 个技能,用路由图和决策日志把「agent 干了什么」摆上台面。

如果只带走一样东西,带走那套信任观:不要求第一天就信任 agent,让它留下可检查的证据,用证据换并行。下一部分进入技能篇,第一站是 Anthropic 官方插件。