什麼是 Pstack | 定位、版本來源與安裝
pstack 是 Lauren Tan（poteto）建立的 AI 工程技能 (Skill) 集合。它讓代理依任務選擇工作流程，再搭配程式理解、設計、測試與審查技能。目標是讓變更容易理解、可以驗證，不是增加產出的程式碼行數。
這個網站只有一個 pstack 主題。課程同時交代原版與移植版的差異，不要求安裝其他外掛，也沒有替讀者變更本機設定。
先辨認你使用的發行來源
同樣叫 pstack，不代表套件內容與模型預設完全相同。
| 來源 | 定位 | 本主題如何使用 |
|---|---|---|
| cursor/plugins 的 pstack | Cursor 原版，也提供 Claude Code 適配方式 | 解釋原始工作方法與 Cursor 入口 |
| michael-denyer/pstack-claude | 以原版為基礎的獨立移植版，包含 Codex 等環境的適配與額外技能 | 本次 67 篇逐項教學的版本基準 |
逐項教學以移植版 0.9.126、提交 2dc481be27243d4e35ce114a700c98580bb28fdd 的原文為準。它包含 43 個工作流程技能與 24 個原則技能。這不是 Cursor 原版的版本號，也不代表你的電腦已安裝或啟用相同套件。
技能數量不等於工作手冊 (Playbook) 數量。工作手冊是 poteto-mode 內部的流程，不另算成技能。
選擇一條安裝路徑
下列是上游提供的操作說明，不是本教學已執行的操作。若已有安裝，不必重複安裝另一個來源。先確認套件名稱與技能清單，避免同名技能互相遮蔽。
Cursor 原版
在 Cursor 執行以下指令。
/add-plugin pstack原版在 Claude Code 的安裝來源則是 cursor/plugins。
/plugin marketplace add cursor/plugins
/plugin install pstack@cursor-plugins這個來源與下面的 pstack@pstack-claude 不同，不能以原版安裝成功推論已取得移植版的全部技能。
pstack-claude 移植版
Claude Code 的移植版安裝說明以 2.1.292 或更新版本為前提。
/plugin marketplace add michael-denyer/pstack-claude
/plugin install pstack@pstack-claudeCodex 的移植版安裝指令在終端機執行。
codex plugin marketplace add michael-denyer/pstack-claude
codex plugin add pstack@pstack-claude安裝後先開啟技能選單確認探索結果。上游參考文件註明 Codex 安裝命令依特定 CLI 的 help 輸出整理，不能保證所有版本都有 plugin add。若你的版本不支援，依同份文件改用插件瀏覽器或 skills-only 安裝，不要猜測命令。原生插件的啟動掛鉤 (Hook) 還需要透過 /hooks 檢視並信任。
本主題不逐一教其他執行環境的安裝，也不要求補裝移植版原始碼中提到的伴隨外掛。技能需要額外工具時，對應教學會列出前提與缺少工具時的限制。
各平台如何指定技能
| 安裝方式 | 呼叫方式 | 注意事項 |
|---|---|---|
| Cursor 原版 | 從選單選擇 /poteto-mode 等原版技能 |
不保證含移植版新增技能 |
| Claude Code | /pstack:poteto-mode |
兩種發行來源都可能使用相同命名空間，先確認安裝來源 |
| Codex 原生插件 | 輸入 $ 與技能名，再選取對應項目，例如插入 $pstack:poteto-mode |
/skills 可用來查看技能，不把 /poteto-mode 當作預設短指令 |
| Codex skills-only | 選取 $poteto-mode 等沒有插件前綴的技能 |
不包含原生插件的路由掛鉤 |
也可以用自然語言提出需求，例如「用 pstack:how 解釋資料流」。這是指定技能的文字需求，不是另一種斜線命令。
跑第一個任務
先選一個可在本機驗證的小問題，不要一開始就授權整個 PR 堆自動合併。
- 確認技能選單中有
poteto-mode與poteto-help。 - 需要更改模型分工時，使用 setup-pstack 教學，先檢查預計寫入的設定差異。
- 提供問題、重現條件與完成條件。
- 要求代理回報修改範圍、執行的驗證及尚未證實的部分。
用 pstack:poteto-mode 修正搜尋條件在切換分頁後被清除的問題。
先在本機重現，再找根因，完成最小修正。
驗收時重新開啟頁面，確認已選條件仍在。
只修改這個問題需要的檔案，不提交、不推送、不部署。預期結果是可重跑的重現與修正證據，而不是一句「測試通過」。多代理、UI 操作與外部 PR 功能是否可用，仍取決於目前執行環境的工具及授權。
接下來讀什麼
- 工作手冊與任務路由 解釋主入口如何選流程。
- 版本與 67 個技能總覽 提供分組導覽。
- 全部技能教學 可依名稱開啟獨立教學。
- 移植版平台與呼叫參考 列出工具、安裝與驗證狀態的限制。