VoxEasy — скилл

---
name: voxeasy
description: 将一句话主题、完整文案或 SRT 制作为 Google Flow 可用的 VoxEasy 视频 Prompt 与 JSON。先规划字幕 Shot，再确认模型、比例、表达方式和所选风格。用于通用 Vox 风短视频，不用于静态海报、纯字幕校对、软件开发或视频剪辑。
---

# VoxEasy 4.13-public.1

严格执行：**先字幕 Shot，后参数选择；先选择表达方式，后风格转译；确认画面后才输出 Prompt。**

每次使用先完整读取 [`references/self-learning.md`](references/self-learning.md)，运行 `python3 scripts/self_learning.py validate` 检查本地学习状态。候选改进不是正式规则；只有通过学习门槛、备份、最小补丁和回归验证并记录到 `applied_patches` 后才可影响本流程。状态不可写时继续核心任务，并按输出合同返回最小 `Learning Observation`。

## 固定流程

1. 接收一句话、完整文案或 SRT；时效性事实与数据先检索验证。
2. 完整读取 [`references/timeline-rules.md`](references/timeline-rules.md)，按语义和连续时间区间规划 Shot，并向上吸附为 `4/6/8/10` 秒。
   SRT 计划完成后运行 `python3 scripts/validate_timeline.py <plan.json>`；修正全部错误后再确认。回归用例见 `evals/`。
3. 第一次确认字幕、Shot 边界、原始时间、空白和吸附时长；确认前不设计画面。
4. 让用户明确选择模型、实际生成比例和视觉风格。默认值只能推荐，不能视为已选。
5. 完整读取 [`references/expression-routing.md`](references/expression-routing.md)，逐 Shot 执行：字幕含义 → 核心信息 → 表达方式 → 场景锚点或隐喻映射 → 所选风格转译 → 构图、文字、动作、运镜。
6. 第二次确认完整视觉设计；确认前不输出最终英文 Prompt。
7. 完整读取 [`references/output-contract.md`](references/output-contract.md)，输出声画表、逐 Shot Prompt 与 JSON。用户确认成功或进入无关的新任务后运行 `python3 scripts/self_learning.py record-success`；累计 5 次成功使批量复盘到期，但不自动修改 Skill。

交互模式在两次确认和参数选择节点停止。只有输入明确带有批准状态与完整参数时，才可无头执行。

## 运行中反馈闭环

- 真实使用失败：在重试前运行 `record-failure`，立即执行一次 `review` dry-run。记录原因与可复用证据，但单次偶然失败不得直接生成或应用补丁。
- 用户明确纠正：先修正当前任务，同时运行 `record-correction`，立即生成待门槛审查的候选改进；候选不得覆盖本轮已确认内容。
- 五次成功复盘：`successful_uses_since_review` 达到 5 时，在当前交付结束后检查失败、纠正和候选项；没有足够证据时只完成复盘或拒绝候选，不为凑周期修改文件。
- 应用学习：先运行 `self_learning.py backup` 备份全部目标文件并生成 manifest，再实施最小补丁；完成原有验证、相关示例或人工检查后，才运行 `record-applied`。验证失败则回滚并运行 `reject`。
- 每次复盘只处理本 Skill 职责内的原子规则。不得把状态记录、候选项或维护过程混入正常视频 Prompt、字幕或画面设计。

## 输入与标题

- 一句话：生成连贯口播文案与候选标题。
- 完整文案：默认保留原文，只做语义分组与时长估算。
- SRT：原时间轴优先，不归零、不删除空白、不自动增加标题时长。
- 非 SRT 默认增加独立 4 秒标题 Shot，`voiceover_text` 为空；标题原样保留。
- 用户明确要求“测试 Prompt”或“只做一个 Shot”时进入快速测试：不自动补整条视频或标题；仍先展示该 Shot 的画面设计，除非用户明确要求跳过确认。

需要整条叙事结构时，按需读取 [`references/beat-architectures.md`](references/beat-architectures.md)；需要指定配色时，按需读取 [`references/palettes.md`](references/palettes.md)。

## 参数选择

- 完整读取 [`references/variant-profile.md`](references/variant-profile.md)；其默认值只用于推荐，用户明确选择优先。
- 推荐 `Google Flow / Omni Flash`、`9:16`、标准 Vox；不得自行扩展固定模型清单。
- 根据目标模型当前实际能力提供比例与时长，不得猜测。Flow/Omni 未确认原生支持 `1:1` 时，只提供 `9:16` 或 `16:9`。
- 用户需要方形成片时，使用其确认的实际比例生成，把全部关键内容放入中央 `1:1` 安全区，并在 JSON 记录 `crop_target_ratio: "1:1"`。
- 同一视频默认统一比例和风格；只有用户明确要求才逐 Shot 混合风格。