30 lines
3.0 KiB
Markdown
30 lines
3.0 KiB
Markdown
# 跨 Runtime 适配
|
||
|
||
CLI 调用（check_deps / log_call / 上游两个 CLI）在所有 runtime 完全一致——它们只依赖 python3 与 sh。差异只在两处：frontend-design 怎么装载、critique 的双 sub-agent 怎么派。
|
||
|
||
## 适配矩阵
|
||
|
||
| Runtime | frontend-design 装载 | critique 双评审 | 备注 |
|
||
|---|---|---|---|
|
||
| ZCode | Skill 工具（首选）或 Read 原文 | Agent 工具并行派 A/B 两个子代理 | 全功能路径，E2E 验证即在此环境跑 |
|
||
| Claude Code | Skill 工具（首选）或 Read 原文 | Task/Agent 工具并行派 A/B | 同上 |
|
||
| Codex | Read 原文全文（一等路径） | 有 `spawn_agent`：按 critique.md 的 Codex 门**先问用户一次**再派；无则顺序跑 + `⚠️ DEGRADED` 横幅 | 上游需先装进 `~/.codex/skills/`（见 README） |
|
||
| OpenCode | Read 原文全文（一等路径） | 有 sub-agent 工具就派，无则降级横幅 | 同 Codex 逻辑 |
|
||
| MausBot / 其它 | Read 原文全文（一等路径） | 无 sub-agent 则降级横幅 | 限制：见下 |
|
||
|
||
「一等路径」的含义：frontend-design 是纯指导型 Skill，官方机制就是把它的 SKILL.md 全文装进执行上下文并照做。Read 原文 + `log_call.py --load` 记 sha256，与 Skill 工具装载等效且可审计——**不是降级**。降级只发生在 critique 的双评审（impeccable 自己的定义，见其 critique.md Hard Invariants）。
|
||
|
||
## 已知限制（如实告知用户，不静默吞掉）
|
||
|
||
1. **impeccable detect 只读 web markup**（HTML/JSX 等）。原生 Swift/Kotlin 源码扫不出东西——纯原生方案 critique 走 Assessment A 单评审（这是上游定义的完整方法，非降级）。本 Skill 交付形态固定为 Web 高保真原型，不受影响。
|
||
2. **impeccable 二进制按平台分发**（本机 darwin-arm64 已带）。换机器跑 check_deps 会立刻发现缺 `scripts/impeccable` 或其 bin/ 子目录——按报告里的安装指引处理；上游 README 说明二进制会在首跑时按平台下载。
|
||
3. **截图依赖本机 Chrome**。找不到时 S4/S5 的截图核对降级为 craft-floor 逐条人工核对 + 在 INTEGRATION-REPORT 的 Run Notes 声明，不静默跳过。
|
||
4. **Windows**：impeccable 用 `scripts/impeccable.cmd`，python3 可能叫 `python`——check_deps/liveness 若失败按报告指引调整；其余逻辑不变。
|
||
5. **上游版本漂移**：check_deps 记录的是路径 + 活性，不锁版本。上游大版本更新导致 playbook 接口变化时（如 critique.md 的命令名变了），S5 会暴露失败——按失败模式处理并报告，不猜测新接口。
|
||
|
||
## 路径解析优先级（check_deps 的顺序）
|
||
|
||
`$LE_APP_DESIGN_DEP_ROOTS`（冒号分隔，自定义安装位）→ `~/.agents/skills`（首选默认，与 impeccable SKILL.md 自引用路径一致）→ `~/.zcode/skills` → `~/.codex/skills` → `~/.claude/skills`。
|
||
|
||
同一机器多份副本时取优先级最高的一份并在 deps.json 记录实际路径；S2/S5 的命令一律用该路径，不硬编码。
|