SuperAPI AI 工具集

setup-pstack

智能体与模型

查看项目

更新于 10-15 14:27

技能介绍

用途

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。
  • 部分运行时的状态为“无实时会话”或“仅离线测试”,具体支持程度以资料为准。
  • 资料未提供收费、价格、平台或效果相关信息。