不克隆仓库也能装：用npx skills一行命令安装pstack全部57个技能的完整指南

不克隆仓库也能装：用npx skills一行命令安装pstack全部57个技能的完整指南

【免费下载链接】pstack-claudeClaude Code, Codex, Copilot, Pi, OpenCode, Gemini, and Prime Agent versions of Poteto's pstack. Rigorous agent workflows with Cursor primitives translated for other harnesses.项目地址: https://gitcode.com/GitHub_Trending/ps/pstack-claude

pstack是一套面向 AI 编程代理的"技能栈"（skill stack），覆盖 57 个技能目录，让 Claude Code、Codex、Pi、OpenCode、Gemini CLI 等 harness 获得严谨、可验证的 agent 工作流。本教程带你用npx skills CLI一行命令安装 pstack 全部技能——全程不需要克隆仓库、不需要管理本地目录，装完即用。

pstack 技能栈是什么，为什么值得装？

pstack 源自 Cursor 社区的 pstack 插件，本项目将其移植为跨 harness 共享的技能树：所有运行时共用同一份 plugins/pstack/skills/，按任务自动路由到正确的工作流。它把"修 bug 先复现、跨函数边界先做架构、提交前过质量审查"这类工程纪律，固化成了 agent 可以直接执行的技能。

核心入口是poteto-mode：告诉它你的目标，它会选择正确的剧本（修 bug、加功能、重构、调查……），规划并委派子代理，最后带着"失败证据 + 通过证据"交付。各剧本清单见 poteto-mode/SKILL.md。

三种安装方式对比：为什么 npx skills 最适合新手

官方文档 docs/reference.md 提供了多条安装路径，对新手来说最关键的区分是：

🎯本教程选 npx skills 的理由：一条命令、零残留、所有支持 Agent Skills 的 harness 共享同一份~/.agents/skills/目录。官方 CI 的安装校验就是用 skills CLI 复制技能树后逐文件比对源码，可靠性经过验证（见 docs/reference.md 的 Install with the skills CLI 一节）。

安装前提：快速自检清单

开始之前，确认这三点：

1. 已安装 Node.js（npx随 Node 自带，终端运行node -v能输出版本号即可）；
2. 至少一个支持 Agent Skills 的 harness：Claude Code、Codex、Pi、OpenCode、Gemini CLI 等，各运行时的发现机制见 docs/reference.md 的 Runtime support 表；
3. 网络可访问技能源：命令会从官方仓库直接拉取技能文件。

一键安装步骤：安装 pstack 全部 57 个技能

打开终端，复制这一行并回车：

npx skills add https://github.com/michael-denyer/pstack-claude/tree/main/plugins/pstack/skills --skill "*" --agent "*" --yes

参数逐项拆解

• 源路径.../tree/main/plugins/pstack/skills：直接指向仓库里的共享技能目录，不需要先把仓库克隆到本地；
• --skill "*"：通配安装全部技能，包括 33 个公开技能与 24 个principle-*原则参考（官方建议 principle 参考一并保留）；
• --agent "*"：为所有已识别的 agent 运行时注册，一份技能、多端共享；
• --yes：跳过交互确认，适合脚本化与 CI。

安装完成后，技能位于~/.agents/skills/，每个技能一个目录，如~/.agents/skills/poteto-mode/。⚠️ 注意：已存在的目标目录会被跳过而非覆盖，所以重复执行该命令不会破坏你本地改过的技能文件。

装好的技能长什么样

每个技能目录就是一套可移植的指令包：SKILL.md为主入口，可附带 references（参考资料）与 scripts（本地脚本）。举三个例子感受一下粒度：

• architect/SKILL.md：跨函数边界写代码前，先并行探索类型与模块形状；
• interrogate/SKILL.md：让三个不同模型"围攻"你的 diff，尽力找出问题；
• why/SKILL.md：多路并行取证，回答"这段代码为什么这样设计"。

57 个技能速览表（挑几个最高频的）

完整清单（33 个公开技能 + 24 个 principle 参考）见 docs/reference.md 的 Slash commands 表。

安装完成后验证：确认你的 harness 发现全部技能

不同 harness 的确认方式略有差异：

• Claude Code：纯技能安装不含插件路由，需显式加载技能或按名字请求，例如直接说"Use poteto-mode to fix the search filter resetting when I change pages."；
• Codex：直接按名字请求poteto-mode，或选择pstack:poteto-mode条目；
• Pi：用/skill:<name>调用技能（Pi 的完整安装见 docs/reference.md 的 Pi 一节）；
• Gemini CLI：运行/skills list检查发现，变更后/skills reload。

✅验证标准：poteto-mode、architect、arena、interrogate都能被按名字唤起，即安装成功。

💡小技巧：纯技能安装没有自动路由钩子（那是 Claude Code / Codex 插件版才有的功能）。想接近自动路由的体验，在你的运行时指令文件中加一条常驻指令，例如"涉及多文件、架构选择或原因未知的 bug 时，先调用 poteto-mode"。

更新、卸载与可选进阶配置

如何更新到最新技能

重新执行上面那条npx skills add命令即可——它会从源目录重新拉取；已被你手动修改或本地已存在的技能目录会被跳过，不会覆盖你的改动。若希望"干净重装"，先删除对应技能目录再执行命令。

如何卸载某个技能

删除~/.agents/skills/<技能名>目录即可，该技能会从所有使用此目录的运行时中消失。

进阶：用 setup-pstack 按角色配置模型

装完技能后，可以运行setup-pstack技能（各 harness 指令不同，Claude Code 插件版为/pstack:setup-pstack）：它会探测你可用的模型，为"功能开发 / 修 bug / 并行评审小组 / 推理档位"等角色写入覆盖表。各运行时的配置路径速查：

详细说明见 setup-pstack/SKILL.md 的 Other runtimes 表格，模型默认值定义在 models.json。

依赖提示

• 用到 PR 监控与发版剧本（babysit、fix-ci等）时，需安装 GitHub CLI 并完成gh auth login；
• 附带脚本（watch-pr、orch）需要 Bun，首次运行会自动安装脚本依赖。

纯技能安装无服务器、无遥测：脚本都在本地运行，PR 工具走你自己的gh登录态。

常见问题 FAQ

Q1：为什么我的终端里npx skills提示找不到包？确认 Node.js 版本较新（node -v），并检查网络。npx首次运行会下载 skills CLI，耐心等待即可。

Q2：npx skills 安装和 clone + 软链接有什么区别？软链接指向你本地的克隆目录（克隆必须长期保留，更新靠git pull）；npx skills 直接把文件复制到~/.agents/skills/，不留克隆、更新靠重跑命令。两种都属于"纯技能安装"，都不含自动路由钩子。

Q3：principle-目录是什么，可以只装一部分吗？* 它们是各工作流引用的"原则参考"（懒惰协议、证明它可用、先减后加等）。官方建议全部保留——技能正文会在决策时引用它们。

Q4：装完发现某些技能没被 harness 发现？先确认该 harness 是否支持 Agent Skills 发现机制（对照 docs/reference.md 的运行时支持表）；Gemini CLI 可先/skills reload再/skills list复查。

Q5：我以后想升级到 Claude Code 插件版怎么办？直接装插件版即可，两者技能来源相同；插件版额外提供 SessionStart 自动路由钩子与子代理工具，无需卸载技能树。

小结：三步完成 pstack 技能栈安装

1. 终端执行一行npx skills add ...命令，不克隆仓库装齐 57 个技能；
2. 在你的 harness 中按名字请求poteto-mode，验证技能被发现；
3. （可选）运行setup-pstack按角色配置模型与推理档位。

从此修 bug 会先复现、跨界改动先过架构评审、提交前自动过质量关——严谨的 agent 工作流，一行命令即就位 🚀

【免费下载链接】pstack-claudeClaude Code, Codex, Copilot, Pi, OpenCode, Gemini, and Prime Agent versions of Poteto's pstack. Rigorous agent workflows with Cursor primitives translated for other harnesses.项目地址: https://gitcode.com/GitHub_Trending/ps/pstack-claude