poteto-help

Poteto 帮助

回答用户关于 pstack 的问题，给他们一段可以发送的提示词，并链接到答案所依据的文件。对于帮助问题，不要开始执行任务。用户问的是怎么做，而运行 pstack 会消耗实际 Token，所以让他们自行发送提示词。

像“用 pstack 修复这个 Bug”这样要求执行任务的消息，并不是帮助问题。阅读 poteto-mode，按其中要求执行任务，并提及一次：自定义模式可以让它持续生效。

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

弄清他们需要什么

根据消息和对话推断用户的需求。遇到明确指向某种情境的问题（例如“哪个技能可以审查 PR？”），直接跳转到对应部分。如果仍不清楚需求，就用以下选项提出一个选择题，然后只回答他们选中的部分：

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

检查会影响答案的状态，并且仅在相关时提及：

• 如果没有 ~/.cursor/rules/pstack-models.mdc，说明此用户尚未运行 /setup-pstack，因此每个角色都使用默认模型。
• 如果项目中没有 verify-* 技能或其他应用测试框架，说明 Agent 没有通过脚本驱动应用的方法。如果问题是如何证明更改有效，请提及 /create-verification-skill。
• 如果项目中没有形式化验证技能，说明测试覆盖范围之外的属性都未经检查。如果问题涉及竞态、不变量或其他测试很少覆盖的情况，请提及 /create-formal-verification-skill。如果已有此类技能，且其覆盖的代码在该技能记录的上次同步提交之后发生了更改，那么在问题涉及该代码时，请提及 /maintain-formal-verification-skill。

如果缺少模型规则且这会影响答案，请询问用户现在是否想为每个角色选择模型和推理预算。以下情况会产生影响：用户是新手、问题涉及设置或成本，或者答案取决于运行哪些模型。每次聊天最多询问一次。如果需求也不明确，就把两个问题一起询问。提供两个选项：

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

开始设置

1. 在聊天中使用 /add-plugin pstack 安装，或从侧边栏的 Customize 中安装。
2. 运行 /setup-pstack。它会询问推理预算，为每个角色映射一个模型，并写入一条规则。该规则适用于新聊天。随后，它会分别提供一次机会，为项目生成验证技能和形式化验证技能，除非项目已有相关技能。
3. 使用 /poteto-mode、一个目标，以及一项可通过或不通过的检查，开始一项实际任务。

安装后，在用户调用技能之前不会有任何变化。只有 /setup-pstack 会根据用户的文字加载。README 和 指南第 1 页中有详细信息。请根据 references/prompting.md，主动提出帮用户拟定第一条提示词。

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

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

其他工具可以读取这些技能，因为它们使用 Agent Skills 格式。但大多数工作流技能（包括 /poteto-mode、/how、/why 和 /teach）会按角色模型启动 Cursor 子 Agent，而 Custom Modes 和 /loop 是 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 文档列出了 Agents Window 和 CLI 中的 Custom Modes。在其他地方开始每项新任务时，都要使用 /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，然后附上该文件的链接。除非用户要求完整指南，否则请保持简短。