SuperAPI AI 工具集

upgrade-harness

通用与其它

查看项目

更新于 10-16 08:37

技能介绍

用途:检测并升级已脚手架生成的 harness,使其与当前生成器版本保持一致,处于 scaffold→edit→upgrade→sign/verify/publish 生命周期的升级环节。

主要能力:用原始脚手架相同的变量重新渲染模板,计算三类文件计划——added(上游模板新增、本地缺失)、removed(上游已移除、本地仍有)、changed(上游与本地不同)。changed 再细分为 clean 与 conflict:clean 表示本地版本仍等于原始生成结果,可安全应用;conflict 表示脚手架后用户编辑过该文件,应用时写入 Git 风格内联标记或 .rej 边车文件,供手动合并。

使用方式:Codex 命令如 /upgrade-harness(对 cwd 干跑)、/upgrade-harness path=./my-harness、/upgrade-harness path=./my-harness apply=true、/upgrade-harness path=./my-harness apply=true conflict=rej。等价 CLI:harness upgrade ./my-harness(干跑)、harness upgrade ./my-harness --apply(应用,内联冲突)、harness upgrade ./my-harness --apply --conflict=rej(应用,.rej 边车)。

退出码:0 表示无漂移或干净应用(无冲突);1 表示应用后仍有未解决冲突、非生成型 harness 或模板缺失;2 表示 --conflict= 取值错误。CI 可依据退出码 1 标记未解决冲突。

限制:仅适用于由该脚手架生成的 harness;需要模板可用;具体平台与收费信息暂未提供。