用途:该技能是仓库工作流中语音任务的必经入口,负责把请求规范化为确定性的档案(profile)配置,统一执行披露与清单策略,并把实际合成交给内置 $speech(默认 delegate 模式);脚本化或自动化场景可走 local-cli 回退,调用 scripts/speak_with_profile.py。
主要能力:按显式包装参数、所选 --profile、profiles 文件默认档案、基线默认(voice=cedar、speed=1.0、format mp3、模型 gpt-4o-mini-tts-2025-12-15)的顺序解析语音设置;依据 references/profile-schema.md 校验配置;要求用户可见输出包含披露文本(档案未提供时用默认“This audio was generated by AI text-to-speech.”);local-cli 输出音频并在旁写入 <audio>.manifest.json,记录输出路径、清单路径、披露文本、执行模式与播放结果。
使用方式:先确定输入(--text 或 --text-file)、档案(--profile,可无)、档案文件(--profiles-file)、显式覆盖项(--voice、--speed、--instructions、--format、输出路径)、输出意图、执行偏好与播放意图(open 或 afplay)。delegate 模式调用内置 $speech;local-cli 模式运行 scripts/speak_with_profile.py。可用 uv run python speak-with-profile/scripts/validate_manifest.py path/to/output/file.manifest.json 校验清单必需键。实时 API 调用需要 OPENAI_API_KEY。
限制:不得绕过本技能处理语音任务;不得修改内置 $speech 的行为假设,也不得修改 scripts/text_to_speech.py;仅使用内置语音;输入超过 4096 字符须先切分;缺少 API 密钥、文本来源、profiles 文件、档案 ID 未知、profiles 文件无效、捆绑脚本缺失或下游 CLI/播放失败时均快速失败并明确上报,不静默成功。preferredExecutionMode 仅作文档说明,包装脚本只实现 local-cli。