交给 /poteto-mode

来源

这是中文译文，方便对照阅读。本站不发行中文版插件。

对照英文：本站英文页

英文原文出处：cursor/plugins 仓库 pstack/docs/guide/02-poteto-mode.md（提交 23e4138）

把工作交给 /poteto-mode

/poteto-mode 是总入口。你给它一个目标，它从二十三个 playbook 里匹配出一个，把这个 playbook 的步骤抄进 todo 列表，再按步骤需要调用其他 skills。这一页讲好的提示词长什么样，也让你看到，真正需要写的其实很少。

看提示词会走到哪

flowchart TD
    A[Your prompt] --> B[poteto-mode]
    B --> C[Read the Principles section]
    C --> D{Match the task}
    D -->|Read-only question| E[Investigation]
    D -->|Defect| F[Bug fix]
    D -->|New behavior| G[Feature]
    D -->|Structure only| H[Refactoring]
    D -->|Measured slowness| I[Perf issue]
    D -->|Large work or no match| J[figure-it-out]
    E --> K[Verify and report]
    F --> K
    G --> K
    H --> K
    I --> K
    J --> K

图里画的是常见路线。此外还有一些 playbook，分别用来持续优化某个指标、诊断运行时症状和抓取到的 trace、做原型、让界面像素级对齐、编写和评估 skill、让 agent 自主跑完长任务、把单个 PR 或一组堆叠 PR 照看到可以合并、交付一组验证过的堆叠 PR、全自动跑完一队 PR、统筹整个项目规模的工作、接手之前的会话、安全地暂停、推进多阶段计划，以及清理 worktree（同一个仓库另外检出的一份独立工作目录）。全部 playbook 见 playbook 目录。

直接说目标

你不用写规格文档。说清哪里出了问题，或者你想要什么，再补上你已经知道、能帮 agent 省时间的信息：

/poteto-mode users get two notifications after a retry. repro first, then fix and verify.

这是一条 Bug fix 提示词。「repro first」（先复现）是实打实的约束，不是客套话，playbook 会照办。看着 todo 列表填上 Bug fix 的各个步骤。跳过的步骤也看得见，会标着 skip: <reason>。

如果对话里已经有了上下文，提示词可以短到几乎没有。下面每一条都够用：

/poteto-mode do it

continue

keep going until done

这么短也行，因为 mode 开了就一直生效，结构又都在 playbook 里。意图由你的话来说，严谨由 skill 来保证。

用「new task」切换任务

聊得久了，对话里会积下上一个任务的上下文。换话题的时候，直接说出来：

/poteto-mode new task. figure out why the cache entry survives logout. don't change any code yet.

「new task」让 /poteto-mode 重新匹配 playbook，不再沿用上一个。「don’t change any code yet」（先别改任何代码）把这次任务锁定在 Investigation。少了这两句，正做到 Feature 一半的 mode 往往会把你的问题当成 Feature 的下一步。

给并行工作各自一个 worktree

几个 agent 同时对着一个仓库干活，就会抢同一个工作区。一开始就要求隔离：

/poteto-mode new task. branch off <base> in a fresh worktree, then port the parser change there.

每个任务各用自己的分支和 worktree，agent 之间就不会踩到彼此的文件。Opening a PR playbook 改代码时本来就在 worktree 里做。所以一般只有在你要指定从哪个分支切出、放在哪里时，才需要特意说这句。

worktree 会越积越多。磁盘紧张时，可以这样问：

/poteto-mode what's eating my disk? prune the worktrees that are safe to prune.

Worktree cleanup playbook 会按三点给每个 worktree 归类：是否已经合并、有没有未提交的改动、还有哪些聊天在用它。它只删这些证据表明可以删的。只要还有未提交的改动，它就停下来等你决定。

让它继续跑

你要走开时，说清楚怎样算做完，然后就可以走了：

/poteto-mode im stepping away. keep going until the migration check reports zero old callers. log your decisions.

打算回头再审的工作，会交给 /figure-it-out。它负责设计这次运行分哪几个阶段，并用 /show-me-your-work 记一份决策日志。完整的过夜交接约定，见 睡觉时让工作继续跑。

坑： 别在提示词里把 skills 一个个列出来（「use /how, then /architect, then /arena…」）。playbook 已经排好了顺序。你手写的顺序往往会打乱步骤，或者漏掉 playbook 本来会保留的步骤。只有想推翻某个具体选择时，才点名某个 skill。

完整的分派规则，直接读 poteto-mode 本身。

下一篇：理解代码。