用途:为 pi-subagents 配置持久化的模型与思考(thinking)默认值。执行与角色选择由 Superwork 负责,本技能不路由单个任务,也不修改根模型。
主要能力:提供三个能力层级作为设置默认值——T1(scout、delegate,低思考)、T2(researcher、worker,高思考)、T3(reviewer、oracle,xhigh)。层级只是默认,允许针对单个角色调整。thinking 值仅为建议,只提供所选模型支持的等级,并使用 Pi 的钳制建议;advisor 解析为 oracle,不创建 advisor 覆盖。自定义 agent 没有固定层级,写入前需枚举可用 agent,并让用户把每个非内置 agent 分配到 T1/T2/T3 或保持不受管理,通过 helper 的 --custom JSON 映射传入,仅对本次调用生效,不持久化。
使用方式:解析 /skill:agent-loadout 后的参数。set [user|project] [all|T1|T2|T3|agent] 配置所选层级或角色,省略目标表示 all;unset 仅移除所选 model/thinking 覆盖;status 显示已保存覆盖而非运行时行为;doctor 对比已保存覆盖与原生运行时诊断;无参数等同 status all。set/unset 省略范围时才询问范围,status/doctor 默认 all。拒绝未知参数,不支持 on/off、自动升级或预设。写入前需解析并显示确切设置路径:用户级为 $PI_CODING_AGENT_DIR/settings.json,否则 ~/.pi/agent/settings.json;项目级为受信任 Pi 项目根下的 .pi/settings.json。
限制:不自动迁移或重写已保存覆盖,不支持 T4 和旧四层级 helper 标志。不修改 agent 文件、根/默认模型、工具、提示、技能、禁用标志、策略、回退链、provider 覆盖或无关设置。拒绝设置文件符号链接。预览为只读,写入使用锁定、修订检查、私有临时文件和原子替换。保存设置不会更新活动会话,需重载/重启并建议运行 doctor。目录成员资格不代表认证、策略或成功启动证明;付费或实时探测需单独明确批准。