企业官网建设流程全解析

如何关闭pstack自动路由：setup-pstack与session hook: off详解

【免费下载链接】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 是为 Claude Code、Codex、Pi 等 Agent 运行时移植的一套严格工作流技能栈，它的SessionStart session hook会在每次会话启动时自动注入路由指令，把任务交给poteto-mode处理。如果你希望改回手动触发，本文用两种方式教你关闭 pstack 自动路由：交互式运行setup-pstack，或手动写入session hook: off。

什么是 pstack 自动路由（SessionStart hook）

pstack 在 Claude Code 和 Codex 插件中安装了一个SessionStarthook。它在会话的startup、resume、clear、compact四种时机触发，行为定义见：

• Hook 配置：hooks/hooks.json（Claude Code）与 hooks/codex-hooks.json（Codex，Windows 下改用 hooks/session-start.ps1）
• 实际执行的脚本：hooks/session-start.sh
• 注入的路由指令：hooks/session-start-context.md

注入的内容大意是：当任务涉及多个文件、需要架构设计、或是原因未明的 bug / 性能问题时，自动调用pstack:poteto-mode技能并走它的工作流；而单文件小改动、提问、一行修改等小任务则直接处理、手动验证。

关键机制在 session-start.sh 中：脚本先读取当前运行时的模型覆盖表（Claude Code 为~/.claude/pstack-models.md，Codex 为~/.codex/pstack-models.md），只有当表中存在完整的一行session hook: off时才静默退出、不注入指令；没有表、没有这一行、或写的是其他值，路由都保持开启。

💡 注意：Codex 下 hook 首次运行前需要你在/hooks中信任该插件。

方法一：用 setup-pstack 交互式关闭（推荐）

这是最简单的方式，setup-pstack技能会引导你完成配置：

1. 在 Claude Code 中执行/pstack:setup-pstack；在 Codex 中直接说"configure pstack models"即可触发
2. 流程走到第 4 步 "Choose whether the session hook routes tasks"时，会询问你是否保留 hook（默认开启）
3. 回答off，脚本会把session hook: off写入当前运行时的覆盖表

技能完整步骤说明见 skills/setup-pstack/SKILL.md。重复运行该技能会幂等地更新覆盖表，随时可以再开回来（回答 on 或删掉该行即可）。

方法二：手动写入 session hook: off

如果你想直接改配置文件，只需在运行时对应的覆盖表中加入一行：

session hook: off

各运行时覆盖表路径（详见 setup-pstack 的运行时对照表）：

几个容易踩的坑 ⚠️：

• 必须是完整独立一行session hook: off（脚本用精确匹配），写成session hook: disabled或其他值都等于没写，路由仍是开启
• 没有覆盖表或没有这一行时，hook 默认注入指令（即默认开启）
• 想重新开启：把该行改为session hook: on或直接删除该行

关闭后并不会失去 pstack 的能力——你可以随时手动说 "Use poteto-mode to ..." 或直接调用/skill:pstack:poteto-mode，工作流照常执行，只是不再自动路由。更多说明可查阅 docs/reference.md。

什么时候建议关闭自动路由

• 你更习惯明确指定要哪个技能（如tdd、architect），而不是让 agent 自己判断
• 大部分任务都很小，自动路由显得"过重"
• 团队想统一管理 Agent 行为，只保留显式调用入口

总结：关闭 pstack 自动路由只需一步——让覆盖表里出现session hook: off这一行。走setup-pstack问答是新手最稳妥的选择，手动编辑配置则适合熟悉文件布局的用户。两种方式改的都是同一份设置，随时可逆。

【免费下载链接】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