📌 项目地址:michael-denyer/pstack-claude | ⭐ 1,382 颗星 | 🔧 JavaScript | 📜 未标注

先说清楚它是什么

Lauren Tan 写的 pstack 是一套 Cursor 技能栈,有明确的工程主张,用来提升 agent 干活的产出质量。pstack-claude 把这套东西移植到了 Claude Code、Codex、Pi 等其他 agent 环境。目前 1382 个 star。

它不是简单 fork 一次就完事。仓库跟踪上游变化,同时维护一组“具名策略分叉”(named policy forks),每一条都声明在 tools/forks.json 里。也就是说,哪些行为是刻意偏离原版的,你可以打开这个文件一条条查。这种管理 fork 的方式本身就值得做类似移植项目的人参考。

核心用法:poteto-mode

装好后你不需要记一堆命令。告诉 poteto-mode 你的目标,它会自己挑合适的工作流。

README 给的例子是修一个 bug:

Use poteto-mode to fix the search filter resetting when I change pages.

它的处理流程:先复现失败,用 how 和 why 两个 skill 调查,把修复委派出去,然后重跑之前失败的用例。如果修复要跨函数边界,会先叫 architect 出场做设计,再动手写代码。最后交给你的是修复本身,加上失败时的证据和修好后的通过证据。

这个“证据随修复一起交付”的设计我觉得是整个技能栈最有价值的部分。大多数 agent 修完 bug 就停了,你得自己确认;这里把验证环节做进了流程。

除了修 bug,playbook 还覆盖规划、新功能、重构、性能问题、调查、原型、PR 维护、发布和长周期项目。

安装

Claude Code,在 Claude Code 里执行:

/plugin marketplace add michael-denyer/pstack-claude
/plugin install pstack@pstack-claude

Codex,在终端执行:

codex plugin marketplace add michael-denyer/pstack-claude
codex plugin add pstack@pstack-claude

Pi,在终端执行:

pi install git:github.com/michael-denyer/pstack-claude

Pi 上装的不只是 skills,还有一个扩展,提供 skills 依赖的 subagent、question、wake-up 工具,外加 /loop 命令。调用 skill 用 /skill: 前缀。

Prime Agent、OpenCode、Gemini CLI 或纯 skills 安装,README 指向 docs/reference.md 的 shared installation 章节,装之前自己查一下。

模型和推理力度配置

跑 setup-pstack 可以改模型默认值,也可以按角色设推理力度,比如:

arena runners: opus @xhigh, fable @max

这条配置在 Claude Code 里通过插件的 pstack:effort- 或 pstack:poteto-agent- agents 分发。没标级别的角色沿用会话默认力度,除非 skill 文件里有 default effort 行指定了别的。自动路由也能关掉。

有一个坑要提前知道:插件会在 Claude Code 和 Codex 上安装路由 hook,Codex 需要你通过 /hooks 手动信任才会生效。Pi 上没有这步,由扩展直接注入路由指令。Claude Code 里对应的命令是 /pstack:setup-pstack。

两个配套细节

数据安全。README 明确写了 pstack 没有 server、没有 telemetry。它的 skills 让你的 agent 读的所有东西,包括会话记录,都留在本地。

并发 bug 怎么办。测试覆盖不到的并发问题和不变量,作者的另一个项目 agent-formal-verify 可以补上,它加了 TLA+ 模型检查和 Lean 证明。如果你的工作涉及并发正确性,两个可以一起用。

我的看法

仓库标的是 JavaScript,但代码量不是重点,你真正要评估的是它的 playbook 和路由策略是否符合你的工程习惯。这类技能栈项目的价值全在“工作流定义”这一层:复现、调查、设计、修复、验证这条链路是不是你想要的。如果是,装上试一个真实 bug 就知道合不合适。

README 没提许可证,用之前去仓库确认一下。

这篇文章对你有帮助吗?

发表回复