用途
setup-pstack 用于配置 pstack 各角色(role)所使用的模型。每个 pstack 技能会在其 SKILL.md 的 Models 段落中内联声明默认模型,而本技能生成的覆盖表(override sheet)会把这些默认值替换为用户实际可访问的模型。它适用于 /setup-pstack 命令,以及需要调整 pstack 模型配置的场景。
主要能力
- 检测当前会话中 Agent 工具 model 参数可接受的模型名称。
- 读取当前运行时的现有覆盖表,若不存在则从默认角色到模型的映射开始。
- 展示每个角色及其当前模型,标记需要选择的真实 slug,并列出被丢弃或改写的行。
- 询问默认推理强度(reasoning effort)以及是否有角色需要其他强度级别。
- 询问是否保留会话钩子(session hook),用于在启动、恢复、清空和压缩时注入 poteto-mode 指令。
- 校验写入的每个真实 slug 都在检测集合内,并校验推理强度级别。
- 写入当前运行时的覆盖表,覆盖整个文件以保证重复运行幂等。
- 在 Claude Code 上通过 @ 行将覆盖表接入 CLAUDE.md;在 Codex 上把模型行粘贴到 AGENTS.md。
- 可选地提供验证技能(/create-verification-skill)。
使用方式
在支持的运行时中调用 /setup-pstack。技能会按步骤执行:检测可用模型、加载当前状态、映射并确认、选择是否启用会话钩子、校验、写入覆盖表、接入配置、确认结果,并可选提供验证技能。
覆盖表包含角色到模型的映射,例如 feature、refactoring 使用 opus,bug-fix、perf-issue、hillclimb 使用 fable,arena runners、arena cross-judge pool、architect runners、interrogate reviewers 为模型列表,swarm workers 使用 opus 等。还包含 default effort 与 session hook 两行。
模型值可以是真实 slug、inherit-parent 或 auto(后两者表示角色运行在父会话的模型上,Agent 调用省略 model)。模型可携带推理强度后缀,如 opus @xhigh,级别包括 low、medium、high、xhigh、max。default effort 可设为 session 或上述级别之一。
适用场景
- 需要让 pstack 各角色使用用户实际可访问的模型时。
- 需要在不同运行时(Claude Code、Codex、Pi、GitHub Copilot、opencode、Gemini CLI 等)统一配置模型时。
- 需要调整默认推理强度或为特定角色指定不同强度时。
- 需要控制会话钩子是否注入 poteto-mode 指令时。
限制
- 不同运行时的覆盖表路径、加载方式和模型列举方式不同。
- 在 Codex 上,模型行需粘贴到 AGENTS.md,Codex 没有 @ include;会话钩子行不要粘贴到 AGENTS.md,插件钩子直接从 pstack-models.md 读取。
- 在 Claude Code 上,Agent 工具拒绝完整模型 ID,只接受家族名称。
- 不得写入未确认可用的真实 slug。
- 部分运行时的状态为“无实时会话”或“仅离线测试”,具体支持程度以资料为准。
- 资料未提供收费、价格、平台或效果相关信息。