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 找到插件目录下的脚本绝对路径。

前置条件（OC 专属）

本 skill 通过 OC server HTTP API 实现定时调度，必须在带 --port 启动的 OC session 内运行：

opencode --port 4096 -s YOUR_SESSION_ID

如果 OC 启动时没有 --port，skill 会在阶段 2 报错并退出，提示重启命令。

流程

阶段 1: 解析参数

1. 从 $ARGUMENTS[0] 获取目标（集数如 ep01，或 all），默认 all
2. 从 $ARGUMENTS[1] 获取检查间隔秒数，默认 1200（20 分钟）
3. 校验 INTERVAL：必须为 ≥60 的正整数。否则报错退出：

   ERROR: INTERVAL 必须是正整数秒数且 ≥60（防 API 打爆），收到：{值}
   

阶段 2: 检查前置条件 + OC server 发现

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

   if [ -z "$OPENCODE_PID" ]; then
     echo "ERROR: OPENCODE_PID 未设置" >&2
     exit 1
   fi
   PORT=""
   if command -v ss >/dev/null; then
     PORT=$(ss -tlnp 2>/dev/null \
       | awk -v pid="$OPENCODE_PID" \
           '$0 ~ "pid="pid {split($4,a,":"); print a[length(a)]; exit}')
   fi
   if [ -z "$PORT" ] && command -v lsof >/dev/null; then
     PORT=$(lsof -iTCP -sTCP:LISTEN -P -n -p "$OPENCODE_PID" 2>/dev/null \
       | awk 'NR==2 {split($9,a,":"); print a[length(a)]; exit}')
   fi
   if [ -z "$PORT" ]; then
     echo "ERROR: 当前 OC 进程未监听任何 TCP 端口" >&2
     echo "请退出 OC 并用 'opencode --port 4096 -s $OPENCODE_SESSION_ID' 重启" >&2
     exit 1
   fi
   if ! curl -s --max-time 2 "http://127.0.0.1:$PORT/global/health" \
          | grep -q healthy; then
     echo "ERROR: OC server (port $PORT) 不响应" >&2
     exit 1
   fi
   

阶段 3: 检查是否已有同目标 loop

1. 检查 PID 文件 /tmp/svd-auto-video-loop-{目标}-{SID}.pid：
   • 存在且 kill -0 $(cat PID_FILE) 2>/dev/null 成功 → 输出"已有针对 {目标} 的自动监控任务在运行 (PID: X)，无需重复创建"，结束
   • 存在但 PID 已死 → 清理 pid file + 关联的 prompt/log 文件，继续
   • 不存在 → 继续

阶段 4: 先执行一次检查（task tool sub-agent）

为避免重活积压到主会话上下文，首次检查也用 task tool 起一个 general sub-agent 执行。

1. 使用 task tool 发起调用：

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

     使用 Skill tool 调用 check-video skill，传递参数：{目标} --auto。
     完整返回 skill 的输出。不要自行调用 dreamina CLI 或视频生成脚本，不要绕过 skill 做查询/重试。
     

2. 从 sub-agent 返回文本中提取 JSON 摘要：

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

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

   • all_complete == true → 输出最终摘要 + 提示"可用 /check-video {目标} 手动处理"，跳过阶段 5（不装 loop），整个 skill 结束
   • 含 error 且 recoverable == false → 报错输出 error 内容 + 建议用户检查配置，跳过阶段 5（不装 loop）
   • 其他情况 → 输出简短进度 "完成 X / 排队 Y / 失败 Z"，继续进入阶段 5

阶段 5: 装 nohup loop

1. 准备文件路径：

   TARGET={目标}
   SID=$OPENCODE_SESSION_ID
   PID_FILE=/tmp/svd-auto-video-loop-${TARGET}-${SID}.pid
   PROMPT_FILE=/tmp/svd-cron-prompt-${TARGET}-${SID}.txt
   LOG_FILE=/tmp/svd-auto-video-loop-${TARGET}-${SID}.log
   

2. 从模板生成 cron prompt 写入 PROMPT_FILE（用 bash 内置变量替换，不用 sed）：

   TEMPLATE=$(cat "$SVD_PLUGIN_DIR/.opencode/skill-overrides/auto-video/cron-prompt.txt")
   PROMPT="${TEMPLATE//\{\{TARGET\}\}/$TARGET}"
   PROMPT="${PROMPT//\{\{SID\}\}/$SID}"
   printf '%s' "$PROMPT" > "$PROMPT_FILE"
   

3. 启动 nohup loop（loop.sh 通过环境变量接收所有参数）：

   PORT="$PORT" SID="$SID" INTERVAL="$INTERVAL" \
   PID_FILE="$PID_FILE" PROMPT_FILE="$PROMPT_FILE" LOG_FILE="$LOG_FILE" \
   nohup bash "$SVD_PLUGIN_DIR/.opencode/skill-overrides/auto-video/loop.sh" \
     > "$LOG_FILE" 2>&1 &
   echo $! > "$PID_FILE"
   

4. 告知 user：

   ✓ 自动监控 loop 已启动
     - 目标: {目标}
     - 间隔: {分钟数} 分钟
     - PID:  {PID 值}
     - log:  /tmp/svd-auto-video-loop-{目标}-{SID}.log
   
   Loop 会自动 health check OC server；OC 关闭后约 3×{分钟数} 分钟自杀清理。
   手动停止: kill $(cat /tmp/svd-auto-video-loop-{目标}-{SID}.pid)
   

删除任务

视频全部完成 / user 主动取消：

SID=$OPENCODE_SESSION_ID
TARGET={目标}
kill $(cat /tmp/svd-auto-video-loop-${TARGET}-${SID}.pid) 2>/dev/null
rm -f /tmp/svd-auto-video-loop-${TARGET}-${SID}.{pid,log}
rm -f /tmp/svd-cron-prompt-${TARGET}-${SID}.txt

Loop 内部的 cron prompt 会在 all_complete == true 时自动执行上面命令清理。