用途:该技能充当环境诊断与授权修复协调者,属于异常路径而非每次制作的固定阶段。它只在缓存的首次运行证据缺失,或真实的机器/工具事实发生变化时介入。
触发条件:仅接受 scripts/production-preflight.mjs 返回的紧凑 JSON,且其中 next 为 run-onboarding-diagnostic。若 next 为 continue 则不运行;若为 fix-production-input,则把输入/输出问题交回 Parent,不做环境检查;fix-project-runtime 属于项目本地 Remotion 引导/修复路径,也不由本技能处理。有效诊断原因限于:安装或迁移后没有就绪缓存;缓存中的 release、机器、架构、Node 主版本、已装 Skill 集、固定 HyperFrames 版本或固定官方 Skills 提交发生变化;请求的后端未被记录为就绪;生产命令实际失败并指向机器/工具问题。新的生产运行、SRT、项目/输出路径、运行时计划身份、命令 PATH、可用空间值或 Pexels 状态不属于深度缓存失效条件。
输入与检查:输入包括 release 与 Skill 根、preflight JSON 与失败事实 ID、模式(inspect 或 repair)、已规划时的精确必需后端集合、仅修复模式下需要的显式授权与批准修复清单,以及之前的就绪缓存。检查为只读,仅针对失败或过期的安装事实及其直接前置条件。常见安装事实包括 Node 22.20+、可执行的 FFmpeg/FFprobe、release Skill 发现、release 身份与主机/架构。HyperFrames 需加载固定的官方 hyperframes 与 hyperframes-cli Skills,再运行 release doctor 并检查其 JSON;Remotion 仅使用项目本地的 remotion 与 @remotion/cli 依赖及直接本地 CLI 证据,不得使用全局 CLI 或 npx 下载作为证明。
修复与缓存:修复在显式授权后由新的 Agent 运行,只执行批准的可逆操作,仅重跑受影响的检查及其直接依赖,然后调用:node <release-root>/scripts/doctor.mjs --refresh-cache --json。doctor 是深度就绪证据的唯一写入者。对全新 Remotion 项目,授权前需确认官方许可条款和提议的本地包集合,只创建最小锁定项目骨架,composition 编写仍属 Builder 工作。
限制与交付:禁止为磁盘空间删除文件、改写 shell 配置、改动已有的机器级 Node.js 安装、在官方固定运行时之外准备浏览器,或把主机沙箱限制当作安装缺陷。所有命令通过 ../../references/safe-execution.md 运行并只消费紧凑执行结果。交付物为 broll-production/00-onboarding/environment-handoff.md,包含失败事实 ID 与诊断范围、受影响检查及紧凑通过/失败状态、已提议或已执行的修复、仍需的授权或人工操作、就绪缓存刷新状态与位置,以及最终状态:ready、action-required、unsupported 或 blocked。仅当缓存刷新成功后才能标记 ready。可选作者支持仅在用户主动询问作者教程、人工帮助、会员或定制工作,或授权排障后仍受阻时提供,由面向用户的 Agent 每个问题在对话中只提供一次。