poteto-help

Poteto 帮助

回答用户关于 pstack 的问题，提供一段可发送的提示词，并链接到答案来源文件。遇到帮助类问题时，不要开始执行任务。用户问的是如何操作，而运行一次 pstack 会消耗实际 Token，所以让他们自行发送提示词。

如果用户要求执行任务，例如“用 pstack 修复这个 Bug”，这就不是帮助类问题。阅读 poteto-mode，按照其中的要求执行任务，并提一次 Custom Mode 可以让它持续生效。

此文件将问题对应到包含答案的技能和指南页面。具体内容以那些文件为准。引用前，先阅读你要引导用户查看的文件；如果它与此索引不一致，以该文件为准。此处的链接指向已安装的插件，用户可能无法打开，因此请提供该文件的公开副本：https://github.com/cursor/plugins/blob/main/pstack/ 后接文件路径。

确认用户的需求

根据用户的消息和对话推断其需求。对于明确提及的情况，例如“哪个技能可以审查 PR？”，直接前往对应章节。如果需求仍不明确，就用以下选项提出一个多选问题，然后只回答他们选择的章节：

• 完成设置
• 使用 /poteto-mode 开始任务
• 根据情况选择技能
• 修复出错的运行
• 自定义 pstack

检查会影响答案的状态，并且只在有影响时提及：

• 缺少 pstack 设置文件（Cursor 中为 ~/.cursor/rules/pstack-models.mdc，Claude Code 中为 ~/.claude/rules/pstack-models.md，其他运行环境中为 ~/.agents/pstack-models.md），表示此用户尚未运行 /setup-pstack，因此每个角色都会使用其默认模型。
• 如果项目中没有 verify-* 技能或其他应用程序测试框架，Agent 就没有通过脚本驱动应用程序的方法。如果用户的问题是关于如何证明某项更改有效，提及 /create-verification-skill。
• 如果项目中没有正式验证技能，就无法对测试覆盖范围之外的属性进行检查。如果用户的问题涉及竞态、不变量或测试很少覆盖的其他情况，提及 /create-formal-verification-skill。如果项目中已有正式验证技能，且它覆盖的代码在其记录的上次同步提交之后发生了更改，那么如果问题涉及该代码，提及 /maintain-formal-verification-skill。

如果缺少模型规则且这会影响答案，询问用户现在是否要为每个角色选择模型和推理预算。当用户是新用户、问题涉及设置或成本，或者答案取决于会运行哪些模型时，这一点会有影响。每次对话最多询问一次。如果需求也不明确，就把两个问题放在一起询问。提供两个选项：

• 现在：让用户输入 /setup-pstack，并回答他们的问题。
• 稍后：回答他们的问题，并补充一行说明，在他们运行 /setup-pstack 之前，每个角色都会继续使用默认模型。

开始使用

1. 在聊天中运行 /add-plugin pstack，或从侧边栏中的 Customize 安装。在 Cursor 之外，运行 npx skills add backnotprop/pstack，然后选择技能。
2. 运行 /setup-pstack。它会询问推理预算，为每个角色指定模型，并写入一条规则。该规则适用于新聊天。随后，它会分别询问是否要为项目生成验证技能和形式化验证技能；如果项目已有相应技能，则不会询问。
3. 使用 /poteto-mode、目标，以及一个可判定成败的检查，开始一项实际任务。

安装后不会有任何变化，直到用户调用某项技能。只有 /setup-pstack 会根据用户的输入加载。README 和指南第 1 页中有详细说明。根据 references/prompting.md，可以主动提出帮用户措辞，写出他们的第一个提示词。

如果用户担心成本，请说明 Token 的消耗去向，以及如何减少消耗。pstack 会在子 Agent 和评审面板上额外消耗 Token。重新运行 /setup-pstack，选择较小的预算或更便宜的模型。角色设为 auto 或 inherit-parent 时会使用聊天所用的模型；如果聊天使用 Auto 或更便宜的模型，就能节省 Token。缩短面板列表可以减少运行的子 Agent 数量，每个条目对应一个子 Agent。只在需要严谨性的工作中使用 /poteto-mode。

pstack 是为 Cursor 构建的，也可通过 /plugin marketplace add cursor/plugins，然后运行 /plugin install pstack@cursor-plugins 安装到 Claude Code 中。在那里，每个命令都要加上 pstack: 前缀，例如 /pstack:poteto-mode。Claude Code 适配器会映射 Cursor 名称；需要 Cursor 专属功能（例如 Bugbot 或 Automations）的步骤会跳过，并附上一行说明。

本镜像中的技能也可通过 npx skills add backnotprop/pstack 用于其他 Harness（Claude Code、Codex、Pi、OpenCode 等）。poteto-mode 中的 Harness 部分会将 Cursor 的子 Agent、问题、转录和设置路径映射到相应 Harness 的路径。Custom Modes 是 Cursor 的功能。

使用 /poteto-mode 开始任务

/poteto-mode 会根据任务匹配一个操作手册，将其中的步骤复制到待办列表，并根据步骤需要运行其他技能。跳过的步骤会以 skip: <reason> 的形式保留在列表中。好的提示词会说明目标，以及如何判断任务已完成。不要列出技能，因为手写的步骤顺序容易遗漏或打乱操作手册原本保留的步骤。帮用户措辞前，请阅读 references/prompting.md。指南第 2 页中有示例。

/poteto-mode 是否会持续生效，取决于用户如何启动它：

• 在 /poteto-mode 上按 Enter，会将技能附加到一条消息上。随着聊天继续，它的作用会逐渐消退。
• 在 Mac 上按 Option+Enter，或在 Windows 上按 Alt+Enter，或在技能条目中选择 Use as Mode，会将其设为 Custom Mode。只要用户不退出该模式，它就会在每轮对话中保留在上下文中，且不会影响闲聊。
• Cursor 文档说明，Custom Modes 可在 Agents Window 和 CLI 中使用。在其他地方，每项新任务都要使用 /poteto-mode 开始。

遇到相关问题时，请分享 Cursor 的技能文档。聊天中途说“新任务”，即可让该模式匹配一份新的操作手册。/poteto-mode 已会对其操作手册步骤启动的子 Agent 使用 poteto-agent。若想让自己启动的子 Agent 也采用相同风格，请使用 subagent_type: "poteto-agent" 启动。

选择技能

默认建议使用 /poteto-mode；步骤需要时，它会运行大多数其他技能。如果用户想要的程度超出操作手册所提供的范围，请直接指定某项技能。推荐前先阅读该技能，并提供一个提示词示例。

用户想要	技能
严谨地完成任何非简单任务	/poteto-mode
在开始前确认 Agent 理解了他们的目标和问题	/in-your-own-words
发送提示词前，将其打磨得更深入，而不是更长：补充顶尖专业人士会加入的内容、他们的原始素材和方法，以及外部检查。它会返回提示词，不会执行任务	/sharpen
了解代码目前如何运作，或新代码应该放在哪里	/how
了解代码为何如此设计，或某个数字的来源	/why
用通俗易懂的方式理解某项更改或子系统	/teach
回顾自己近期在某个主题上的工作	/recall
用通俗的语言和简明的图示，回顾自上次发言后本次对话中的变化，并列出所有待你处理、且仅凭回复即可决定的事项	/ketchup
像 /ketchup 一样回顾，但以简短、无声的幻灯片视频呈现，并在视频下方以文字列出待处理事项	/ketchup-video
了解小型差异可能对其自身之外造成的影响	/blast-radius
在编写跨越函数边界的代码前，确定类型和模块结构	/architect
针对同一任务简介进行多次尝试，并整合出最佳方案	/arena
将任务拆分并行检查，或让工作者竞速，以云端 Agent 的形式运行	/swarm
让不同模型审查差异并尝试找出问题	/interrogate
在本地有廉价测试时，采用测试优先的方式修复 Bug	/tdd
对 .ts 或 .tsx 工作应用 TypeScript 规则	/typescript-best-practices
审查前先移除注释，并交由未编写这些注释的审查者检查	/no-comments
清除文本中的 AI 痕迹	/unslop
按照规范撰写文档、RFC、README、PR 描述或提交消息	/technical-writing
用通俗的语言重述上一条回复	/bro
为 Agent 提供脚本化的应用操作方式，并验证其行为	/create-verification-skill
让验证技能及其功能映射与应用保持一致	/maintain-verification-skill
对测试很少覆盖到的竞争条件、不变量或其他属性进行形式化验证	/create-formal-verification-skill
在相关代码更改后让形式化验证保持一致，并判断失败是因为偏移还是 Bug	/maintain-formal-verification-skill
向 PM 或设计师展示经模型检查的用户可见图表，并将每个 Bug 绘制为带编号的路径；将达成一致的图表转成 TLA+ 骨架；或根据 TLA+ 规范审查代码	/statechart
在报告或依据性能数字采取行动前，验证该数字是否可靠	/benchmark-checklist
执行大型或跨领域更改，或执行需要暂离一段时间后再审查的更改	/figure-it-out
在执行过程中记录决策，并在事后审查	/show-me-your-work
为每种角色选择模型和推理预算	/setup-pstack
将自己的工作习惯转化为个人模式技能	/automate-me
将已完成任务的经验转化为技能修改	/reflect
防止 Agent 在此代码库中重复犯同样的错误	/correct
构建一个页面，让按钮通过 webhook 唤醒 Grok Bot	/make-bot-ui
熟悉 pstack	/poteto-help
如果相邻的技能目录未列在表格中，请读取其 frontmatter，并根据描述进行路由。principle-* 目录归入下方的原则。

容易混淆的情况：

• /how 说明代码的作用。/why 解释原因。/teach 会运行其中一个或两个，并用通俗的语言解释结果。
• /arena 给每位工作者相同的任务说明，并汇总最佳部分。/swarm 将工作拆分成若干部分或竞速任务，并返回一份报告。
• /architect 敲定设计后立即实现。添加“with checkpoint”可在编写代码前审查设计。
• /interrogate 审查差异。/blast-radius 查找差异之外可能出现的问题，并验证一项能证明更改安全的关键事实。
• /recall 重建近期聊天的上下文。/ketchup 仅涵盖用户上次发消息后本次聊天中的内容。要恢复某个特定聊天或分支，请使用 Session pickup playbook。
• /figure-it-out 设计一次严谨的运行。Orchestrate playbook 运行一个跨越数天和多个 PR 的计划。Autonomous run playbook 则推动一项任务直至达到完成条件。

pstack 中不包含：

• /deslop、control-cli 和 control-ui 随 cursor-team-kit 插件提供。
• /loop 和 /create-skill 是 Cursor 内置功能。
• pstack 没有 /orchestrate 技能。Orchestrate 是 /poteto-mode 的 playbook。如果斜杠菜单中显示 /orchestrate，说明是其他插件提供的。

Playbook 和原则

Playbook 是 /poteto-mode 中的步骤列表，并非技能，因此没有斜杠命令。在 /poteto-mode 中描述任务即可选择一个 playbook，以下说法可直接指定：

• “babysit this pr” 或 “check on pr 123” 会运行 Babysit。它会推动 PR 达到可合并状态，然后停止。除非用户要求合并、落地或发布，否则它不会合并 PR。
• “land the stack” 会运行 Shipping。
• “take over this branch” 会运行 Session pickup。
• “pause safely” 会运行 Pause safely。
• “full autopilot on this queue” 会运行 Autopilot-full。“stack them, don't ship” 会运行 Autopilot-stack。
• “run the eval playbook” 会运行 Eval。

如果不使用 /poteto-mode，像 “babysit this pr” 这样的说法可能会启动 Cursor 自带的同类技能。 poteto-mode 的 Playbooks 部分列出了所有 playbook 及其适用场景。指南第 6 页介绍了如何打开、跟进并落地 PR。

pstack 没有规划技能。Cursor 的 Plan Mode 可与它配合使用。对于跨阶段或包含堆叠 PR 的工作，要求 /poteto-mode 制定计划会运行 Multi-phase plan playbook，它会编写计划，但不会实施。对于设计问题，Prototype playbook 或 /architect 会先通过代码敲定设计。

原则是每条只包含一项规则的技能，/poteto-mode 会在回复中读取并引用它。用户很少会直接调用某一条原则，而是直接用名称引导，例如 “apply prove it works. show me the real output.”。输入 /principle-<name> 仍可按需加载相应原则。指南第 8 页列出了这些原则。

修复出错的运行

症状	修复方法
几轮对话后，模式不再生效	这是通过按 Enter 启动的。请将其设为自定义模式，或使用 /poteto-mode 启动每项任务。
一个问题被当成了上一项任务的下一步	请说“新任务”，或说明这一轮不需要该模式。
新选择的模型没有生效	/setup-pstack 中的规则适用于新聊天。请新建一个聊天。
运行成本超出预期	请参阅“开始设置”下方的成本段落。
技能没有自动加载	只有 /setup-pstack 会根据用户的话语加载。其他技能会在用户输入它们，或 /poteto-mode 运行它们时加载，而且不会运行所有技能。
并行 Agent 覆盖了彼此的内容	为每个 Agent 分配独立的工作树，或将它们作为云端 Agent 运行，这样每个 Agent 都会获得自己的机器。
运行了一整夜，却没有完成任何工作	/loop 需要的是一个可通过或不通过的检查，而不是一段时长。请参阅指南第 7 页。
回复根据绿色构建结果声称任务成功	请要求提供实际执行的命令、流程、存储值或配置文件。这就是“证明有效”原则。

如果运行偏离方向， references/prompting.md 提供了单行引导语。指南第 10 页介绍了更多常见问题和值得借鉴的配方。

打造专属的 pstack

• /automate-me 根据用户自己的历史记录起草个人模式技能，供用户与 /poteto-mode 搭配使用。
• 会话结束后运行 /reflect，可将其中的经验转化为技能修改，由用户审核批准。
• /poteto-mode write a skill for <workflow> 会运行技能编写流程。评估流程会盲测技能变更。
• 请在技能自身的 PR 中修复行为异常的技能，不要在出错的功能开发工作中顺手修改。

指南第 9 页介绍了这些内容。

回复

开门见山地给出答案。最多提供一个代码块中的示例提示词；如果适用，请改编自 references/recipes.md，然后附上该文件的链接。除非用户要求完整指南，否则请保持简短。