用 pstack-claude 获得有主见、可验证的 Agent 工作流

Agent 写代码翻车的方式很有规律：模型一口气改三个文件，报告成功，留给你一个只在它没跑过的路径上出现的 bug。pstack-claude 是 Lauren Tan 那套有主见的 pstack skill 栈（原本为 Cursor 打造）的移植版，覆盖 Claude Code、Codex、Pi、GitHub Copilot 等运行时，3k 星。把目标告诉 poteto-mode，它会为任务调用合适的工作流，让代码保持简洁、简单、可验证。

为什么这个 Skill 重要

这个移植版跟随上游，同时带有具名的策略分叉，每一项都登记在仓库的 tools/forks.json 里——你拿到的是原版栈的纪律，加上这位维护者有文档记录的差异。这套纪律能换来什么，README 自己的例子写得明白：面对 bug，poteto-mode 先复现失败，用 how 和 why 调查，委派修复，再重跑失败用例——如果修复跨越函数边界，实现之前会先请 architect 出场。你收到的是修复加上失败与通过两份证据，不是一份自信报告。

修 bug 之外，README 列出的 playbook 覆盖规划、功能开发、重构、性能问题、调查、原型、PR 维护、发布和更长期的项目。总览图把 interrogate 与测试、测量并列为复核与验证手段，用 architect、arena、swarm 做规划与委派，并把 how、why、unslop 列为支撑 skill；setup-pstack 负责配置模型和按角色的推理力度。

安装

各运行时的安装路由不同——用你对应的那条。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；GitHub Copilot 用 copilot plugin marketplace add 加 copilot plugin install pstack@pstack-claude。OpenCode、Gemini CLI、Prime Agent 和纯 skills 方式的 Codex 安装，README 记载的是 git clone 加一段符号链接循环，链进 ~/.agents/skills/。

有钩子的地方路由是自动的：Claude Code、Codex、Copilot 用插件的会话启动钩子，Pi 用 pstack 扩展。Codex 还要你先通过 /hooks 信任这个钩子。没有钩子的运行时永远不会自行路由——直接点名 poteto-mode。

实战：带着证据修一个 bug

这样说：

用 poteto-mode 修复搜索筛选器在切换页面时被重置的问题。

这正是 README 自己的入门示例，它记载的路径就是全部要点：先复现失败，用 how 和 why 调查，委派修复，然后重跑失败用例来证明。如果修复会跨越函数边界，预期 architect 会在任何代码落盘前先审一遍方案。最后拿回来的是改动本身，加上改前失败、改后通过的证据。

跑一次 setup-pstack 把剩下的都调好：开或关自动路由、设默认模型、按角色分配推理力度。README 有两条边界提醒：Copilot 不带默认 pstack 模型，所以第一个需要模型的 skill 会运行 setup-pstack，从你账号可用的模型里挑；如果任务是并发 bug 或测试够不着的约束，README 指向单独的 agent-formal-verify 插件，用 TLA+ 模型检查和 Lean 证明。

技巧

• 在没有路由钩子的运行时上，请求里明确点名 poteto-mode——没有任何东西会隐式调起它。
• 数据处理在文档里写明是纯本地：无服务器、无遥测；skill 读到的一切（包括会话记录）只发往你的模型服务商。
• Copilot 版本在 Copilot CLI 1.0.87 到 1.0.92 上测试过——README 记载了这些版本上已知的上下文与 -p 会话问题。
• 纯 skills 安装的更新，README 记载的是 git pull 加重跑一遍符号链接循环；对插件安装，README 没有记载更新路径。

何时不用这个 Skill

它从设计上就是一套有主见的栈——如果你的团队已经在强制推行自己的工作流，两套主见会打架。它也是移植版而非上游本体：行为可能与 Cursor 原版不同，结果出乎意料时查 tools/forks.json 和上游仓库。至于终端里的一次性提问，不加任何栈的普通提示仍然是最轻的工具。

查看 排行榜 了解更多 skill。