poteto-help

Poteto 帮助

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

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

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

了解他们的需求

根据消息和对话推断需求。若用户提到具体情境，例如“哪个技能可以审查 PR？”，直接前往对应部分。如果仍不清楚需求，请提出一道多选题，选项如下，然后只回答他们选择的部分：

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

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

• 没有 pstack 设置文件（在 Cursor 中为 ~/.cursor/rules/pstack-models.mdc，在其他运行环境中为 ~/.agents/pstack-models.md），表示此用户尚未运行 /setup-pstack，因此每个角色都会使用其默认模型。
• 项目中没有 verify-* 技能或其他应用测试框架，表示 Agent 没有脚本化的方式来驱动应用。如果问题涉及如何证明更改有效，请提及 /create-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 构建的。此镜像中的技能也适用于其他运行环境（Claude Code、Codex、Pi、OpenCode 等）：poteto-mode 的 Harness 部分会将 Cursor 的子 Agent、提问、记录和设置路径映射到对应运行环境的路径。自定义模式是 Cursor 的功能。

使用 /poteto-mode 开始任务

/poteto-mode 会将任务匹配到一个操作手册，将其中的步骤复制到待办列表，并在需要时运行其他技能。跳过的步骤仍会留在列表中，并标注为 skip: <reason>。好的提示词应说明目标，以及如何判断任务已完成。不要列出技能，因为手动编写的步骤顺序往往会遗漏或打乱操作手册中的步骤。请先阅读 references/prompting.md，再帮忙措辞。指南第 2 页提供了示例。

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

• 按 Enter 启动 /poteto-mode，会将该技能附加到一条消息上。随着对话继续，它的作用会逐渐消退。
• 在 Mac 上按 Option+Enter、在 Windows 上按 Alt+Enter，或在技能条目中选择 Use as Mode，会将它设为自定义模式。它会在每轮对话中持续生效，直到用户退出该模式，并且不会影响随意交流。
• Cursor 的文档列出了 Agents Window 和 CLI 中的自定义模式。在其他地方，请在每个新任务开始时使用 /poteto-mode。

遇到相关情况时，请链接到 Cursor 的技能文档。对话中途，使用“新任务”会让该模式匹配一份新的操作手册。/poteto-mode 已使用 poteto-agent 来运行其操作手册步骤所启动的子 Agent。若要让你自己启动的子 Agent 采用相同风格，请使用 subagent_type: "poteto-agent" 启动它。

选择技能

默认选择是 /poteto-mode；当其步骤需要时，它会运行大多数其他技能。如果用户想要的内容比操作手册提供的更多或更少，请直接指定某项技能。推荐技能前，请先阅读该技能，并提供一个提示词示例。

用户想要	技能
严谨地完成任何非平凡任务	/poteto-mode
在开始前确认 Agent 理解了用户的目标和问题	/in-your-own-words
开始前提升任务目标：更专业、更注重结果，避免过度指定	/sharpen
了解代码目前如何运作，或新代码应该放在哪里	/how
了解代码为何采用当前结构，或某个数字的来源	/why
用浅显的方式理解某项变更或子系统	/teach
回顾自己近期在某个主题上的工作	/recall
用几句浅显的话和简明图示回顾上次发言以来本次聊天中的变化，并提供足够的背景来决定每项待办事项	/ketchup
了解一处小型差异可能对其他部分造成哪些影响	/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
在报告或据此采取行动前，核验性能数据	/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 达到可合并状态，然后停止。除非用户要求合并、落地或发布，否则不会合并。
• “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，然后附上该文件的链接。除非用户要求完整指南，否则请保持简短。