pstack 系列導讀：這套 skill 是什麼、四篇該怎麼讀

你可能聽人提過 pstack，打開 repo 卻只看到一長串 skill 名稱；也可能是從搜尋點進其中一篇，想知道前後還有哪些。這個系列我寫了四篇，每篇處理用 AI 寫程式時的其中一段流程。這篇導讀不重講細節，只回答三件事：pstack 是什麼、四篇怎麼串起來，還有你該從哪一篇開始。

pstack 系列｜導讀

• 從頭開始（第 1 篇）：安裝、選模型，再用 /poteto-mode 挑 playbook

本系列第 3、4 篇和這篇導讀都以 pstack 0.15.36（commit c742dd6）為準；第 1 篇用的是 0.15.29，第 2 篇是 0.15.30，細節見下方的版本說明。

pstack 是什麼

pstack 是 Lauren Tan（網路暱稱 poteto）在 Cursor 官方外掛庫 cursor/plugins 裡維護的一整組 skill，採 MIT 授權。skill 可以想成一份操作說明，告訴 AI 程式助理怎麼完成某一類工作；這裡的 AI 程式助理，指的是 Cursor、Claude Code 這類能讀寫專案檔案、替你寫程式的工具。

在 0.15.36 這一版，pstack 有 58 個 skill、24 條原則（每條都是簡短而具體的規則，名稱都是 principle-*），以及 23 個 playbook（針對某一種任務寫好的固定步驟，掛在 /poteto-mode 底下）。另外，別把它和 Unix 指令 pstack（用來印出行程的呼叫堆疊）搞混；這裡說的是這套 AI skill。

有兩件事先知道，後面會比較好讀：

• 幾乎每個 skill 都要你親自叫。 除了 /setup-pstack，其他 skill 都設定成不讓 AI 自己啟動。
• 平常只要記住一個入口。 先跑一次 /setup-pstack 選好模型；之後凡是需要嚴謹流程的任務，都用 /poteto-mode 開頭，寫清楚目標和「怎樣算完成」，它就會替你挑 playbook。卡住、不知道該用哪個 skill 時，先問 /poteto-help。

怎麼安裝、怎麼固定版本，還有在 Claude Code 裡指令要加 /pstack: 前綴，這些我都寫在第 1 篇，這裡就不重複了。

適合誰、不適合誰

綜合我在四篇裡寫過的看法，這套 skill 比較適合下面這幾種情況：

• 你用 Cursor 或 Claude Code，想讓 AI 做事更有條理，但不想先背幾十個 skill 名字（第 1 篇）。
• 改不熟的程式之前，想先弄懂機制與「為什麼長這樣」，再比較幾種設計（第 2 篇）。
• 希望「證明它能用」變成固定流程：重現、清理、檢查影響範圍、用驗證 skill 實際操作、開 PR，最後由你自己按下合併（第 3 篇）。
• 想用原則名稱中途指揮 AI、把習慣做成自己的 mode，並在權限與費用上限內讓它無人值守地跑（第 4 篇）。

反過來說，下面這些情況不必動用整套：

• 很小、很明顯的修改：直接跟 AI 說就好，不用 pstack（第 1、2 篇都提過；第 2 篇更直接說，大部分改動其實用不到那些工具）。
• 不願意為嚴謹流程多花用量：pstack 會派出子代理、組評審，讀寫的內容越多，花掉的用量就越多（見第 1、2 篇的注意事項）。
• 無人值守卻想關光所有檢查，或在沒有隔離的環境裡用 bypassPermissions：第 4 篇明確反對這麼做。合併、force push、刪資料、對客戶發訊息這類不可逆的動作，還是要由人來決定。

四篇怎麼串起來

四篇的順序，就是一件工作的流程：先裝好工具，再看懂、設計，接著證明能用，最後用原則指揮，讓它在界線內自己跑。

四篇照工作流程排列，每篇處理其中一段，細節都寫在各篇裡。

主線大致是這樣：先裝好、選好模型，之後每個任務都交給 /poteto-mode（第 1 篇）；動手改之前，先用 /how、/why、/architect 這類工具看懂程式，再比較設計（第 2 篇）；接著照實作、清理、驗證、送審的順序把事情做完，合併仍由你決定（第 3 篇）；日常則用原則名稱調整方向、把習慣做成自己的 mode，需要時寫好完成條件與界線，讓它自己跑，隔天早上再看決策紀錄（第 4 篇）。

四篇各講什麼

第 1 篇：安裝、選模型，再用 /poteto-mode 挑 playbook

第一次用，該從哪裡開始？這篇介紹兩種安裝方式、怎麼檢查並固定版本、怎麼用 /setup-pstack 選模型，以及 /poteto-mode 的任務描述該怎麼寫。讀完你會知道，不必先背下所有 skill 名字也能上手；卡住時，先問 /poteto-help 就好。

→ 第 1 篇：安裝、選模型，再用 /poteto-mode 挑 playbook

第 2 篇：改程式之前，先看懂再設計

面對不熟的程式，怎麼讓 AI 先搞懂再動手？這篇介紹 /how、/why、/architect、/interrogate 和 /arena，包括什麼時候用、指令怎麼寫、會拿到什麼，以及下一步怎麼接。大部分小改動並不需要它們；真的需要時，順序是先看懂、比較設計，最後才動手改。

→ 第 2 篇：改程式之前，先看懂再設計

第 3 篇：寫完程式之後，先證明它能用再合併

程式寫完了，怎樣才算真的能用？這篇把流程拆成實作、清理、驗證、送審四個階段，會講到 playbook、/tdd、驗證 skill、開 PR 和 babysit。另外，開 PR 不會自動開始 babysit；要不要合併，永遠由你決定。

→ 第 3 篇：寫完程式之後，先證明它能用再合併

第 4 篇：用原則指揮 AI、做出自己的 mode，再放心讓它自己跑

想改 AI 的做法，不必每次都寫一大段話。這篇會講怎麼用原則名稱中途指揮 AI、怎麼用 /automate-me、/reflect、/correct 做出自己的工作方式；也會講讓它無人值守之前，要先寫好的六段提示、權限與費用上限，以及隔天早上怎麼用 /show-me-your-work 檢查決策紀錄。

→ 第 4 篇：用原則指揮 AI、做出自己的 mode，再放心讓它自己跑

依你的情況選起點

先找出你現在卡在哪一步，再點進對應的那一篇；不必把四篇依序讀完才動手。

你的情況	建議從哪裡開始
還沒裝過，或不知道指令怎麼叫	第 1 篇
已會用 /poteto-mode，但常常一動手就改錯方向	第 2 篇
功能寫完了，卡在「怎樣才算證明能用」或開 PR	第 3 篇
日常使用已經上手，想用原則指揮、做自己的 mode，或讓它無人值守地跑	第 4 篇
只想先知道這套東西是什麼	先讀完這篇，再照上表跳過去

版本說明

這個系列每篇釘的版本不一樣，讀的時候請以該篇開頭的版本框為準：

篇	pstack	commit
第 1 篇	0.15.29	88d4751
第 2 篇	0.15.30	eb4db2b
第 3 篇、第 4 篇、本導讀	0.15.36	c742dd6

版本：本導讀以 pstack 0.15.36 為準，對應 cursor/plugins 的 commit c742dd6（2026-10-28 07:12，台北時間）。我在 2026-11-05 查證時，cursor/plugins main 最新的 commit 是 bb68f23（2026-11-04 15:20，台北時間），c742dd6 之後 pstack 資料夾都沒有變動；Claude Code 最新是 2.1.318。之後的版本，數量和行為都可能改變。

如果想裝和這篇導讀相同的版本，請先 clone 下來、checkout 到 c742dd6，再加進 marketplace；詳細步驟和不釘版本的風險，見第 1 篇和供應鏈與權限風險。

結論

pstack 是 Cursor 官方外掛庫裡的一套 skill，在本導讀釘的版本裡有 58 個 skill、24 條原則、23 個 playbook。先跑一次 /setup-pstack，平常記住 /poteto-mode，卡住時問 /poteto-help。四篇依序處理安裝與挑 playbook、看懂再設計、證明能用再送審、用原則指揮並在界線內自己跑；你不必照順序讀完，找出自己卡在哪一步，從那一篇開始就好。

延伸閱讀

• 官方 pstack（本導讀釘選的 commit）：README、指南與各個 skill。
• 指南目錄：從安裝、overnight、原則到做出自己的 mode。
• 第 1 篇｜第 2 篇｜第 3 篇｜第 4 篇
• mattpocock/skills 系列導讀和系列（1）：另一套 skill 的系列文章。
• 自己寫 Agent Skill：從 SKILL.md 結構到觸發測試與維護：skill 放哪裡、SKILL.md 怎麼寫。
• 裝了第三方 skill 和 MCP 之後，你的 Coding Agent 多了哪些破口？：權限、沙箱和鎖版本。