目录
pstack 帮助编码智能体在修改前理解系统,并在宣布完成前验证结果。先运行 /poteto-mode,说明目标结果和验收条件,系统就会选择合适的工作流。
要点#
/poteto-mode会根据修复缺陷、调查仓库等任务选择相应的操作手册。- 开发原则强调理解现有行为、建模有效状态,以及缩小改动范围。
- 完成任务需要基于实际行为的证据,包括能捕捉原始缺陷的检查。
- 安装和模型配置是不同的步骤;若要停在设计审查阶段,需要明确指示。
pstack 的工作方式#
pstack 是 poteto 提供的面向 Cursor 和 Claude Code 的智能体技能集。作为入口的 /poteto-mode 会选择“操作手册”,即按任务组织、调用所需技能的操作流程。
文档中描述的缺陷修复流程分为以下 4 个阶段。
1. 复现缺陷。 2. 提出假设,收集运行时证据。 3. 设计修复方案,委派实现。 4. 重复原始操作,验证结果。
调查使用另一套操作手册。它在不修改代码的情况下回答有关仓库的问题,并整理有证据支持的说明和建议。操作手册属于内部流程,没有可以直接执行的 /bug-fix 命令。
指导改动的原则#
how 技能会调查现有代码如何运行。如果是缓存问题,它会追踪值存储在哪里、何时被读取,以及失败结果如何影响后续调用。这能避免在应该修复缓存本身时,向调用方添加重试条件。
“Model the Domain” 要求智能体用数据结构表达业务规则和有效状态。相比多个独立的布尔标志,明确定义的状态机有时更容易理解。architect 技能通过概述类型、函数签名和模块边界,并比较结构不同的设计来应用这一原则。如果简单的表示方式已经能清晰表达规则,就保留它。
“Laziness Protocol” 强调采用足以解决问题的最小改动,并减少重复决策。简短的代码在降低复杂度时很有用,但无关的抽象无助于定位缺陷原因,还会扩大审查范围。作为相关要求,“Fix Root Causes” 要求在选择局部变通方案前,先调查异常行为或数据为何存在。
安装与配置#
面向 Claude Code 的 README 提供了以下命令。
/plugin marketplace add cursor/plugins
/plugin install pstack@cursor-plugins
/setup-pstack/setup-pstack 会检查可用模型,并为各个角色设置模型和推理预算。说明中建议将 Opus 用于更依赖判断的角色,而实现和调查角色则沿用当前会话的模型。在采用这些默认设置前,请先确认你的环境中提供了哪些选项。
配置保存在 ~/.claude/rules/pstack-models.md 中。要修改配置,请重新运行 /setup-pstack。如果不确定如何选择技能或使用技能集,请使用 /poteto-help。
编写有效的任务请求#
向智能体说明可观察到的问题、相关环境差异,以及确认任务完成的方法。例如:“标签页在浏览器中显示错误,但 curl 返回 200。请在本地生产预览环境中复现,找出原因,并验证标签列表能够渲染。请提供修复前后的 HTTP 状态码和浏览器错误。”
这种差异很重要。在介绍的案例中,空的标签 slug 导致键重复和水合失败。服务器响应为 200,但浏览器显示了错误页面。因此,仅检查 HTTP 就会漏掉这个缺陷。该案例建议修正无效的标签数据,并处理标签生成中的缺陷。
如果你想在架构工作中审查设计,请要求智能体暂停。根据文档,architect 默认会继续进入实现阶段。具体可以指示:“请审查缓存设计。在实现前展示公开函数和状态表示方式,并等待我的审查。”
检查证据和审查建议#
“Prove It Works” 要求检查实际结果,而不只是接受编译成功或智能体的完成报告。修复缺陷时,要重复原先失败的操作。回归测试必须在原有行为下失败,并在修复后通过。原本就能通过的测试无法证明缺陷已修复。
验证方法应与缺陷相匹配。浏览器渲染问题需要在浏览器中检查;生产环境特有的数据访问问题,需要使用能复现这些条件的配置。可复用的验证脚本有助于反复执行这些检查。
interrogate 技能会汇总多个模型的审查结果,并将意见分为处理、考虑、记录和驳回。它不会自动应用所有建议。模型之间的一致意见是值得考虑的证据,但每条意见仍需对照代码和需求进行核实。
下一步#
选择一个可复现的缺陷,指定失败的操作、环境,以及能证明修复有效的具体行为,然后运行 /poteto-mode。
来源: https://azukiazusa.dev/blog/pstack-agent-skills/
目录
