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 调试等，而无需自己编写底层提示词。