michael-denyer/pstack-claude

pstack‑claude – 多執行環境 代理技能 外掛

它是什麼

• pstack 外掛（最初為 Cursor 的 Claude Code 編寫）的移植版，捆綁了 54 個可重複使用的 Agent Skills。
• 這些技能是為 Claude Code 編寫的，但也可以透過共享的 ~/.agents/skills/ 目錄供 Codex、Prime Agent、opencode 和 Gemini‑CLI 執行環境使用。
• 該倉庫包含外掛清單、完整的技能樹、為 Codex 生成的命令存根，以及保持技能集與上游 Cursor 版本同步所需的工具。

為什麼重要

• 提供了一個現成的「poteto‑mode」工作流程，在工作階段開始時注入簡短指令，然後提供一套更高階的工程輔助工具（TDD、程式碼審查、PR 自動化、CI 修復等）。
• 透過將相同的技能定義暴露給多個 AI 編碼代理，使用者可以在 Claude Code、Codex、Prime Agent、opencode 或 Gemini‑CLI 之間切換，而無需重寫提示詞。
• 所有程式碼均採用 MIT 授權，並包含對原始 Cursor 外掛所做調整的全面稽核（CHANGES.md、NOTICE.md）。

安裝

• Claude Code – 新增市場條目並安裝外掛：

  /plugin marketplace add michael-denyer/pstack-claude
  /plugin install pstack@pstack-claude
  

  外掛會在工作階段開始時自動觸發（注入 poteto‑mode 指令）。可以透過刪除 hooks/hooks.json 來停用該鉤子。
• 共享技能安裝 – 複製倉庫並將每個技能符號連結到 ~/.agents/skills/：

  git clone https://github.com/michael-denyer/pstack-claude
  cd pstack-claude
  mkdir -p ~/.agents/skills
  for s in plugins/pstack/skills/*/; do ln -s "$PWD/$s" ~/.agents/skills/$(basename "$s"); done
  

  這個單一樹隨後會被 Codex、Prime Agent、opencode 和 Gemini‑CLI 發現。
• 僅 Codex – 共享安裝後，將生成的斜線命令存根連結到 ~/.codex/prompts/，並在 ~/.codex/config.toml 中啟用多代理支援。
• Gemini‑CLI / opencode / Prime Agent – 相同的符號連結技能目錄即可運作；只需重新載入執行環境的技能快取。

主要功能（精選技能）

技能	用途
poteto-mode	在首次模型回應之前，設定一個簡短的「指令」，將任何非平凡的工程請求路由到結構化工作流程。
tdd	測試驅動開發輔助工具，搭建測試、執行測試並建議修復。
fix-ci	分析 CI 失敗並提出修補程式。
fix-merge-conflicts	自動偵測並解決合併衝突。
make-pr-easy-to-review	生成簡潔的 PR 摘要和檢查清單。
get-pr-comments	將現有 PR 討論拉入工作階段以提供上下文。
what-did-i-get-done	總結最近的工作以快速更新狀態。
deslop	執行程式碼風格 lint 和清理。
thermo-nuclear-code-quality-review	深度靜態分析，揭示隱藏的 bug。

執行環境特定說明

• Claude Code – 外掛附帶一個 SessionStart 鉤子，自動觸發 poteto‑mode 指令。該鉤子位於 plugins/pstack/hooks/，如果您更喜歡手動啟動，可以將其刪除。
• Codex – 沒有鉤子系統，因此您必須明確呼叫 pstack:poteto-mode 或在 ~/.codex/AGENTS.md 中新增永久指令。斜線命令捷徑（/tdd、/fix-ci、…）透過生成的 Markdown 提示提供。
• Prime Agent – 從同一目錄發現技能；它忽略 user-invocable: false 旗標，因此內部的「principle‑*」葉子在 UI 中保持隱藏，但 poteto-mode 仍可讀取。
• opencode – 將所有 54 個技能視為公開；principle‑* 葉子會出現在選擇器中，但無害。
• Gemini‑CLI – 透過 ~/.gemini/skills/（或相容別名）載入技能。使用 activate_skill 工具執行 poteto-mode 或任何其他技能。

開發與 CI

• CI 管道（ci.yml、security.yml）重新生成生成的檔案，lint 程式碼（Bun、shell、Markdown），執行技能衝突測試，並使用 osv‑scanner 和 zizmor 掃描依賴項。
• 倉庫包含輔助指令碼（tools/generate.mjs、tools/validate-skills.mjs、tools/sync.mjs），使技能樹與上游 Cursor 版本（e8d856f）保持同步。
• VERSION 檔案是外掛版本的唯一來源；清單在生成過程中從該檔案蓋章。

依賴項

• plugin.json 中未宣告執行環境層級依賴項。唯一的選用配套外掛是 plugin‑dev（來自官方 Claude‑plugins 市場），可改善技能編寫工作流程。
• 某些 playbook 所需的系統層級工具：gh（GitHub CLI）、bun（用於捆綁指令碼）、jq 和 rg（用於稽核指令碼）。除非您執行相應的 playbook，否則這些是選用的。

授權

• 核心外掛和所有捆綁技能均以 MIT 授權發布（參見 LICENSE 和 LICENSE‑cursor‑team‑kit）。歸屬詳細資訊在 NOTICE.md 中。

底線 pstack‑claude 是一個文件完善、經過 CI 測試的多執行環境外掛，為 Claude Code 及其相容代理帶來了豐富的工程自動化技能。如果您使用任何受支援的 AI 編碼助手，安裝此倉庫即可獲得一個現成的工具箱，用於程式碼品質、PR 處理、CI 偵錯等，而無需自己編寫底層提示詞。