Brief: shadow-docs/changes/20260917-feature-integrate-shadow-dev-cli/brief.md(分支基线:堆叠于 PR #12)
摘要
插件 6 个 skills 以裸 shadow-dev 命令为执行前提,但无机制保证命令存在。本变更将 CLI 独立仓库(stack-wuh/shadow-dev-cli v1.1.0)的版本化安装器 vendored 进插件,并以 SessionStart hook 锁版本自举:
package.json 新增 cliVersion pin(v1.1.0),hook 调 install --version <pin> --json 幂等就位
- hook 永不阻塞会话:installer 失败仅警告;
SHADOW_CLI_HOOK_DISABLE=1 可跳过(保护双仓开发)
- 退役插件内 vendored CLI 副本(scripts/shadow-dev-cli/)与旧安装脚本、bin 字段
- 文档改为自动安装说明 + 排障(
~/.local/bin PATH、手动 install/rollback、main 开发通道)
任务
- 同步 CLI 仓库安装器替换插件旧版
scripts/install-cli.sh
- wrapper 测试先行(fixture
--from 离线驱动:pin 就位秒退 / 精确装 / DISABLE 跳过 / 失败仅警告)
- 实现
hooks/bootstrap-cli.sh + hooks/hooks.json + plugin.json hooks 声明;删除 vendored 副本与 bin
- 更新
README.md、docs/cli-guide.md;端到端验证(首跑装出 shim、二跑秒退、shadow-dev help --json ok)
决策要点
- 方案对比:B 运行时 curl 拉安装器(信任链/离线/测试皆劣)、C skills 惰性自举(确定性散失)均不采用
.shadow-dev/ 项目配置目录约定另案提案,本变更不实现
Brief:
shadow-docs/changes/20260917-feature-integrate-shadow-dev-cli/brief.md(分支基线:堆叠于 PR #12)摘要
插件 6 个 skills 以裸
shadow-dev命令为执行前提,但无机制保证命令存在。本变更将 CLI 独立仓库(stack-wuh/shadow-dev-cli v1.1.0)的版本化安装器 vendored 进插件,并以 SessionStart hook 锁版本自举:package.json新增cliVersionpin(v1.1.0),hook 调install --version <pin> --json幂等就位SHADOW_CLI_HOOK_DISABLE=1可跳过(保护双仓开发)~/.local/binPATH、手动 install/rollback、main 开发通道)任务
scripts/install-cli.sh--from离线驱动:pin 就位秒退 / 精确装 / DISABLE 跳过 / 失败仅警告)hooks/bootstrap-cli.sh+hooks/hooks.json+plugin.jsonhooks 声明;删除 vendored 副本与 binREADME.md、docs/cli-guide.md;端到端验证(首跑装出 shim、二跑秒退、shadow-dev help --jsonok)决策要点
.shadow-dev/项目配置目录约定另案提案,本变更不实现