SuperAPI AI 工具集

skill-install-dry-run-planner

部署与运维

查看项目

更新于 10-16 02:31

技能介绍

用途:从 skills-sync 的 dry-run 证据生成维护者计划,用于在正式安装前规划跨 harness 的技能同步步骤,适合核对各 harness 技能清单时使用。范围仅限 dry-run 规划,不执行实际安装。

主要能力:支持按参数分派任务。无参数时生成所有 harness 的完整 dry-run 计划;--harness <name> 针对单个 harness 适配器生成计划;--format json 输出机器可读计划;help 显示阶段、门禁和相关 runbook。

计划阶段:Validate(运行仓库校验命令)、Dry-run JSON(运行 skills-sync dry-run JSON 命令)、Review gaps(按 harness 检查缺失、未解析和跳过的行)、可选 smoke(INSTALL_SMOKE=1 临时 home 阶段,仅限维护者机器)、Apply gate(任何 --apply 前需人工批准)。另见 skills/cross-agent-install-smoke/ 和 docs/runbooks/install-smoke.md。

使用方式: uv run python skills/skill-install-dry-run-planner/scripts/plan_dry_run.py uv run python skills/skill-install-dry-run-planner/scripts/plan_dry_run.py --harness cursor --format json

校验契约: uv run python skills/skill-install-dry-run-planner/scripts/check.py

关键规则:默认 dry-run;将 sync JSON 视为证据,而非凌驾于仓库策略之上;绝不自动应用安装或运行实时 npx skills add;在建议协调前先运行阶段 1 的 dry-run 检查;临时 home smoke 需以 INSTALL_SMOKE=1 为门禁;记录未解析的目录行,而不是静默跳过。

限制:仅限 dry-run 规划,不执行 --apply 或 npx 安装;具体收费、平台支持等信息暂未提供。