poteto-help

Poteto 帮助

回答用户关于 pstack 的问题，提供一段可发送的提示词，并附上答案来源文件的链接。对于帮助类问题，不要开始执行任务。用户问的是如何操作，而运行 pstack 会消耗实际 token，因此让用户自行发送提示词。

要求执行任务的消息（例如“使用 pstack 修复这个错误”）不属于帮助类问题。请阅读 poteto-mode，按其中的要求执行任务，并提及一次：每项任务都以 /poteto-mode 开始，就能让它保持启用状态。

此文件将问题对应到包含答案的技能和指南页面。具体内容以这些文件为准。引用前先阅读对应文件；如果文件内容与此映射不一致，请以文件为准。此处的技能链接指向已安装的插件，用户可能无法打开，因此请提供文件的公开副本：https://github.com/ericlitman/open-pstack/blob/main/plugins/pstack/ 后接其路径。指南页面是 Lauren 的上游指南。指南展示的是 Cursor 界面，因此转述时请根据此文件转换其中的 Cursor 操作步骤。

了解用户需要什么

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

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

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

• 如果当前运行环境的配置目录中没有 pstack-models.md，就表示该用户尚未运行 /setup-pstack，因此所有角色都使用默认模型。请根据 codex-tools.md 确定配置目录。
• 如果项目中没有 verify-* 技能或其他应用运行环境，则 Agent 没有通过脚本操作应用的方法。如果用户的问题是如何证明更改有效，请提及 /create-verification-skill。

如果缺少模型规则且与问题相关，请询问用户是否想现在为每个角色选择模型和所需的推理力度。以下情况属于相关：用户是新用户、问题涉及设置或成本，或答案取决于运行的模型。每次对话最多询问一次。如果用户的需求也不明确，请将两个问题合并询问。提供两个选项：

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

准备就绪

1. 安装。在 Claude Code 中，运行 /plugin marketplace add ericlitman/open-pstack，然后运行 /plugin install pstack@open-pstack，再运行 /reload-plugins。在 Codex 中，运行 codex plugin marketplace add ericlitman/open-pstack --ref main，然后运行 codex plugin add pstack@open-pstack，并按照 codex-tools.md 启用 multi_agent。
2. 运行 /setup-pstack。它会为每个角色映射一个模型，为所分配的每种模型系列询问一个所需的工作量，探测这些模型，并生成一份模型表。该表适用于新会话。
3. 使用 /poteto-mode 开始一项实际任务，并提供目标以及一个可判定成败的检查标准。

在 Claude Code 中，输入技能名称时需带上插件前缀，例如 /pstack:poteto-mode。在 Codex 中，按名称请求技能，例如“使用 pstack:poteto-mode”。详情请参阅 README 和指南第 1 页。按照 references/prompting.md 的说明，主动提出帮助他们措辞编写第一个提示词。

如果用户担心成本，请说明令牌的用途以及如何减少消耗。pstack 会在子 Agent 和评审小组上额外消耗令牌。重新运行 /setup-pstack，并选择较低的工作量或成本更低的模型。将某个角色设为 auto 或 inherit-parent 时，该角色会使用会话的模型；如果会话使用的是成本更低的模型，就能节省令牌。评审小组的列表越短，启动的子 Agent 就越少，每个条目对应一个子 Agent。只有需要严谨处理的工作才使用 /poteto-mode。

Open Pstack 在 Claude Code 和 Codex 中共用一套技能树。/poteto-mode、/how、/why 和 /teach 等工作流技能会按角色使用不同模型启动子 Agent。你正在使用的应用所提供的模型会在该应用内运行，其他模型则通过各自已登录的命令行工具运行。Codex 没有 loop 技能，也没有 poteto-agent 类型。 codex-tools.md 列出了每个 Claude Code 工具对应的 Codex 形式。

使用 /poteto-mode 开始任务

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

/poteto-mode 是否保持开启，取决于所使用的运行环境：

• 在 Claude Code 中，一条简短的启动指令会将非简单任务引导至 /poteto-mode。输入 /pstack:poteto-mode 会将该技能附加到当前任务上，随着会话推进，技能的作用可能逐渐减弱。
• 在 Codex 中，每次开始任务时都要按名称请求 pstack:poteto-mode。
• 在两者中，只要任务需要，每次开始新任务时都使用 /poteto-mode。

在会话中说“新任务”，会让该模式为新任务匹配一份全新的操作手册。在 Claude Code 中，/poteto-mode 已会为其操作手册步骤启动的子 Agent 使用 poteto-agent。若要让自己启动的子 Agent 使用相同风格，请使用 subagent_type: "poteto-agent" 启动它。Codex 没有 poteto-agent 类型，因此请分派一个 spawn_agent，并在指令中要求它先完整阅读 poteto-mode 技能。

选择技能

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

用户想要	技能
严谨地完成任何非琐碎任务	/poteto-mode
在开始前确认 Agent 理解了他们的目标和问题	/in-your-own-words
开始前提升任务目标：更专业、更注重结果，而不是过度限定	/sharpen
了解代码当前的工作方式，或新代码应放在哪里	/how
了解代码为何采用这种结构，或某个数字的来源	/why
以浅显易懂的方式了解某项更改或子系统	/teach
回顾自己最近在某个主题上的工作	/recall
用几句浅显的话和简明图示回顾上次发言后本次聊天中的更改，并提供足够背景以便决定每个待办事项	/ketchup
了解小型差异可能会在其他地方造成哪些问题	/blast-radius
在编写跨越函数边界的代码前确定类型和模块结构	/architect
针对同一份简短需求进行多次尝试，并合并出最佳方案	/arena
将检查拆分为多个部分并行执行，或让后台子 Agent 竞速	/swarm
让多个模型审查差异并尝试找出问题	/interrogate
在本地测试成本低廉时，先编写测试再修复 bug	/tdd
将 TypeScript 规则应用于 .ts 或 .tsx 工作	/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
熟悉 pstack	/poteto-help

如果此目录旁的技能目录未列在表格中，请阅读其 frontmatter，并根据描述进行路由。principle-* 目录归入下文的原则部分。

容易混淆的情况：

• /how 解释代码的作用。/why 解释原因。/teach 会运行其中一个或两者，并用通俗易懂的方式解释结果。
• /arena 给每个工作者相同的任务说明，并合并最佳部分。/swarm 将工作拆分成多个部分或并行竞赛，并返回一份报告。
• /architect 敲定设计后立即实现。添加“with checkpoint”可在编写代码前审查设计。
• /interrogate 审查差异。/blast-radius 查找差异之外的潜在问题，并验证那个能证明更改安全的关键事实。
• /recall 重建近期聊天中的上下文。/ketchup 只涵盖自用户上次发言以来的当前聊天内容。要恢复某个特定聊天或分支，请使用 Session pickup 操作手册。
• /figure-it-out 设计一次严谨的运行。Orchestrate 操作手册运行一个跨越数天和许多 PR 的程序。Autonomous run 操作手册则推动单项任务直至满足完成条件。

pstack 中没有：

• run（CLI 和 TUI）、verify（UI）和 loop 是 Claude Code 内置功能。plugin-dev:skill-development 随独立的 plugin-dev 插件提供，技能编写流程需要它。在 Claude Code 中，使用 /plugin marketplace add anthropics/claude-plugins-official 安装，然后运行 /plugin install plugin-dev@claude-plugins-official。codex-tools.md 列出了各项功能在 Codex 中的对应项。
• /make-bot-ui 未移植，因为它依赖 Cursor routines 和 webhooks。
• pstack 没有 /orchestrate 技能。Orchestrate 是 /poteto-mode 操作手册。如果斜杠菜单中显示 /orchestrate，则说明有其他插件提供了它。

操作手册与原则

操作手册是 /poteto-mode 中的步骤列表，不是技能，因此没有斜杠命令。在 /poteto-mode 中，描述任务即可选定一个操作手册；以下短语则可直接指定：

• “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”这样的短语也可能启动用于同一任务的内置 /babysit 技能。poteto-mode 的 Playbooks 部分列出了所有操作手册及其适用场景。指南第 6 页介绍了如何打开 PR、跟进 PR 并将其合并。

pstack 没有规划技能。Claude Code 的计划模式可与其配合使用。对于跨多个阶段或多个堆叠 PR 的工作，让 /poteto-mode 制定计划会运行多阶段计划操作手册，只编写计划而不予以实现。对于设计问题，Prototype 操作手册或 /architect 会先通过代码敲定设计。

原则是每条规则一项的技能，/poteto-mode 会在回复中读取并引用它们。用户很少直接调用这些原则，通常会像“应用 prove it works。给我看真实输出。”这样直接使用其名称来引导。原则不会显示在斜杠菜单中，但按名称请求某项原则（例如 pstack:principle-prove-it-works），仍可按需加载。指南第 8 页列出了这些原则。

修复运行出错的问题

症状	修复方法
几轮对话后，模式不再生效	随着会话推进，输入的技能会逐渐淡出。每项任务开始时都运行 /poteto-mode。
某个问题被当成上一项任务的下一步	说明“新任务”，或者说明这一轮不需要该模式。
新选择的模型没有生效	/setup-pstack 中的模型设置适用于新会话。请启动一个新会话。
运行成本超出预期	请参阅“开始使用”下的成本说明段落。
技能没有自动加载	/poteto-help、/correct 和 /ketchup 仅在输入时运行。其他技能可以根据用户的措辞加载，但前提是请求符合其描述；而且 /poteto-mode 不会运行所有技能。
并行 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 改写，然后附上该文件的链接。除非用户要求提供完整指南，否则保持简短。