auto-video

失败处理（核心规则）

sub-agent task 失败后，永远不要在主 session 自己接管本应由 sub-agent 做的工作。

正确做法：

1. 分析失败原因（task return 值 / 错误信息）
2. 如可修复：用修正后的参数重新派发同一 sub-agent
3. 如不可修复：将失败原因和已尝试方案返回给用户，停止流程

错误做法：

• ❌ "sub-agent 失败了，我自己来写这个 novel.md"
• ❌ "task 报错了，我在主 session 直接调用 Write"
• ❌ "我 fallback 一下，自己生成 keyframes.json"

原因：主 session 缺少 sub-agent 的隔离上下文（专属 system prompt、skill 加载、permission 配置），自己接管会导致质量下降、跨步骤上下文污染、permission 错配等问题。即使 sub-agent 失败，工作所有权也必须留在 sub-agent 层。

使用示例

/auto-video ep01              # 监控 ep01，默认每 20 分钟检查
/auto-video ep01 300          # 监控 ep01，每 5 分钟检查
/auto-video all               # 监控所有集，默认每 20 分钟检查

约束

• 严禁自行编写脚本（包括 Python、Node.js、内联 bash 脚本等）。只能调用插件内 scripts/ 目录下的现有脚本。
• tasks.json 的读取和写入由你（LLM）直接完成：用 Read 工具读取，用 Write 工具写入。不要用脚本操作 tasks.json。
• 调用插件脚本时，如果相对路径 scripts/xxx.sh 找不到，使用 Glob 工具搜索 **/scripts/xxx.sh 找到插件目录下的脚本绝对路径。

流程

阶段 1: 解析参数

1. 从 $ARGUMENTS[0] 获取目标（集数如 ep01，或 all），默认 all
2. 从 $ARGUMENTS[1] 获取检查间隔秒数，默认 1200（20 分钟）
3. 将秒数转换为分钟数（向上取整），用于 cron 表达式

阶段 2: 检查前置条件

1. 确认目标 tasks.json 存在（若为 all，至少有一个 story/episodes/*/videos/tasks.json）
2. 若不存在 → 提示"未找到视频生成任务，请先使用 /generate-video 提交任务"，结束

阶段 3: 检查是否已有同目标定时任务

1. 使用 CronList 列出所有定时任务
2. 检查是否已有 prompt 中包含 check-video 和 {目标} 的任务
3. 若已存在 → 输出"已有针对 {目标} 的自动监控任务在运行，无需重复创建"，结束
4. 若不存在 → 继续

阶段 4: 先执行一次检查（通过 sub-agent 隔离上下文）

为避免重活积压到主会话上下文，首次检查也用 Agent 工具起一个 general-purpose sub-agent 执行。sub-agent 的唯一职责是调用 check-video skill 并返回输出，主会话只处理返回的 JSON 摘要。

1. 使用 Agent 工具发起调用：

   • subagent_type: general-purpose
   • description: check-video run for {目标}
   • prompt（就两行）：

     调用 Skill("short-video-director:check-video", "{目标} --auto")，完整返回 skill 的输出。
     不要自行调用 dreamina CLI 或视频生成脚本，不要绕过 skill 做查询/重试。
     

2. 从 Agent 返回文本中提取 JSON 摘要：

   • 优先找结构化 JSON（通常在末尾，但不固定为最后一非空行——用 LLM 语义理解定位）
   • 解析 JSON 成功 → 进入下一步按字段决策
   • 解析失败 / 文本中找不到 JSON → 基于整段返回文本的语义推断 all_complete、recoverable 两个值（不确定时偏向 all_complete=false、recoverable=true）

3. 按 JSON（或推断结果）决定流程：

   • all_complete == true → 输出最终摘要（done/submitted/failed 数量 + human_needed 详情）+ 提示"可用 /check-video {目标} 手动处理 human_needed"，跳过阶段 5（不建 cron），整个 skill 结束
   • 含 error 字段且 recoverable == false → 报错输出 error 内容 + 建议用户检查目标配置（集数是否正确、tasks.json 是否存在），跳过阶段 5（不建 cron）
   • 其他情况（含 recoverable=true 或无异常） → 输出简短进度 "完成 X / 排队 Y / 失败 Z"，继续进入阶段 5 建 cron

阶段 5: 创建定时任务

1. 使用 CronCreate 创建定时任务：
   • cron: */{分钟数} * * * *（如 20 分钟 → */20 * * * *）
   • recurring: true
   • prompt: 见下方

Cron prompt 内容：

自动视频检查任务触发。目标：{目标}。

1. 使用 Agent 工具发起一个 general-purpose sub-agent，prompt 为：
   "调用 Skill('short-video-director:check-video', '{目标} --auto')，完整返回 skill 的输出。不要自行调用 dreamina CLI 或视频生成脚本，不要绕过 skill 做查询/重试。"

2. 从 Agent 返回文本中提取 JSON 摘要（LLM 理解，不固定最后一行规则）。解析失败或无 JSON 时，基于整段返回文本语义推断 all_complete 与 recoverable（不确定偏向 all_complete=false / recoverable=true）。

3. 按 JSON（或推断结果）决定：
   - all_complete == true → 使用 CronList 找到本定时任务 → 使用 CronDelete 删除自己；输出摘要 + human_needed 详情 + "可用 /check-video {目标} 手动处理"提示
   - 含 error 字段且 recoverable == false → 使用 CronList 找到本定时任务 → 使用 CronDelete 删除自己（防止反复空转浪费资源）；输出 error 描述给用户
   - 其他情况（recoverable=true 或无异常，且未全完成） → 输出一行简短进度（完成 X / 排队 Y / 失败 Z），等待下次触发

严禁：
- 不要以任何理由（包括测试、验证、调试）自行调用 dreamina CLI 提交视频/图片生成任务。视频生成成本很高，只有 check-video skill 内的重试流程才允许提交
- 不要绕过 Agent → Skill(check-video) 路径直接执行查询/重试/生成
- 不要在主会话（cron 触发会话）里直接调 check-video skill——必须通过 Agent 隔离上下文

2. 记录返回的 cron job ID
3. 输出：已创建定时任务，每 {N} 分钟检查一次视频生成状态。全部完成后自动停止。注意：定时任务在 Claude 会话内运行，关闭会话后任务将停止，最长运行 7 天。