pstack首次运行自检验证各运行时安装是否成功的完整清单【免费下载链接】pstack-claudeClaude Code, Codex, Copilot, Pi, OpenCode, Gemini, and Prime Agent versions of Potetos pstack. Rigorous agent workflows with Cursor primitives translated for other harnesses.项目地址: https://gitcode.com/GitHub_Trending/ps/pstack-claudepstack 是一款把 Cursor 上成熟的 Agent 技能栈移植到 Claude Code、Codex、Pi、OpenCode 等多个 AI 编码运行时的工作流插件。pstack 首次运行自检是安装后必做的一步确认技能被发现、自动路由已生效、模型配置写入成功才能保证后续任务按预期执行。一、开始自检前先确认你装的是哪种运行时pstack 所有运行时共享同一棵技能树但安装方式和验证入口各不相同。完整支持矩阵见 docs/reference.md。运行时安装方式验证入口Claude Code市场插件安装/pstack:斜杠命令Codex原生插件 信任 hook/hooks、按名调用技能Pipi install安装整包/skill:斜杠命令opencode / Gemini CLI / Prime Agent克隆仓库后链接技能目录技能列表命令 技能树只有一份位于 plugins/pstack/skills/包含 33 个公开技能和 24 个principle-*参考技能。二、自检第 1 步确认技能被发现这是安装是否成功的最直接信号——斜杠命令列表里能列出 pstack 技能说明运行时已经看见了它。Claude Code在输入框敲/pstack:应能看到poteto-mode、how、why、tdd等命令。Pi敲/skill:poteto-mode能强制加载该技能。Codex原生安装后按名称请求pstack:poteto-mode即可可选地把快捷指令链接到~/.codex/prompts/。Gemini CLI用/skills list查看发现结果变更后执行/skills reload。如果你走的是纯技能安装opencode、Gemini CLI、Prime Agent 或极简 Codex 场景需要先克隆仓库并把技能链接到~/.agents/skills/git clone https://gitcode.com/GitHub_Trending/ps/pstack-claude链接脚本详见 docs/reference.md 的 Shared skills installation 一节。注意克隆目录要留在原地因为符号链接指向它。三、自检第 2 步验证自动路由SessionStart hookpstack 的魔法在于Claude Code 和 Codex 插件会在会话启动、恢复、清空、压缩时自动注入一段 poteto-mode 路由指令——遇到跨文件改动、架构决策、原因不明的 bug 时Agent 会自动走完整工作流。验证方法新开一个会话描述一个稍复杂的任务比如修复翻页时搜索条件被重置的 bug。观察 Agent 是否主动调用poteto-mode及其子技能如how、why、architect而不是直接动手改代码。几个容易踩的坑Codex 必须手动信任 hook通过/hooks审查并信任插件的 SessionStart hook否则路由指令不会注入hook 定义变更时会再次询问。Windows 用户Codex 走 PowerShell 适配器session-start.ps1如果系统组策略限制了脚本执行策略hook 会静默失败——此时路由不生效但不报错。不想要自动路由运行setup-pstack把session hook设为off即可hook 读取 session-start.sh 时会检查这张配置表。四、自检第 3 步运行 setup-pstack 验证模型配置setup-pstack是官方提供的自检与配置一体技能它会依次完成检测可用模型 → 展示各角色当前模型映射 → 校验并写入配置表。完整规则见 plugins/pstack/skills/setup-pstack/SKILL.md。在 Claude Code 中执行/pstack:setup-pstack成功完成的标志是✅ 列出了你的运行时实际可用的模型名而不是瞎写✅ 询问了默认推理强度session/low~max✅ 询问了是否保留 session hook✅ 把配置表写入对应路径并告知了加载方式。各运行时的配置表路径速查运行时配置表位置加载机制Claude Code~/.claude/pstack-models.md在CLAUDE.md加引用行Codex~/.codex/pstack-models.md模型行粘贴进AGENTS.mdPi~/.pi/agent/pstack-models.md由 Pi 扩展自动读取opencode~/.config/opencode/pstack-models.md写入opencode.json的instructionsGemini CLI~/.gemini/pstack-models.md在GEMINI.md加引用行模型默认值来自 plugins/pstack/models.json配置表只负责把默认值适配到你实际拥有的模型。五、自检第 4 步跑一个小任务做端到端确认前三步都通过后用一个真实小任务收尾验证。官方 README 里的示例任务很合适Use poteto-mode to fix the search filter resetting when I change pages.预期表现它先复现失败用how和why调查根因再委派修复最后重跑失败用例——你会收到修复结果加上失败/通过两端的证据。如果跨了函数边界它还会先拉上architect出设计。对于 Pi 用户官方还维护了一张逐条验证表 docs/pi-equivalence.md记录了每个 Claude Code 机制在 Pi 上的对应实现与验证状态可用来对照你环境的差异。六、常见问题快速排查症状可能原因处理/pstack:命令列表为空插件未装好或技能目录链接断裂重新执行插件安装命令纯技能安装检查~/.agents/skills/里的链接是否指向有效克隆目录Codex 会话不自动走工作流hook 未被信任/hooks中信任插件 hookWindows 下无路由指令PowerShell 执行策略限制检查系统组策略下的 ExecutionPolicy多模型技能arena/interrogate不并行子代理未启用Codex 在~/.codex/config.toml加multi_agent true模型名报错配置表里写了不存在的模型重跑setup-pstack它会重新检测并校验七、最终自检清单把下面 5 项全部打勾你的 pstack 就算完成了首次运行自检技能可见运行时命令列表里能列出poteto-mode等 pstack 技能路由生效新会话中复杂任务会自动进入 poteto-mode 工作流或已显式关闭 hook模型表已写入setup-pstack成功写入配置表且路径加载方式正确依赖就绪用到 PR 监控/发货时已装 GitHub CLIgh auth login用到watch-pr、orch脚本时已装 Bun端到端通过一个小任务返回了修复结果和通过证据 全部通过后就可以放心地把日常编码任务交给 poteto-mode 了——它会按任务类型自动挑选 playbook保持代码简洁、简单且经过验证。【免费下载链接】pstack-claudeClaude Code, Codex, Copilot, Pi, OpenCode, Gemini, and Prime Agent versions of Potetos pstack. Rigorous agent workflows with Cursor primitives translated for other harnesses.项目地址: https://gitcode.com/GitHub_Trending/ps/pstack-claude创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考