pstack-claude Skill 技能

技能简介

pstack-claude 是 Poteto (Lauren Tan) 早期为 Cursor 编辑器编写的 pstack 智能体技能栈的多运行时分发版本，由开发者 Michael Denyer 移植并维护到 Claude Code、Codex、Pi、OpenCode、Gemini CLI 与 Prime Agent 等六大 AI 编程代理运行时。它把 Cursor 体系里经过严格工作流验证的子命令、并发编排与代码评审原语，平移到 Anthropic、OpenAI 与开源生态中常见的代理 CLI 框架中，让习惯 Claude Code 或 Codex 的工程师也能复用同一套严谨的「先验证、再实现」代理流程。仓库 MIT 协议开源，目前 GitHub 已收获 1269 颗 Star，最近一次提交就在今天。

核心能力

• 57 个内置技能：33 个面向用户公开的技能 + 24 个 principle-* 内部参考，覆盖规划、特性开发、重构、性能调优、调查、原型、PR 维护、发布、长周期项目管理等典型开发场景。
• /poteto-mode 统一入口：所有非平凡任务统一进入 poteto-mode 路由，自动选择 how / why / architect / arena / interrogate / tdd 等子工作流，无需开发者手动挑选。
• 并行编排：内置 arena（同一任务并行 N 次取最优片段）与 swarm（按切片/竞争并行分发并聚合报告）两条并发路径，适合性能调优与跨模块重构。
• 多模型对抗评审：interrogate 让三种不同模型同时尝试「打破」一段 diff，blast-radius 用真实执行证明改动影响面，thermo-nuclear-code-quality-review 提供极严格的可维护性审计。
• 跨运行时分发：同一份技能树通过 marketplace 插件（Claude Code）、原生 plugin（Codex）、pi install（Pi）、skills CLI（npx skills add）等多种渠道安装，支持 skills-only 软链接安装到 ~/.agents/skills/。
• 自动路由 Hook：Claude Code 与 Codex 在 session-start、resume、clear、compact 时自动注入 poteto-mode 路由指令；Pi 通过 extension 在系统提示词中追加；可使用 setup-pstack 一键关闭。

安装配置

• 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 安装原生插件，并在 /hooks 中信任 SessionStart 钩子。
• Pi 用户：在终端运行 pi install git:github.com/michael-denyer/pstack-claude 即装即用，无需额外配置。
• Prime Agent / opencode / Gemini CLI：使用 skills-only 安装方式，克隆仓库后将 plugins/pstack/skills/ 软链接到 ~/.agents/skills/；或运行 `npx skills add https://github.com/michael-denyer/pstack-claude/tree/main/plugins/pstack/skills --skill "" --agent "*" --yes`。
• 关闭自动路由：运行 setup-pstack（Claude Code 中为 /pstack:setup-pstack），将 session hook 设为 off，或在运行时 sheet 中写 session hook: off。

使用步骤

1. 在终端输入 /pstack:setup-pstack（Claude Code）或 setup-pstack（其他运行时），按角色选择模型与推理强度，例如 arena runners: opus @xhigh, fable @max。
2. 用一句自然语言告诉 poteto-mode 你的目标，例如「用 poteto-mode 修一下搜索筛选条件切页时重置的 bug」。
3. poteto-mode 会先复现失败现象，调用 how 与 why 调查根因，再委派实现，最后跑通失败用例与通过用例作为证据。
4. 若修复跨越函数边界，poteto-mode 会在实现前自动拉入 architect 先敲定类型与模块形态。
5. 拿到补丁后，可主动调用 interrogate 让三个不同模型挑刺，或用 blast-radius 验证改动影响面，再决定是否合并。

适用场景

• 生产 Bug 修复：需要先复现、再定根因、再落实现、最后留证据的严谨修复流程。
• 跨模块重构：architect 提前定义类型与模块边界，arena 并行尝试多种实现并挑最佳片段。
• 代码评审与合并：interrogate 多模型对抗 + blast-radius 影响面 + babysit 持续跟进 PR 状态。
• 性能调优：benchmark-checklist 校验测量方法（限速器、调参、错误、重跑次数、端到端相关性），避免假阳性。
• 团队知识沉淀：reflect 把长任务的教训写成技能补丁，automate-me 从近期会话生成个性化 -mode 技能。

适用人群

• 长期使用 Claude Code、Codex、Pi 等代理 CLI 的全栈与平台工程师，希望复用 Cursor 体系已经打磨好的工作流。
• 对代理输出稳定性、可验证性、可审计性有强要求的中大型研发团队。
• 维护多运行时代理工具链的技术负责人，希望同一套技能在多个 CLI 上保持行为一致。
• Agent 工具与技能生态的研究者，关注 agent-formal-verify（TLA+/Lean）等延伸实验方向的人。

工作原理

pstack 的核心是把「任务分流 → 子工作流 → 验证证据」拆成可组合的技能单元。poteto-mode 作为默认入口，根据任务是否跨文件、是否涉及设计决策、是否是未知原因 Bug 三条规则触发；命中后依次调度 how/why 调查、architect 定型、arena/swarm 并行、interrogate 反向验证，最后由 TDD/blast-radius/benchmark-checklist 留证据。所有运行时共享同一份技能树（plugins/pstack/skills/），差异仅在 tool/mapping：Claude Code 用原生工具，Codex 通过 codex-tools.md 翻译，Pi 通过 pi-tools.md 翻译，opencode/Gemini/Prime Agent 走软链接发现。pstack 本身无服务端、不上传遥测，所有读取过的会话片段都会随技能被发往你当前使用的模型提供方。

官方链接

• 仓库地址：https://github.com/michael-denyer/pstack-claude
• 上游 pstack (Cursor 版)：https://github.com/cursor/plugins/tree/main/pstack
• 相关形式化验证插件：https://github.com/michael-denyer/agent-formal-verify
• 安装参考文档：https://github.com/michael-denyer/pstack-claude/blob/main/docs/reference.md