skill-install-dry-run-planner

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Skill Install Dry-Run Planner

Skill安装预演规划器

Produce a maintainer plan from skills-sync dry-run evidence.

Scope: Dry-run planning only. Never run live apply installs from this skill.

根据skills-sync预演的结果生成维护者规划方案。

适用范围： 仅用于预演规划。切勿通过此skill执行实际的apply安装操作。

Dispatch

调度参数

$ARGUMENTS	Action
Empty	Full dry-run plan for all harnesses
`--harness <name>`	Plan for one harness adapter
`--format json`	Machine-readable plan
`help`	Show phases, gates, and related runbooks

参数	操作
无参数	生成所有Harness的完整预演规划
`--harness <name>`	为指定的Harness适配器生成规划
`--format json`	生成机器可读格式的规划
`help`	显示阶段、检查点及相关运行手册

Planned Phases

规划阶段

Validate — run the repo validation command
Dry-run JSON — run the skills-sync dry-run JSON command
Review gaps — inspect
```
missing
```
,
```
unresolved
```
, and
```
skipped
```
rows per harness
Optional smoke —
```
INSTALL_SMOKE=1
```
temp-home phase (maintainer machine only)
Apply gate — human approval required before any
```
--apply
```

Also see

skills/cross-agent-install-smoke/

and

docs/runbooks/install-smoke.md

验证 — 执行仓库验证命令
预演JSON生成 — 执行skills-sync预演JSON命令
检查缺口 — 检查每个Harness的
```
missing
```
、
```
unresolved
```
和
```
skipped
```
行
可选冒烟测试 —
```
INSTALL_SMOKE=1
```
临时环境阶段（仅限维护者机器）
应用检查点 — 执行任何
```
--apply
```
操作前需人工批准

另可查看

skills/cross-agent-install-smoke/

和

docs/runbooks/install-smoke.md

。

Workflow

工作流

bash

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

bash

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

Validation Contract

验证合约

bash

uv run python skills/skill-install-dry-run-planner/scripts/check.py

bash

uv run python skills/skill-install-dry-run-planner/scripts/check.py

Critical Rules

关键规则

Default to dry-run; treat sync JSON as evidence, not authority over repo policy.
Never auto-apply installs or run live
```
npx skills add
```
from this skill.
Run phase 1 dry-run checks before recommending reconciliation.
Gate temp-home smoke behind
```
INSTALL_SMOKE=1
```
.
Document unresolved catalog rows instead of silently skipping them.

默认使用预演模式；将同步JSON视为参考依据，而非仓库策略的权威标准。
切勿通过此skill自动执行安装或运行实时的
```
npx skills add
```
命令。
在建议协调操作前，先执行阶段1的预演检查。
临时环境冒烟测试需通过
```
INSTALL_SMOKE=1
```
启用。
记录未解决的目录行，而非静默跳过。