用途
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 始终有效。
使用方式
- 检测可用模型。
- 加载当前状态(已有配置或默认值)。
- 询问预算档位,应用映射,展示所有角色及其模型并确认。
- 校验每个真实条目。
- 覆盖写入 ~/.config/pstack/pstack-models.md(若目录不存在则创建),包含头部注释、# budget 行和每个角色一行。
- 告知用户文件已写入,并说明下次技能委派时生效;重新运行本技能会更新配置。
- 可选:检查项目是否有驱动真实应用进行验证的方式(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 相同的标签。整体覆盖写入以保证重复运行幂等。
暂未提供
关于该技能的收费、价格、平台支持范围等具体信息,资料中暂未提供。