Vox

把 vox 当成一个编排入口，而不是单一 TTS skill。

先切到 skill 根目录（SKILL.md 所在目录）再执行脚本，避免相对路径错误。

使用方式

• 先读 references/intents.md ，判断请求属于哪个场景。

• 再读 references/orchestration-matrix.md ，选择该场景的最小 happy path。

• 只加载当前场景需要的 1 个 playbook；不要把所有 playbook 都读进上下文。

• 按场景执行：

• 轻操作：profile 、model status/path 直接执行业务命令。

• 重操作：ASR 、TTS 、pipeline 先走 bash scripts/ensure_model.sh ... ，再执行业务命令。

• 安装/体检：优先 bash scripts/health_gate.sh ；只有命令不可用或环境报错时才 bash scripts/bootstrap.sh --check 。

• 名称、profile、模型不明确时，先查一次本地状态，不要猜。

• 失败后按 env / model / input / runtime 分类回退，不要把广谱预检塞回主流程。

• 交付前只按矩阵和 references/checklist.md 要求做门禁；普通轻操作不要额外跑 doctor 或 health_gate 。

必读文件

• 场景判断：references/intents.md

• 统一编排：references/orchestration-matrix.md

• 交付门禁：references/checklist.md

• 输出模板：references/response-contract.md

场景文件

• references/model-playbook.md ：模型查询、路径、缓存、显式模型准备

• references/profile-playbook.md ：profile list/create/add-sample

• references/asr-playbook.md ：离线/流式/麦克风转写

• references/tts-playbook.md ：clone / custom / design

• references/pipeline-playbook.md ：端到端 ASR + TTS

• references/failure-loop.md ：失败分类、重试、规则回写

执行硬规则

• 默认先业务，后预检。

• 重操作的模型准备只走 scripts/ensure_model.sh 。

• 只有环境问题才进入 bootstrap.sh --check / bootstrap.sh 。

• 排查 skill 编排问题时，优先静态审查和单次轻量复现。

• 禁止擅自做压测、重复重推理、并发重任务，除非用户明确要求。

• 运行示例或回归测试时，输出文件必须写到 /tmp 或 ~/.vox/outputs ，不要写到仓库目录。

• 失败时先给可执行重试命令，再写失败日志。

常用脚本

bash scripts/ensure_model.sh <model-id|asr-auto|tts-default|tts-custom-default|tts-design-default> bash scripts/health_gate.sh [--require-file <...>] bash scripts/bootstrap.sh --check bash scripts/bootstrap.sh bash scripts/log_failure.sh --stage "<stage>" --command "<cmd>" --error "<msg>" [--retry "<retry-cmd>"] bash scripts/failure_digest.sh