企业官网建设流程全解析

如何用pstack修复翻页时筛选条件重置的bug：官方示例实战

【免费下载链接】pstack-claudeClaude Code, Codex, Copilot, Pi, OpenCode, Gemini, and Prime Agent versions of Poteto's pstack. Rigorous agent workflows with Cursor primitives translated for other harnesses.项目地址: https://gitcode.com/GitHub_Trending/ps/pstack-claude

pstack是一个面向 Claude Code、Codex、Pi 等 AI 编程代理的技能工作流工具包。它内置的poteto-mode能把"修复翻页时筛选条件被重置的 bug"这类需求，自动转成一套严谨的修复流程：先复现、再定位根因、最后带着运行证据交付修复。本文将带你用官方示例，完整走一遍这个 bug 修复实战。

为什么选 pstack 修 bug？

普通 AI 助手修 bug 时容易"凭感觉改一行试试"。而 pstack 的核心理念是科学修复：

• 每一行交付的代码都能追溯到运行证据
• 只交付证据支持的最小改动，"也许有用"的补丁不算修复
• 修复前后都有失败与通过的实证输出

它的入口是poteto-mode技能（plugins/pstack/skills/poteto-mode/SKILL.md），你说出目标，它就调用匹配的 playbook。针对缺陷类任务，它走的是Bug fixplaybook（playbooks/bug-fix.md）。

一键安装 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

也可以用git clone https://gitcode.com/GitHub_Trending/ps/pstack-claude克隆后做 skills-only 安装，详见 docs/reference.md。安装完成后运行setup-pstack技能可配置各角色使用的模型与推理强度。

官方示例实战：一句话触发 bug 修复

pstack 官方文档给出的上手示例正是本文的主角。在你的 AI 代理中直接输入：

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

（用 poteto-mode 修复我翻页时搜索筛选被重置的问题。）

接下来poteto-mode会自动执行完整的 Bug fix 流程，无需你手动指挥每一步。

Bug 修复的 6 步工作流拆解

打开 bug-fix.md，这套流程可以拆解为：

1. 自己先复现。在真实界面（浏览器/CLI）上把"筛选→翻页→筛选丢失"复现出来，复现不了就要构造触发条件，绝不跳过。
2. 二分定位根因。用how技能梳理受影响的子系统，用why技能挖掘回归历史（当初为什么这么写）。每一轮都取最能缩小问题空间的假设去验证，不靠猜。
3. 规划修复。如果修复跨越函数边界，先调用architect技能做并行设计探索，再委派给配置的 bug-fix 模型实施。
4. 同表面验证。在最初复现的同一界面上重跑：修复前失败、修复后必须通过。单元测试只证明分支行为，不证明 bug 不存在。
5. 可验证的提交顺序。让"失败的复现"先落入 git 历史，修复提交紧随其后。当测试成本低时，走 tdd 技能的"失败测试先行"节奏。
6. 开 PR。最后执行 Opening a PR playbook 交付，并附决定性的失败与通过输出。

对"筛选条件重置"这类 bug，典型的根因往往在第 2 步被暴露：例如翻页请求重新拉取数据时丢失了筛选参数的持久化，或分页状态与筛选状态被放在了不同的生命周期层。why技能会通过git blame、PR 历史等多路证据并行查证，把"猜测"变成"证据"。

核心技能速查

完整的 57 个技能清单见 docs/reference.md。

验收标准：怎么算修好了？

按 pstack 的交付标准，最终回复必须包含四项，缺一不可：

• 坏在哪里：翻页时筛选条件为何丢失
• 根因：有运行时证据支撑，而非推断
• 修复内容：最小改动，不夹带"顺手优化"
• 验证方式：引用决定性的失败与通过输出

如果代理只是改了代码却说"应该好了"，那就是不合格交付——这正是 pstack 与普通 AI 修 bug 的分水岭。

总结

pstack 把资深工程师的 bug 修复方法论固化成了可复用的技能栈。安装后只需一句自然语言，poteto-mode就会替你复现问题、二分定位根因、委派修复、同表面验证，并带着完整证据交付。对于"翻页时筛选条件重置"这类状态丢失型 bug，这套 流程 尤其对症：它逼着每一处改动都回答"为什么"，而不是"试试看"。

📌 延伸阅读：各运行时安装细节见 docs/reference.md；发布历史见 CHANGES.md；贡献指南见 CONTRIBUTING.md。

【免费下载链接】pstack-claudeClaude Code, Codex, Copilot, Pi, OpenCode, Gemini, and Prime Agent versions of Poteto's pstack. Rigorous agent workflows with Cursor primitives translated for other harnesses.项目地址: https://gitcode.com/GitHub_Trending/ps/pstack-claude