cross-agent-install-smoke

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Cross-Agent Install Smoke

跨Agent安装冒烟测试

Validate additive skills sync without mutating live harness installs.

Scope: Install smoke only. Do not run live apply installs unless the maintainer explicitly requests it.

验证增量技能同步，且不会修改实时harness安装。

适用范围： 仅用于安装冒烟测试。除非维护人员明确要求，否则请勿运行实时apply安装。

Dispatch

调度

$ARGUMENTS	Action
Empty / `phase1` / `dry-run`	Run phase 1 dry-run JSON assertions
`phase2` / `local` / `smoke`	Run phase 2 temp-HOME smoke (requires `INSTALL_SMOKE=1` )
`all`	Run phase 1, then phase 2 when gated
`help`	Show phases, gates, and example commands

参数($ARGUMENTS)	操作
空值 / `phase1` / `dry-run`	运行第一阶段试运行JSON断言
`phase2` / `local` / `smoke`	运行第二阶段临时HOME冒烟测试（需设置 `INSTALL_SMOKE=1` ）
`all`	先运行第一阶段，满足条件后再运行第二阶段
`help`	显示阶段、条件和示例命令

Phase 1 — Dry-Run JSON

第一阶段 — 试运行JSON

Run the deterministic checker from the repo root:

bash

uv run python skills/cross-agent-install-smoke/scripts/dry_run.py

Phase 1 executes the repo skills-sync dry-run command and asserts:

top-level keys:

ok

mode

inventory_count

include_installed

agents

```
mode
```
is
```
dry-run
```

each agent row includes

agent

plus bucket fields

missing

already_present

unresolved

skipped

bucket fields may be legacy string lists or compact objects
```
{count, sample, truncated}
```
(Wave 1b+ default JSON)

when present, optional buckets (

projection_ensure

projection_blocked

store_missing

internal_projection

pin_blocked

) use the same shapes

Pass criteria: script exits

and prints a JSON summary to stdout. Phase 1 is dry-run only — never

--apply

从仓库根目录运行确定性检查器：

bash

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
```
以及分类字段
```
missing
```
、
```
already_present
```
、
```
unresolved
```
、
```
skipped
```
分类字段可以是旧版字符串列表或紧凑对象
```
{count, sample, truncated}
```
（Wave 1b+ 默认JSON格式）

当存在可选分类（

projection_ensure

、

projection_blocked

、

store_missing

、

internal_projection

、

pin_blocked

）时，使用相同的格式

通过标准：脚本以状态码

退出，并向标准输出打印JSON摘要。第一阶段仅为试运行——绝不使用

--apply

。

Phase 2 — Temp-HOME Smoke

第二阶段 — 临时HOME冒烟测试

Phase 2 is opt-in and mutates only a temporary home directory.

bash

INSTALL_SMOKE=1 uv run python skills/cross-agent-install-smoke/scripts/local_smoke.py

The script:

Refuses to run unless
```
INSTALL_SMOKE=1
```
Creates an isolated
```
HOME
```
under a temp directory
Runs the repo validation command against the repo
Runs a single-harness skills-sync dry-run JSON probe
Cleans up the temp home

Never point phase 2 at a production home directory.

第二阶段为可选操作，仅修改临时主目录。

bash

INSTALL_SMOKE=1 uv run python skills/cross-agent-install-smoke/scripts/local_smoke.py

该脚本：

除非设置
```
INSTALL_SMOKE=1
```
，否则拒绝运行
在临时目录下创建独立的
```
HOME
```
针对仓库运行仓库验证命令
运行单harness技能同步试运行JSON探测
清理临时主目录

切勿将第二阶段指向生产环境的主目录。

Validation Contract

验证约定

bash

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

Completion criteria:

Phase 1 (
```
dry_run.py
```
) exits
```
0
```
in CI and local maintainer runs.
Phase 2 runs only when
```
INSTALL_SMOKE=1
```
is set.
```
scripts/check.py
```
exits
```
0
```
for the selected phase gates.

bash

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

完成标准：

第一阶段（
```
dry_run.py
```
）在CI和本地维护人员运行时以状态码
```
0
```
退出。
第二阶段仅在设置
```
INSTALL_SMOKE=1
```
时运行。
```
scripts/check.py
```
针对所选阶段条件以状态码
```
0
```
退出。

Critical Rules

关键规则

Default to dry-run; never apply live installs from this skill.
Treat skills sync JSON as evidence, not authority over repo policy.
Run phase 1 before recommending any cross-harness install reconciliation.
Gate phase 2 behind
```
INSTALL_SMOKE=1
```
and a disposable temp
```
HOME
```
.
Report harness-specific inventory errors without masking top-level
```
ok: false
```
.

默认使用试运行模式；绝不要通过此技能执行实时安装apply操作。
将技能同步JSON视为证据，而非仓库策略的权威依据。
在建议任何跨harness安装协调之前，先运行第一阶段。
第二阶段需以
```
INSTALL_SMOKE=1
```
和可丢弃的临时
```
HOME
```
作为运行条件。
报告特定于harness的清单错误，不要掩盖顶级键
```
ok: false
```
的状态。