<!-- grokbot.tw · 非 SpaceXAI／xAI 官方文件 · 步驟以你畫面為準 · 來源：https://grokbot.tw/workflows/pstack-guide-pt1-zh/ -->

# pstack 使用導讀（一）：驗證技能是基礎建設

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

## 來源

這篇是**官方人員 @poteto（Lauren）撰寫的系列文導讀**，連回原文，**非整頁翻譯**。作者在 Cursor／Grok Bot 團隊，把個人嚴謹工程技能包做成 [pstack](https://cursor.com/marketplace/cursor/pstack)。

- 宣告貼文：[I'm writing a guide to pstack! Here's part one.](https://x.com/poteto/status/2094457600259842065)
- 原文長文：[The Complete Guide to pstack Pt. 1](https://x.com/i/article/2094151284949688320)
- Grok Bot 外掛：[pstack plugin](https://x.ai/bot/plugin/9717366)
- 原始碼樹：[cursor/plugins → pstack](https://github.com/cursor/plugins/tree/main/pstack)
- 驗證技能範例：[poteto/verification-skill-example](https://github.com/poteto/verification-skill-example)
- 建議一併加入的 Bot：[Dr Eggbot](https://x.ai/bot/93gOz3op1UQdBdbekQFLK)

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

## pstack 在解決什麼

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

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

## 先裝好驗證技能（建議清單）

照做順序：

1. 安裝 [pstack](https://cursor.com/marketplace/cursor/pstack)（Grok Bot 也可走 [plugin 頁](https://x.ai/bot/plugin/9717366)）。
2. 執行 `/create-verification-skill`，讓代理人依你的 App 產出專屬驗證技能（含基本 CLI 與 Feature Map）。
3. 把 [Dr Eggbot](https://x.ai/bot/93gOz3op1UQdBdbekQFLK) 加進名冊（隨 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](https://cursor.com/docs)：代理人在雲端真機器上跑，能裝依賴、開 App、截圖與錄影、像真人一樣操作。第一次把雲端環境設穩後會有 snapshot，之後啟動會快很多。本機留給你與外圈 Bot；重活丟雲端，才撐得起真正的平行。

## Feature Map：物化記憶

App 一複雜，代理人需要「功能地圖」才能找得到路。Feature Map 是可搜尋的地圖：有哪些功能、做什麼、從使用者視角怎麼走到那裡。`/create-verification-skill` 會自動建立 `references/features` 與 README 總覽（細節檔用連結接上）。範例可看 [verification-skill-example](https://github.com/poteto/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](https://grokbot.tw/workflows/docs-skills-routines-zh/) 或 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 Pt. 1](https://x.com/i/article/2094151284949688320)
- [官方文件導讀：技能、例行任務與自動化](https://grokbot.tw/workflows/docs-skills-routines-zh/)
- [電腦與 App 連線導讀](https://grokbot.tw/guides/docs-computer-apps-zh/)
- [工程艦隊縮小版：用 Grok Bot 管雲端代理人](https://grokbot.tw/guides/official-engineering-zh/)

下一篇：[pstack 使用導讀（二）：監督比你聰明的代理人](https://grokbot.tw/workflows/pstack-guide-pt2-zh/)。

## 來源
- 本頁：https://grokbot.tw/workflows/pstack-guide-pt1-zh/
- 原文／公告：https://x.com/poteto/status/2094457600259842065
