poteto-help

Poteto 帮助

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

像“用 pstack 修复这个 Bug”这样要求执行任务的消息，不属于求助问题。阅读 poteto-mode，并按其中的说明执行任务。

此文件将问题映射到负责提供答案的已安装技能、操作手册和平台映射。回答前先阅读对应的来源。来源中的说明优先于此映射和任何上游指南；上游指南描述的是 Cursor，可能与此移植版本不同。本地链接指向已安装的插件，因此请向用户提供该文件的公开副本：https://github.com/michael-denyer/pstack-claude/blob/main/plugins/pstack/，后接相对于插件根目录的路径。

判断用户的需求

根据消息和对话推断用户的需求。对于“哪个技能可以审查 PR？”这类明确提到某种情境的问题，直接查看对应章节。如果仍不清楚用户的需求，就提出一个包含以下选项的选择题，然后只回答用户选中的章节：

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

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

• 对于模型或路由问题，确定运行时和安装类型，然后阅读 setup-pstack，了解配置表的位置以及该运行时如何加载配置表。先检查配置，再说明默认值或覆盖项是否生效。
• 如果项目中没有 verify 或 verify-* 技能，也没有其他应用测试框架，则 Agent 没有以脚本方式驱动应用程序的方法。如果问题是关于如何证明某项更改有效，请提及 /create-verification-skill。
• 如果项目中没有形式化验证技能，则不会检查测试未覆盖到的属性。如果问题涉及竞态、不变量或其他测试很少覆盖的情况，请提及 /create-formal-verification-skill。如果存在这类技能，且其覆盖的代码在该技能记录的最近一次同步提交之后有过更改，而问题又涉及这段代码，请提及 /maintain-formal-verification-skill。

如果模型配置表缺失且这会影响答案，请询问用户现在是否要为每个角色选择模型并设置默认推理力度。用户是新手、问题涉及设置或成本，或者答案取决于运行哪些模型时，这一点会有影响。每次对话最多询问一次。如果用户的需求也不明确，请将两个问题一起询问。提供两个选项：

• 现在：让用户输入 /setup-pstack，并同时回答其问题。
• 以后：回答其问题，并加上一句话，说明在运行 /setup-pstack 之前，每个角色都会继续使用默认模型。

完成设置

1. 确定用户使用的运行时，以及他们想安装原生插件／程序包，还是仅安装技能。阅读其对应的 README 或共享安装参考章节，然后提供相应的安装命令。
2. 在说明模型选择、投入程度、工作表加载或自动路由之前，先阅读 /setup-pstack，包括其中的 Other runtimes 表。对于捆绑的路由钩子或扩展，请使用当前运行时工作表中的持久设置 session hook: off 来关闭路由。加载模型工作表后，它会分别询问一次是否为项目生成验证技能和形式化验证技能，除非项目已经有相应技能。
3. 按照 references/prompting.md，提供一个包含目标和可通过或未通过的检查项的首个任务提示词。使用斜杠命令参考中当前运行时的调用语法。

在提供特定于运行时的说明或调整方案之前，若适用，请先阅读 Codex 映射或 Pi 映射。其中的路由部分介绍了钩子信任、扩展加载和仅安装技能的方式。对于其他运行时，请参阅运行时支持参考。

如果用户担心成本，请说明令牌的开销所在，以及如何减少开销。pstack 会在子 Agent 和评审面板上额外消耗令牌。重新运行 /setup-pstack，选择较低的投入程度或更便宜的模型。设为 auto 或 inherit-parent 的角色会使用聊天所用的模型；如果聊天使用更便宜的模型，成本也会更低。面板列表越短，运行的子 Agent 就越少，每个条目对应一个子 Agent。只有在需要严谨处理的工作中才使用 /poteto-mode。

使用 /poteto-mode 开始任务

/poteto-mode 会根据任务匹配工作手册，将其中的步骤复制到待办列表，并在需要时运行其他技能。跳过的步骤会保留在列表中，并标记为 skip: <reason>。好的提示词应说明目标以及如何判断任务已完成。不要列出技能，因为手动编写的步骤顺序往往会遗漏或打乱工作手册中原本会保留的步骤。帮助用户拟定提示词前，请阅读 references/prompting.md。

有关后续任务是否会自动路由，请参阅完成设置中的设置和运行时资料。承诺会自动路由前，请确认此安装已启用路由。如果未启用自动路由，则每个新任务都要调用 poteto-mode。在同一聊天过程中，说“new task”会让模式为新任务匹配一份全新的工作手册。关于子 Agent 的默认设置，请阅读 poteto-mode 的 Subagents 部分和当前运行时的映射。

选择技能

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

用户想要	Skill
严谨地完成任何非平凡任务	/poteto-mode
在开始前确认 Agent 理解了他们的目标和问题	/in-your-own-words
发送提示词前，让它变得更深入而不是更冗长：补充顶尖专业人士会加入的内容、他们的原始材料和方法，以及外部检查。它只返回提示词，不会执行任务	/sharpen
了解代码现在如何运行，或新代码应该放在哪里	/how
了解代码为何采用这种结构，或某个数字的来源	/why
用浅显的语言理解某项变更或子系统	/teach
回顾自己近期在某个主题上的工作	/recall
用浅显的语言和简明图示，回顾自上次发言以来本次聊天中的变更，并列出所有待他们处理且仅凭回复即可决定的事项	/ketchup
像 /ketchup 一样回顾，但以简短无声幻灯片视频呈现，并将待处理事项作为文字附在视频下方	/ketchup-video
了解一个小型差异可能会对其自身之外造成什么影响	/blast-radius
在编写跨越函数边界的代码前确定类型和模块结构	/architect
针对同一项任务进行多次尝试，并合并出最佳结果	/arena
对不同部分并行检查，或让多个工作者竞速	/swarm
让不同模型审查差异并尝试找出问题	/interrogate
有成本低廉的本地测试时，先编写测试再修复 Bug	/tdd
对 .ts 或 .tsx 文件应用 TypeScript 规则	/typescript-best-practices
审查前先去掉注释，并交由未编写这些注释的审查者检查	/no-comments
清除文案中的 AI 痕迹	/unslop
按照标准编写文档、RFC、README、PR 描述或提交消息	/technical-writing
用浅显的语言重新听取上一条回复	/bro
为 Agent 提供以脚本方式操作应用并验证行为的方法	/create-verification-skill
让验证 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
将自己的工作习惯转化为个人模式 Skill	/automate-me
将已完成任务中的经验转化为 Skill 修改	/reflect
防止 Agent 在此代码库中重复犯同样的错误	/correct
熟悉 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 中没有：

• Cursor 驱动器技能没有对应移植版本。poteto-mode 的 Non-negotiables 中的驱动器策略列出了 Claude Code 的对应项、run 技能和项目的 verify 技能。
• /loop 是 Claude Code 内置的技能，而 plugin-dev:skill-development 技能是 Claude Code 关于技能编写的指南。
• 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。在说明哪些操作会无人值守地运行之前，请先阅读所选 playbook 的合并规则。
• “run the eval playbook”会运行 Eval。

如果没有 /poteto-mode，像“babysit this pr”这样的短语可能会改为启动 pstack 独立的 /babysit 技能。Playbooks 部分列出了所有 playbook 及其适用场景。要了解移植版的 PR 工作流，请阅读 Babysit 或 Shipping。

pstack 没有规划技能。Claude Code 的计划模式可以与其配合使用。对于跨多个阶段或多个堆叠 PR 的工作，要求 /poteto-mode 制定计划会运行 Multi-phase plan playbook，该 playbook 会编写计划，但不会实施计划。对于设计问题，Prototype playbook 或 /architect 会先通过代码确定设计。

原则是只包含一条规则的技能，/poteto-mode 会读取并在回复中引用它。用户很少直接调用某条原则，而是使用原则名称来引导，例如“apply prove it works. show me the real output.”。在 Claude Code 中，principle-* 叶节点会从斜杠菜单中隐藏，/poteto-mode 会按路径读取它们；其他运行时可能会在技能选择器中列出它们。Principles 索引列出了这些原则。

修复运行过程中出现的问题

症状	修复方法
几轮对话后，模式不再生效	通过“准备就绪”部分中的来源检查当前运行时的路由配置。如果没有自动路由，请为每项任务调用 poteto-mode。
一个问题被当作上项任务的下一步	说“新任务”，或说明这一轮不需要该模式。
更换模型后没有效果	阅读 setup-pstack 和当前运行时的映射，然后检查其表格位置和加载方式。
运行成本超出预期	查看“准备就绪”部分中的成本说明。
某个技能没有自动加载	阅读其说明和当前运行时的技能加载说明。需要时请显式调用；/poteto-mode 不会运行每项技能。
并行 Agent 相互覆盖了对方的更改	为每个 Agent 分配自己的工作树。
通宵运行有所进展，却什么也没完成	阅读 自主运行 和当前运行时的唤醒机制。如需处理队列，请阅读上文选定的 Autopilot 操作手册。为运行设置一项可判定通过或失败的检查。
回复仅凭构建成功就宣称任务已完成	要求提供实际命令、流程、存储值或配置文件。这就是“证明它确实有效”的原则。

如果运行偏离了方向，references/prompting.md 提供了单行引导语，references/recipes.md 提供了可改编的提示词。

打造专属的 pstack

• /automate-me 根据用户自己的历史记录起草个人模式技能，供用户与 /poteto-mode 搭配使用。
• 在会话后使用 /reflect，将经验转化为技能修改，由用户审批。
• /poteto-mode write a skill for <workflow> 会运行技能编写操作手册。评估操作手册会对技能变更进行盲测。
• 应在技能自己的 PR 中修复行为异常的技能，而不是在它出错的功能开发中修复。

回复

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