用途:setup-pstack 是 pstack 的设置技能,负责把 pstack 的运行环境配置成可用状态,包括 persona 就绪检查、可选的原生 agent 注册、按角色的模型与推理预算配置,以及在 Git 仓库中设置 PR 模板。请求若仅针对 PR 模板,可只执行对应步骤;完整设置会按需执行各适用步骤。
主要能力:写入 pstack 模型配置,为每个 role 指定模型与推理强度。配置存在层级覆盖:工作区 .agents/pstack-models.md 覆盖用户级 ~/.agents/pstack-models.md,harness 段落优先于平铺行,未命名的 role 回退到 examples/pstack-models.md 的默认值。可用短别名(fable、opus、sonnet、haiku),在 Codex 上映射为 gpt-6 系列、在 Grok Build 上映射为 grok-4.7;无法识别的值按 inherit-parent 处理。条目可用 model@effort 固定推理强度,并支持 ## codex、## claude-code、## grok、## hermes 等按 harness 生效的段落。语法与分层规则见 references/models-config.md,可由脚本校验。
使用方式:检查 personas 时运行 python3 "${PSTACK_SKILLS_ROOT:?}/pstack-harness/scripts/subagents.py" check;检查 Claude Code 技能列表时运行 python3 "${PSTACK_SKILLS_ROOT:?}/setup-pstack/scripts/skill-listing.py" check(install 而非 check 才会写入)。配置时先探测会话 spawn 机制接受的模型与推理强度,再读取两层配置文件,选择预算(default、unlimited、large、medium、small),展示每个 role 的模型与强度供用户确认,最后按需写文件。修改设置文件前需用户同意。
适用场景:在以 Claude Code、Codex、Hermes、Grok Build 为运行环境的 pstack 工作流中统一模型选择与推理预算;需要原生注册 persona 或 effort agent;需要统一的仓库 PR 模板。
限制:原生注册不会自动刷新,技能更新也不会刷新已注册的 persona;注册后可能需新会话才加载。Codex 的 spawn_agent 是否可用受模型设置、启动标志、spawn 深度及不可读配置层影响,配置只能作为信号,不能替代实际会话验证;Codex 项目注册需要项目信任,不应自动修改信任设置。不得写入未经确认可用的模型 slug。Hermes 无已知开关,Grok Build 无自有注册机制。资料未提供具体价格、收费或效果数据。