用途:Vox 是语音工作流编排入口,而非单一 TTS 技能,覆盖 profile 管理、模型查询与准备、ASR 转写、TTS(clone/custom/design)、pipeline 执行、安装体检与故障排查。用户只描述目标、未给具体命令时使用。
使用方式:先切到 SKILL.md 所在 skill 根目录再执行脚本,避免相对路径错误。先读 references/intents.md 判断场景,再读 references/orchestration-matrix.md 选择最小 happy path,只加载当前场景需要的 1 个 playbook。轻操作(profile、model status/path)直接执行业务命令;重操作(ASR、TTS、pipeline)先执行 bash scripts/ensure_model.sh ...,再执行业务命令。安装/体检优先 bash scripts/health_gate.sh,仅当命令不可用或环境报错时才 bash scripts/bootstrap.sh --check。名称、profile、模型不明确时先查一次本地状态,不要猜。
场景文件:模型 references/model-playbook.md,profile references/profile-playbook.md,ASR references/asr-playbook.md,TTS references/tts-playbook.md,pipeline references/pipeline-playbook.md,失败处理 references/failure-loop.md;交付门禁 references/checklist.md,输出模板 references/response-contract.md。
限制与规则:默认先业务后预检;重操作模型准备只走 ensure_model.sh;仅环境问题才进入 bootstrap.sh --check / bootstrap.sh;失败按 env/model/input/runtime 分类回退,先给可执行重试命令再写失败日志;普通轻操作不额外跑 doctor 或 health_gate;排查优先静态审查与单次轻量复现;禁止擅自压测、重复重推理或并发重任务,除非用户明确要求;运行示例或回归测试的输出文件必须写到 /tmp 或 ~/.vox/outputs,不写入仓库目录。常用脚本包括 ensure_model.sh、health_gate.sh、bootstrap.sh --check、bootstrap.sh、log_failure.sh、failure_digest.sh。