先理解、再选择、用运行结果判断是否完成

pstack

把工程任务做成可复查的过程

Lauren Tan 的工程流程插件:按任务组合代码调查、候选设计、并行实现和证据审查,把“看起来对了”变成有范围、有产物、能复核的交付。

作者 Lauren Tan (poteto)

pstack:把工程任务做成可复查的过程 项目图片

本页入口

  • Cursor:/add-plugin pstack → /setup-pstack → 新会话
  • Claude Code:安装后使用 /pstack: 命令前缀
所在仓库 Star
14,668
版本
0.15.36
资料核对

第一次先读懂一个具体入口

完成模型配置后,新开会话,用 /how 追踪一个真实函数或用户操作。先检查解释中的文件、调用顺序和未知项,再决定是否交给 /poteto-mode 修改;这一步不需要先搭一套应用验证环境。

选一个任务,开始使用

在目标仓库的 Cursor 会话中安装插件,运行 /setup-pstack,确认模型和角色后再开始新会话。首次选择下方 /how 示例,补上真实入口。验收的是带路径的解释与明确未知项,不是已证明没有缺陷。

选择这次的完成条件

从一个真实入口追踪数据如何流动,给接手代码的人一个可核对的解释。

  1. 在 Cursor 安装 pstack

    这是 Cursor 会话命令,不是在终端运行。安装后仍需运行 /setup-pstack 并在新会话中选择技能。仓库清单版本为 0.15.36;此命令不会锁定本页研究提交,使用时核对实际安装版本。

    /add-plugin pstack
    查看作者安装与入口

    配置模型,然后开新会话

    运行 /setup-pstack。它先探测模型、询问推理预算并展示角色表,确认后完整写入用户级 ~/.cursor/rules/pstack-models.mdc,新会话生效。已有文件会被读取再重写,重新配置可保留自定义角色,删除某个角色行可恢复该角色的当前默认。末尾创建应用验证技能和形式验证技能的两项提议均可拒绝;首次只读调查可先不创建。新会话从 / 菜单选择 how,再输入任务,确认真正附加了技能。

    查看配置步骤与写入范围
  2. 把这段话发给 AI

    以下五项是编辑示例。替换输入中的真实路径、条件和命令后使用;先确认任务允许的文件、工具与外部操作范围。预期产物并非本站实测结果。

    /how 我会提供当前仓库中“取消任务”的入口文件或符号。只读追踪一次取消请求:用户操作或 API 入口、任务查询、取消信号、后台执行者和最终状态。若这个仓库没有对应功能,说明缺失,不编造路径。 先判断范围。窄问题用一个解释者;确实跨多个子系统时,按作者流程拆成 2–4 个调查角度再综合。每一跳给出真实文件和函数,说明输入输出、状态归属与分支;涉及多个参与者时给一张简图。 特别区分“发送取消信号”“执行者停止”和“状态已持久化”。若看到循环内查询,只标为待验证的性能线索,不据此断言发生了 N+1。把查明事实、推断和无法追踪的环节分开。 只交付解释、关键文件地图和未知项,不修改文件、不运行应用、不访问外部业务系统、不创建提交或 PR。完成前抽查关键调用确实存在,并确认工作区没有新增改动。

  3. 检查你拿到的结果

    • 一条有文件和函数依据的执行路径,说明数据与状态归属。
    • 关键文件地图、适用时的简图,以及明确的未知项;不把源码阅读称为运行验证。
    查看这项任务的作者说明
进一步了解这个 Skill

pstack 以 /poteto-mode 作为工程任务入口:识别需求,选取任务路线,把步骤列入待办,再在需要时调用专门技能。当前主目录有 58 个技能,其中 24 个是工程原则;主流程有 23 份路线。你通常不用逐个学习它们,先选一个范围清楚、结果可检查的任务即可。

不同入口的产物差别很大。/how 读代码并解释运行路径;/architect 先比较接口与模块形状;/poteto-mode 的缺陷和性能路线要拿实际运行证据;/interrogate 则让审查者尝试复现问题,再由主代理复跑。看懂代码、形成设计、修复行为和证明发现,是四种不同的完成条件。

这套方法强调少写不必要的代码、先处理数据与边界、把验证留成可复查的材料。它也很有主见:设计默认会进入实现,代码路线会走到提交和开 PR,部分步骤会调用其他插件。因此,任务里应说清可修改范围和本次停在哪里,不能把调用一个命令理解为只会输出建议。

Cursor 是原生入口,Claude Code 安装的是带适配说明的生成副本。两边命令、模型参数和云端能力并不完全相同。本页先用 Cursor 做一次只读调查,再展示设计、修复、性能和差异审查;所有提示词都是依据原文编写的编辑示例,未在本站运行。

来源与核验

资料核对

依据固定提交全文阅读 README、安装与适配说明、主入口和所选任务相关技能、参考及生成脚本。未安装插件、执行第三方代码、调用子代理工作流或验证目标项目;来源记录明确了全文阅读与集合未覆盖范围。