pstack 使用導讀(一):驗證技能是基礎建設

官方人員 @poteto 的 pstack Part 1 使用導讀:先裝驗證技能、CLI 槓桿、雲端代理人與 Feature Map,再談平行。

本頁目錄
  1. 來源
  2. pstack 在解決什麼
  3. 先裝好驗證技能(建議清單)
  4. Build the Lever:給 CLI,別只給 markdown
  5. 要平行時,優先 Cloud Agents
  6. Feature Map:物化記憶
  7. 平常怎麼用
  8. Cursor
  9. Grok Bot
  10. 可複製的提示範型
  11. 本週可打勾清單
  12. 提醒你
  13. 延伸閱讀

來源

這篇是官方人員 @poteto(Lauren)撰寫的系列文導讀,連回原文,非整頁翻譯。作者在 Cursor/Grok Bot 團隊,把個人嚴謹工程技能包做成 pstack

畫面、選單與權限以你當下環境為準。

pstack 在解決什麼

pstack 是一套個人用的嚴謹工程技能,目標是在代理人時代仍維持(甚至提高)出貨品質。作者在文中提到,靠這套做法能以高信心大量合併 PR,並把自己定位成 Grok Bot 程式庫的「園丁」:邊長功能、邊重構、加 lint 與檢查,讓程式庫在大量貢獻下仍撐得住。

核心主張很單純:驗證技能是基礎建設。代理人若能自己驗自己的結果,就能把迴路關起來,你不必當每一步的瓶頸。驗證做得好,整組人(含非工程)的產出會被放大。

先裝好驗證技能(建議清單)

照做順序:

  1. 安裝 pstack(Grok Bot 也可走 plugin 頁)。
  2. 執行 /create-verification-skill,讓代理人依你的 App 產出專屬驗證技能(含基本 CLI 與 Feature Map)。
  3. Dr Eggbot 加進名冊(隨 pstack 提供)。請它幫你做一隻工程 Bot,再請那隻 Bot 跑 /create-verification-skill
  4. 設每日例行任務跑 /maintain-verification-skill,避免地圖與控制方式過期。

交辦範例(可直接貼給 Dr Eggbot):

幫我建一隻工程 Bot。請它執行 /create-verification-skill,並設每日例行任務跑 /maintain-verification-skill。回覆用繁中,排程時區用 Asia/Taipei

Build the Lever:給 CLI,別只給 markdown

作者強調技術棧要能「被代理人操作」:Web/Electron 可用 Chrome DevTools Protocol(CDP);iOS 可用模擬器;理想狀態是代理人能互動、除錯、抓效能追蹤,就像你自己開發時會用的工具。若執行環境貧弱,可能要請代理人補工具(例如 lldb、開發環境的 sidecar),或乾脆選更好除錯的技術棧。

pstack 原則叫 Build the Lever(打造槓桿):做驗證技能時,優先做一支小 CLI,把點擊、導航、除錯腳本化,而不是只丟一堆說明文字。好處是代理人少寫用完即丟的腳本、少燒 token,驗證也比較可重現、可測。

一支代理人友善的 CLI,建議具備:

  • API 好組合(深模組思維,少表面、多可組裝能力)
  • 有副作用的指令提供 --dry-run
  • 用子指令漸進揭露功能,不要一次攤開全部
  • 錯誤訊息要具體,並告訴下一步該做什麼
  • 完整的 --help
  • 輸出機器可讀(例如 JSON)

同時把開發體驗一起補齊:種子資料庫、測試帳號與驗證、對測試/預備環境的 API、一致的安裝與啟動方式。這支 CLI 會變成代理人在你 App 上開工的主工具,值得像正式產品一樣維護。

要平行時,優先 Cloud Agents

驗證技能已經能把幾個 PR 帶到可合併狀態後,很多人會想用本機 git worktree 開多個代理人。作者建議先別走這條:本機空間與資源吃得兇,規模也有限。

改投資 Cursor Cloud Agents:代理人在雲端真機器上跑,能裝依賴、開 App、截圖與錄影、像真人一樣操作。第一次把雲端環境設穩後會有 snapshot,之後啟動會快很多。本機留給你與外圈 Bot;重活丟雲端,才撐得起真正的平行。

Feature Map:物化記憶

App 一複雜,代理人需要「功能地圖」才能找得到路。Feature Map 是可搜尋的地圖:有哪些功能、做什麼、從使用者視角怎麼走到那裡。/create-verification-skill 會自動建立 references/features 與 README 總覽(細節檔用連結接上)。範例可看 verification-skill-example

CLI+Feature Map 是驗證技能變強的主因:代理人少花 token 亂探,共用記憶也讓所有貢獻者受益。作者把 Feature Map 當成 codebase 決策的濃縮版,也就是一種「物化記憶」。

提醒你:至少每天跑一次 /maintain-verification-skill。代理人工作中可能順便更新地圖;維護指令負責補漏。

平常怎麼用

Cursor

  1. 提示開頭用 /poteto-mode
  2. 自動完成時按 Opt+Enter(不要只按 Enter),把技能釘成 Custom Mode,之後每一輪都會提醒代理人用這套技能。

Grok Bot

  1. 安裝 pstack 外掛。
  2. 輸入 /poteto-mode
  3. 交辦時請 Bot spawn cloud agent 去做重活,自己當協調者,保留乾淨脈絡與本機容量。

可複製的提示範型

做新功能:

/poteto-mode build 〈功能說明與脈絡〉. use /control-app to verify your changes and show me a video and screenshots as proof

/control-app 名稱以你跑 /create-verification-skill 後實際產出為準。)

Grok Bot 版(外圈協調):

spawn a cloud agent to use /poteto-mode to build 〈功能說明〉. use /control-app to verify your changes and show me a video and screenshots as proof

效能:

spawn a cloud agent to use /poteto-mode to improve the initial loading time of our app. first use /control-app to take a trace of the status quo, and identify opportunities for improvement. then do a targeted fix and use /control-app + a /swarm to confirm the win

/swarm 會扇出多個雲端代理人跑同一套驗證,適合確認效能是否真的贏、或 fuzz/回歸抽樣。

使用者回報:

驗證技能穩了之後,可放進 Grok Bot 的 routines 或 Cursor Automations:監聽 Slack/內部回饋頻道,自動請雲端代理人重現;Feature Map 夠準時,才考慮自動修。

本週可打勾清單

  • 已安裝 pstack(Cursor marketplace 或 Grok Bot plugin)
  • 已跑過 /create-verification-skill,產出 CLI+Feature Map
  • 已加入 Dr Eggbot,並有一隻工程 Bot
  • 每日例行任務:/maintain-verification-skill(時區 Asia/Taipei
  • CLI 具備 dry-run、子指令、機器可讀輸出與清楚錯誤訊息
  • 雲端代理人環境已設好並能截圖/錄影當證明
  • /poteto-mode 已釘成 Custom Mode(Cursor)或外掛可用(Grok Bot)
  • 合併進正式分支仍走人工核可;提示與技能裡不貼密鑰、token、OTP

提醒你

  • 排程例行任務請用 Asia/Taipei,避免半夜被 UTC 通知洗版。
  • 不要把密碼、金鑰、OTP 貼進提示或技能檔;憑證走產品支援的安全交接。
  • 自動重現與自動修可以開,合併與發版先停在你核可

延伸閱讀

下一篇:pstack 使用導讀(二):監督比你聰明的代理人