SuperAPI AI 工具集

setup-pstack

智能体与模型

查看项目

更新于 10-16 16:28

技能介绍

用途

setup-pstack 用于配置 pstack 的模型映射。它写入 ~/.config/pstack/pstack-models.md,这个文件决定 pstack 每个角色(role)使用哪个模型,技能在委派任务时会读取它。

主要能力

  • 检测当前会话中可用的模型:调用 orchestrator_capabilities,保留 canRunChildTask 为 true 的提供方,其列出的模型即为可传给 delegate_task 子代理的模型。这是唯一来源。
  • 加载当前状态:默认的角色到模型映射基于技能默认规则;若配置文件已存在,则读取其中的 # budget 行和角色值作为当前选择。不属于当前角色列表的行(如已退役角色)会被丢弃。
  • 设置推理预算:提供四个档位,标签固定为 unlimited(max reasoning)、large(xhigh reasoning)、medium(high reasoning)、small(medium reasoning)。
  • 按角色分配模型:默认情况下,代码类角色(feature、refactoring、bug-fix、perf-issue、hillclimb)以及 how explorer、why investigators、swarm workers、reflect tooling 使用检测到的最快的强编码模型;judgment and prose、hardest tasks、how explainer、why synthesizer、reflect judgment、divergent、synthesizer 使用检测到的最强模型;每个面板角色(arena runners、arena cross-judge pool、architect runners、interrogate reviewers)使用每个不同提供方的最强模型,最多三个条目。
  • 校验与写入:每个写入的真实条目必须存在于 orchestrator_capabilities 结果中,其提供方 canRunChildTask 为 true,模型在该提供方下列出,且 effort(若有)属于该模型的 effort 选项。inherit-parent 和 auto 始终有效。

使用方式

  1. 检测可用模型。
  2. 加载当前状态(已有配置或默认值)。
  3. 询问预算档位,应用映射,展示所有角色及其模型并确认。
  4. 校验每个真实条目。
  5. 覆盖写入 ~/.config/pstack/pstack-models.md(若目录不存在则创建),包含头部注释、# budget 行和每个角色一行。
  6. 告知用户文件已写入,并说明下次技能委派时生效;重新运行本技能会更新配置。
  7. 可选:检查项目是否有驱动真实应用进行验证的方式(verify-* 技能或现有测试框架)。若没有,可询问是否生成一个项目本地的验证技能(通过 /create-verification-skill)。

适用场景

适用于需要为 pstack 按角色精细配置模型与推理预算的用户,尤其是希望区分代码类任务、判断与写作类任务、面板类任务所用模型的场景。

限制

  • 模型来源仅限 orchestrator_capabilities 返回的结果,不得写入未返回的条目。
  • 若没有符合条件的模型,需说明并提供 inherit-parent 作为每个角色的选项。
  • effort 只能从模型列出的选项中选择,且必须落在 max > xhigh > high > medium > low 的阶梯上;不得选择阶梯之外的选项(如 ultra、ultracode、ultrathink)。若模型未列出目标档位,则使用不高于它的最高可用档位,否则标记该角色需要选择。
  • 无 effort 选项的模型不写 (<effort>)。
  • inherit-parent 和 auto 不随预算改变。
  • 面板角色的值是列表,每个条目运行一个子代理(别名条目也计入扇出数量);arena cross-judge pool 也是列表,但 Arena 会从中选择一个模型家族与父线程不同的值(若可能)。
  • swarm workers 是每个 worker 的默认模型,除非某次竞速或比较为某个分支指定了其他模型。

配置文件格式

写入的文件为纯文本,包含头部注释、# budget 行(含所选标签及其目标 effort)以及每个角色一行,使用与 poteto-mode 相同的标签。整体覆盖写入以保证重复运行幂等。

暂未提供

关于该技能的收费、价格、平台支持范围等具体信息,资料中暂未提供。