poteto-help

Poteto 帮助

以粗体或反引号标出的 skill，或以 /<name> 形式运行的 skill，都是此 skill 目录旁边的 ../<name>/SKILL.md 文件。不带前缀的原则名称对应 ../principle-<name>/SKILL.md。读取该文件并遵循其中的说明。大多数 pstack skill 仅供用户使用，因此你的 skill 工具无法加载它们。

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

要求执行工作的消息（例如“用 pstack 修复这个 bug”）不属于求助问题。读取 poteto-mode，按照其中的说明执行工作，并提一次：每项任务都以 /poteto-mode 开头，可以让它保持开启状态。

此文件将问题对应到包含答案的 skill 和参考资料。这些文件才是具体内容的依据。引用之前先读取对应文件；如果文件内容与此处的索引不一致，以该文件为准。此处的链接指向已安装的 skill，用户可能无法打开，因此请提供该文件的公开副本：https://github.com/mariusflorescu/pstack-t3/blob/main/skills/，后接其在 skills/ 下的路径。

确定他们的需求

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

• 完成设置
• 用 /poteto-mode 开始一项任务
• 针对某种情境选择 skill
• 修复出错的运行
• 按自己的需求定制 pstack

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

• 如果没有 ~/.config/pstack/pstack-models.md，说明此用户尚未运行 /setup-pstack，因此每个角色都会使用默认模型。
• 如果项目中没有 verify-* skill 或其他应用测试框架，说明 Agent 没有脚本化的方式来操作应用。如果问题是关于如何证明某项更改有效，请提及 /create-verification-skill。
• 如果项目中没有正式验证 skill，说明超出测试覆盖范围的属性都不会被检查。如果问题涉及竞态、不变量或测试很少触及的其他情况，请提及 /create-formal-verification-skill。如果已有此类 skill，且其覆盖的代码在它记录的最近一次同步提交之后发生了更改，那么当问题涉及该代码时，请提及 /maintain-formal-verification-skill。

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

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

开始设置

1. 使用 npx skills add mariusflorescu/pstack-t3 -g -a claude-code -a codex 安装。Codex 线程通过 $<name> 运行技能，而 pstack 使用 /<name>。
2. 运行 /setup-pstack。它会询问推理预算，为每个角色指定模型，并写入 ~/.config/pstack/pstack-models.md。技能会在下次委派时读取该文件。随后，它会分别询问是否为项目生成验证技能和形式化验证技能；如果项目已有相应技能，则不会询问。
3. 使用 /poteto-mode、目标，以及一个能判定通过或失败的检查，开始处理实际任务。

安装后，除非用户调用技能，否则几乎不会有任何变化。只有 /setup-pstack 和 deslop 能根据用户的文字加载，而当 Agent 处理 .ts 或 .tsx 文件时，会加载 typescript-best-practices。代码仓库中有详细信息。根据 references/prompting.md，可以主动提出与用户一起拟定第一个提示词。

如果用户担心成本，说明令牌的用途以及如何减少消耗。pstack 会在子 Agent 和评审面板上额外消耗令牌。重新运行 /setup-pstack，选择较小的预算或更便宜的模型。将角色设为 auto 或 inherit-parent 时，会使用父线程的模型；如果线程使用的是较便宜的模型，这样可以节省令牌。缩短面板列表可以减少子 Agent 的数量，每个条目对应一个子 Agent。只有需要严谨处理的工作才使用 /poteto-mode。

这个 pstack 是为 T3 Code 构建的。它的技能采用 Agent Skills 格式，因此其他工具也能读取。不过，大多数工作流技能（包括 /poteto-mode、/how、/why 和 /teach）都会使用各角色对应的模型来启动 delegate_task 子 Agent；PR 监视和计划任务则是 T3 Code 工具，因此这些部分在其他工具中可能无法使用。

使用 /poteto-mode 开始任务

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

/poteto-mode 只对一条消息生效。随着聊天继续，它的作用会逐渐减弱，而且没有可切换的模式，因此每项新任务都要以 /poteto-mode 开始。

聊天中途使用“new task”会让模式匹配一个新的操作手册。/poteto-mode 会通过 poteto-agent 打开其操作手册步骤所启动的子 Agent 简介。若想让自己启动的子 Agent 采用相同风格，请使用文件内容打开其 delegate_task 简介，并将文件中的占位符替换为 poteto-mode/SKILL.md 的绝对路径。

选择技能

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

用户想要	技能
严谨地完成任何非平凡任务	/poteto-mode
在开始前确认 Agent 理解了用户的目标和问题	/in-your-own-words
发送提示词前，将其改写得更深入而非更冗长：补充顶尖专业人士会加入的内容、他们的原始材料和方法，以及外部检查。它只返回提示词，不执行任务	/sharpen
了解代码目前如何运作，或新代码应该放在哪里	/how
了解代码为何如此设计，或某个数字的来源	/why
用浅显的语言理解某项变更或子系统	/teach
回顾自己近期在某个主题上的工作	/recall
用浅显的语言和简明图示回顾自上次发言后本次聊天中的变化，列出所有等待用户处理且仅凭回复即可决定的事项	/ketchup
了解一个小型 diff 可能对其范围之外造成的影响	/blast-radius
在编写跨越函数边界的代码前确定类型和模块结构	/architect
针对同一份简报进行多次尝试，并融合出最佳版本	/arena
将检查拆分并行执行，或让工作进程竞速，作为子 Agent 运行	/swarm
让不同模型审查 diff 并尝试找出问题	/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
在报告或依据性能数据采取行动前，审查该数据是否可靠	/benchmark-checklist
执行大型或跨领域变更，或执行离开一段时间后再审查的变更	/figure-it-out
在执行过程中记录决策，并在结束后进行复盘	/show-me-your-work
为每个角色选择模型和推理预算	/setup-pstack
将自己的工作习惯转化为个人模式技能	/automate-me
将已完成任务中的经验转化为技能修改	/reflect
防止 Agent 在此仓库中重复犯同样的错误	/correct
构建一个页面，让按钮通过 webhook 唤醒 T3 定时任务	/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 不包含：

• preview_*、device_*、watch_pull_request 和 schedule_task 是 T3 Code 工具。
• skill-creator 是一个独立的技能。
• 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 的 Playbooks 部分列出了所有 playbook 及其适用时机。playbook 涵盖 PR 的创建、跟进和落地。

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

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

修复运行出错的问题

症状	修复方法
几轮对话后，模式不再生效	随着聊天继续，模式的影响会逐渐减弱。每项任务开始时都运行 /poteto-mode。
一个问题被当作上一项任务的后续步骤处理	说“新任务”，或说明这一轮不需要该模式。
新的模型选择没有效果	技能会在委派任务时读取 ~/.config/pstack/pstack-models.md。已在运行的子 Agent 会继续使用原来的模型。
运行成本超出预期	请参阅“开始设置”下的成本段落。
某项技能没有自动加载	只有 /setup-pstack 和 deslop 会根据用户的话语加载，typescript-best-practices 会根据 .ts 和 .tsx 文件加载。其他技能会在用户输入其名称或 /poteto-mode 运行它们时加载，而且并非每次都会运行所有技能。
并行 Agent 覆盖了彼此的更改	为每个 Agent 提供独立的工作树和一个 t3_thread_launch 线程，或让同一检出目录中的子 Agent 处理互不重叠的文件。
运行了一整晚，却没有完成任何事	运行需要一个可判定通过或失败的检查，而不是设定持续时间。请参阅 references/prompting.md。
回复声称构建成功就代表一切正常	要求提供实际命令、流程、存储值或配置文件。这就是“证明它确实有效”的原则。

如果运行偏离了方向，请查看 references/prompting.md 中的单行引导语。值得照搬的配方见 references/recipes.md。

打造专属的 pstack

• /automate-me 根据用户自己的历史记录起草个人模式技能，可与 /poteto-mode 搭配使用。
• 在会话结束后运行 /reflect，将经验教训转化为技能修改，供用户审批。
• /poteto-mode write a skill for <workflow> 会运行技能编写手册。评估手册会盲测技能更改。
• 如果某项技能表现异常，请在单独的 PR 中修复，不要在出问题的功能开发中顺手修复。

代码仓库涵盖了以上所有内容。

回复

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