poteto-mode 與工作手冊 (Playbooks)
poteto-mode 是 pstack 的任務入口。它依請求挑選工作手冊 (Playbook)，把步驟列入待辦清單，再於需要時使用理解、設計、驗證等技能。本篇說明其工作方法，逐項操作另見 poteto-mode 技能教學。
工作手冊是入口技能內的流程，不是額外的技能套件。本主題的 67 個技能數量已包含 poteto-mode，不再加上下面的工作手冊數量。
正確的開啟方式
Cursor 原版從 / 選單選取 /poteto-mode。Claude Code 使用 /pstack:poteto-mode。Codex 原生插件從技能選單選取 $pstack:poteto-mode，也可用下面的自然語言指定。不要把 Cursor 的按鍵與模式操作直接套到其他平台。
用 pstack:poteto-mode 調查閒置頁面每隔一段時間出現捲動位移的問題。
先重現並記錄頻率，再修復及驗證。只做本機修改，不推送。長時間工作時，應明列停止條件與不可執行的動作。
用 pstack:poteto-mode 檢查這組 PR 的測試與已確認的審查問題。
完成可逆的本機修正並留下決策紀錄。
CI 失敗時先調查原因，不能直接視為偶發錯誤。
不得合併、強制推送或部署。需要授權的項目整理給我。想讓 /poteto-mode 跨回合持續生效：從 / 選單選取後按 Option+Enter（mac）或 Alt+Enter（Windows），它會成為 Cursor 的自訂模式 (custom mode)，每回合都留在 context 裡，直到你退出模式。只按 Enter 的話，技能只附著在那一則訊息。
Cursor 的 /loop 可用於持續工作，但不是驗證或授權的替代品。其他環境需要自己的迴圈或排程工具，不能假設有相同指令。
它實際做什麼
被呼叫後，/poteto-mode 會：
- 把你的任務配對到一個 playbook，開一個 todo 清單，第一組項目就是該 playbook 的步驟（逐字複製）。
- 步驟推進時路由到對應技能（
how、architect、swarm、tdd、unslop等）。 - 以「去除 AI 腔調」(unslop) 的格式寫回覆，同時框架給使用者與下一位維護者。
提示詞怎麼寫
不用指名 playbook，也不用列出技能。給 agent 一個目標，加上一個可檢查的完成方式，就夠了：
用 pstack:poteto-mode 修正匯出重試會寫出重複列的問題。
先重現，再修復並驗證同一筆資料只輸出一次。「先重現」與可檢查的結果能幫助入口選擇 Bug fix 流程。涉及檔案、外部工具、提交或推送時，仍需補上範圍與授權，不能只靠技能名稱推定。
23 個 playbook 對照表
| playbook | 適用情境 |
|---|---|
| investigation | 只讀的問題：X 怎麼運作、Y 為何這樣建、我們確定嗎 |
| bug fix | 重現缺陷、找根因，用執行期證據修復 |
| perf | 追蹤已量測的慢，對基線改善 |
| hillclimb | 對單一指標持續、科學地改進：假設循環、前後量測、每個被接受的改進一個 commit |
| runtime forensics | 用即時儀器診斷活體症狀（洩漏、閒置 CPU 空轉、畫面閃斷） |
| trace forensics | 診斷事後交來的剖析檔（cpuprofile、trace、spindump、heap snapshot） |
| feature | 新行為或行為變更，從指名的資料形狀蓋起 |
| refactoring | 保留行為的結構調整（改名、抽函式、去重、搬家） |
| prototype | 丟棄式原型，便宜地做出設計決定，或用觀察化解「該選哪個」的分歧 |
| visual parity | 像素級的 UI 等價：對齊兩套實作或遷移樣式系統 |
| authoring a skill | 撰寫或編輯 SKILL.md |
| eval | 盲測技能或 prompt 變更對 agent 行為的影響，再決定是否晉用 |
| babysit | 把 PR 或 PR 堆推到可合併：衝突、審查討論串、CI |
| shipping | 獨立驗證綠燈堆疊，再由下而上降落連續的已驗證區段 |
| autonomous run | 把長任務一路推到完成，中途不停手 |
| orchestrate | 常駐專案交給一個協調視窗：多天、多疊層 PR、成群的子代理 |
| autopilot-full | 一個 PR 一位負責人推到合併；每個就緒的 head 都先由 swarm 驗證 |
| autopilot-stack | autopilot-full 但不合併——建好驗好，交給你檢視與降落 |
| session pickup | 從對話記錄、雲端 agent 連結或已推送分支接手前一個 agent 的在途工作 |
| pause safely | 乾淨地暫停在途工作，以便日後恢復 |
| multi-phase plan | 跨階段或疊層 PR 的工作 |
| worktree cleanup | 以安全閘收回磁碟空間：修剪已合併或棄置的 git worktree 與過期 iOS 模擬器 |
| opening a PR | 從小而有序的 commits 開出就緒 PR；每個其他 playbook 的結尾都會用到它 |
找不到合適流程時，figure-it-out 會設計可查核的工作步驟。較大規模的常駐計畫則對應 orchestrate。工作手冊中提到的提交、推送、合併與部署，不代表呼叫入口就已授權這些動作。
來源與延伸閱讀
- 移植版 poteto-mode 原文 是本篇流程對照基準。
- 版本與技能總覽 區分工作手冊、工作流程技能及原則。
- 全部技能教學 提供各技能的輸入、步驟與驗收方式。