跳到主內容

Theme / 0.9.130

Pstack

用可驗證的工作流程協作,從單一入口學會工程技能

基礎觀念

版本與技能總覽 | 43 個工作流程、24 個原則

以 pstack-claude 0.9.126 為基準,逐項連到 67 篇技能教學,標明與 Cursor 原版的差異及原則技能的呼叫限制。

版本與技能總覽 | 43 個工作流程、24 個原則

這份目錄對應 pstack-claude 0.9.126 的 67 個技能,每個名稱各有一篇教學。所有文章都留在單一 pstack 主題,沒有另建 cursor-team-kit 或 thermos 主題,也不要求補裝它們。

各篇包含適用情境、準備、操作步驟、可貼上的提示詞、預期結果、權限限制及固定版本來源。也可以直接使用 全部技能教學入口或全部技能速查表(單頁展開)。

先分清三種名稱

  • 工作流程技能 (Workflow Skill) 處理需求、理解、設計、審查或驗證等任務。本版有 43 個。
  • 原則技能 (Principle Skill) 約束決策方式。本版有 24 個,原文標示 user-invocable: false,通常由 poteto-mode 按需讀取。
  • 工作手冊 (Playbook) 是 poteto-mode 內的流程步驟,不是新增的技能,也不再計入 67 個。

Claude Code 的工作流程技能使用 /pstack:<name>。Codex 原生插件從技能選單選取後插入 $pstack:<name>,skills-only 安裝則沒有插件命名空間。下文的自然語言提示詞不是新增的 slash command。

原則頁不提供虛構的 slash 或 $ 指令。需要強調某條原則時,以「套用 principle-laziness-protocol」等自然語言指定,並讓代理讀取原文。

與 Cursor 原版的差異

這裡的版號屬於 pstack-claude 移植版,不是 Cursor 原版 的版號。

本次對照的 Cursor 原版目錄有 34 個工作流程技能與 24 個原則。它包含 make-bot-ui,但該技能不在本次指定的移植版清單,因此不另加第 68 篇。移植版另含下表標示「移植版新增」的 10 個技能。這個標記只表示與此次核對的 Cursor pstack 目錄不同,不表示技能一定由移植版作者原創。

兩個來源也可能在同名技能內使用不同工具、模型與權限流程。請以自己實際安裝的來源為準,不把目錄對照當作跨平台行為相同的證明。

入口與需求整理 | 6 個

查看 6 個技能教學
技能教學 什麼時候使用
poteto-mode 依任務選工作手冊,安排執行與驗證
poteto-help 不確定該用哪個技能,先查入口與分類
setup-pstack 確認可用模型、角色分工與路由掛鉤設定
in-your-own-words 實作前讓代理重述需求、範圍與驗收
sharpen 把模糊請求縮成可執行、可判定完成的需求
automate-me 從可取得的工作紀錄找出值得自動化的重複步驟

理解與回顧 | 8 個

查看 8 個技能教學與選用建議

快速選用: 追蹤目前程式流程用 how,查設計形成原因與歷史證據用 why;重建跨對話工作脈絡並核對現況用 recall,整理本輪最新進度與待決事項用 ketchup;依指定期間內本人的 Git 提交整理近況則用移植版新增的 what-did-i-get-done。

技能教學 什麼時候使用
how 追蹤實際程式路徑,解釋系統如何運作
why 用歷史與實作證據理解設計形成的原因
teach 把技術內容轉成適合目前讀者的教學
bro 用較直白的方式解釋技術,但不省略關鍵條件
recall 從可取得的對話或紀錄找回先前的決策
ketchup 整理本次對話自上次使用者訊息後的進展,並列出等待使用者決定的事項
ketchup-video 以字幕影片呈現本次對話自上次使用者訊息後的進展,待決事項另以文字列出
what-did-i-get-done 移植版新增。從 Git 紀錄整理可追溯的工作摘要

設計與實作 | 5 個

查看 5 個技能教學
技能教學 什麼時候使用
architect 跨函式邊界前,探索不同介面與模組切分
arena 對同一題比較候選方案,選基底再整合有用部分
swarm 把可獨立處理的範圍分派出去,再彙整覆蓋結果
figure-it-out 現有流程不適用時,設計有檢查點的執行流程
tdd 先建立失敗案例,再實作並驗證行為

審查與品質 | 8 個

查看 8 個技能教學
技能教學 什麼時候使用
blast-radius 修改前確認呼叫端、共享狀態與可能受影響範圍
interrogate 讓獨立審查者針對證據挑戰方案或變更
thermo-nuclear-review 移植版新增。依風險展開較完整的審查
thermo-nuclear-code-quality-review 移植版新增。深入檢查維護成本與程式品質
thermos 移植版新增。對變更找出有證據、值得處理的問題
deslop 移植版新增。移除基準差異中的無用防禦與樣板
no-comments 刪減重述程式的註解,保留必要原因與專案要求
typescript-best-practices 檢查 TypeScript 型別、分支與邊界設計

驗證與證據 | 6 個

查看 6 個技能教學
技能教學 什麼時候使用
create-verification-skill 建立下一次也能重跑的專案操作驗證
maintain-verification-skill 畫面或流程變動後,修復既有驗證方式
create-formal-verification-skill 選定高風險性質,以適合的工具建立形式驗證
maintain-formal-verification-skill 模型或實作變動後,更新假設並重跑驗證
statechart 建立與檢查 TLA+ 狀態模型,產生 Mermaid 狀態圖與違反規則的最短路徑
benchmark-checklist 測量前確認指標、負載、對照與可能誤差

PR 與 CI | 5 個

查看 5 個技能教學

以下五個技能均為此次對照下的移植版新增項目。需要遠端平台、GitHub CLI 或登入時,先確認能力與授權。讀取 PR 不等於可以提交、推送或合併。

技能教學 什麼時候使用
get-pr-comments 收集 PR 審查留言,區分真實問題與雜訊
fix-ci 依失敗工作與日誌定位 CI 問題,不盲目重跑
fix-merge-conflicts 解決衝突並確認兩側意圖與行為都被保留
babysit 依選定模式追蹤 PR 的 CI 與審查狀態
make-pr-easy-to-review 整理差異與描述,降低審查者理解成本

文字與決策 | 5 個

查看 5 個技能教學
技能教學 什麼時候使用
unslop 寫出具體、可讀、不誇大的說明
technical-writing 依讀者需求安排教學、操作指南、參考或解釋
reflect 從一次工作找出可重現的改進,核准後才更改既有技能
correct 找出代理反覆犯的錯誤,以架構、型別、lint 或測試阻止重犯,並用過往錯誤驗證檢查有效
show-me-your-work 為長任務留下能追溯選擇與驗證的決策紀錄

開發原則 | 24 個

查看 24 個原則教學

這些頁面教的是如何影響實際決策,不是再加一批可以直接輸入的短指令。共同前提是原文 user-invocable: false。原則不凌駕專案規則、權限或不可逆操作的確認。

原則教學 要解決的問題
principle-attack-the-premise 同一前提下多次修正都失敗,先檢驗前提
principle-boundary-discipline 把驗證與轉換放在系統邊界,避免內層重複防禦
principle-build-the-lever 建立能執行或證明工作的工具,而非只手動處理
principle-encode-lessons-in-structure 把重複提醒改成檢查、型別或可執行規則
principle-exhaust-the-design-space 新穎設計先比較候選原型,再選方案
principle-experience-first 以使用者實際體驗判斷取捨,而非只看實作便利
principle-explain-the-number 解釋測量在量什麼,排除替代原因
principle-fix-root-causes 追到狀態第一次變錯的位置,不只掩蓋症狀
principle-foundational-thinking 先確定核心資料形狀、所有權與共享狀態
principle-guard-the-context-window 控制大量閱讀與代理輸出的內容負擔
principle-laziness-protocol 選擇解決問題所需的最小變更
principle-make-operations-idempotent 讓重試與重啟收斂到同一個正確結果
principle-migrate-callers-then-delete-legacy-apis 搬完呼叫端後刪除舊 API,避免永久雙軌
principle-minimize-reader-load 減少跳轉、隱藏狀態與不必要的間接層
principle-model-the-domain 用資料結構表達狀態與規則,不散落條件判斷
principle-never-block-on-the-human 在授權內推進可逆工作,保留必要確認點
principle-outcome-oriented-execution 依目標架構收斂,不保留拋棄式相容狀態
principle-prove-it-works 對實際成果驗證,不把編譯當作完整證明
principle-redesign-from-first-principles 納入新需求時重新檢查既有設計前提
principle-separate-before-serializing-shared-state 先拆開共同寫入,再決定是否需要序列化
principle-sequence-verifiable-units 每個小步都能驗證,順序本身可以展示進展
principle-subtract-before-you-add 擴充前先移除不再需要的複雜度
principle-test-behavior-not-implementation 驗證可觀察行為,不鎖死內部實作
principle-type-system-discipline 讓型別排除非法狀態,外部資料在邊界解析

建議閱讀順序

  1. 第一次使用時,先讀 安裝與版本來源,再讀 poteto-help 與 poteto-mode。
  2. 想理解既有專案時,從 in-your-own-words、how、why 開始。
  3. 要實作時,依風險選擇 architect、arena 或 swarm,不要為了平行而平行。
  4. 交付前依需求做審查與實際驗證。形式驗證只對明確模型、假設及性質成立,不保證整個系統無缺陷。
  5. 遇到決策偏離時,選一條能改變具體選擇的原則,不一次堆上所有名稱。

來源與維護基準