SuperAPI AI 工具集

cross-agent-install-smoke

部署与运维

查看项目

更新于 10-16 02:32

技能介绍

用途:验证增量式技能同步(skills sync)在跨harness场景下的安装一致性,且不修改真实harness安装。仅限安装冒烟测试,除非维护者明确要求,否则不要执行真实apply安装。

调度动作:空/phase1/dry-run 运行阶段1干跑JSON断言;phase2/local/smoke 运行阶段2临时HOME冒烟(需INSTALL_SMOKE=1);all 先阶段1,满足门控再阶段2;help 显示阶段、门控与示例命令。

阶段1(干跑JSON):在仓库根目录运行 uv run python skills/cross-agent-install-smoke/scripts/dry_run.py。脚本执行仓库skills-sync干跑命令并断言:顶层键 ok、mode、inventory_count、include_installed、agents;mode为dry-run;每个agent行包含agent及bucket字段 missing、already_present、unresolved、skipped;bucket字段可为旧式字符串列表或紧凑对象{count, sample, truncated};可选bucket(projection_ensure、projection_blocked、store_missing、internal_projection、pin_blocked)存在时使用相同形状。通过标准:脚本退出码0并向stdout打印JSON摘要。阶段1仅干跑,绝不--apply。

阶段2(临时HOME冒烟):需显式开启,仅修改临时home目录。运行 INSTALL_SMOKE=1 uv run python skills/cross-agent-install-smoke/scripts/local_smoke.py。脚本在INSTALL_SMOKE=1未设置时拒绝运行;在临时目录下创建隔离HOME;对仓库运行验证命令;运行单harness skills-sync干跑JSON探测;清理临时home。切勿将阶段2指向生产home目录。

验证契约:uv run python skills/cross-agent-install-smoke/scripts/check.py 与 INSTALL_SMOKE=1 uv run python skills/cross-agent-install-smoke/scripts/check.py。完成标准:阶段1在CI与本地维护者运行中退出0;阶段2仅在INSTALL_SMOKE=1时运行;check.py对所选阶段门控退出0。

关键规则:默认干跑,绝不从此技能执行真实安装;将skills sync JSON视为证据而非仓库策略权威;在建议任何跨harness安装协调前先运行阶段1;阶段2须以INSTALL_SMOKE=1和一次性临时HOME为门控;报告harness特定清单错误时不要掩盖顶层ok: false。