---
name: video-workflow
description: 当用户要求创建视频、新建或继续项目、推进下一步、检查进度、完成或导出时，编排 ArcReel 视频项目。用于端到端工作流请求，不用于仅编辑某个现有产物。
---

# ArcReel 视频工作流

以已连接的 ArcReel MCP 服务作为项目状态的唯一来源。每次项目级工具调用都必须显式指定项目，不依赖本地项目文件或 Agent 宿主的工作目录。

## 按计划路由

1. 使用 ArcReel 项目工具确定项目。尚无项目时，先收集创建所需信息并创建项目。
2. 为该项目调用 `get_workflow_plan`。仅在用户已选定分集时传入 `episode_id`：项目详情 `episodes[]` 的排列即播出顺序，按用户说的第几集或标题找到那一集，传它的 `episode` 字段（集 ID，不是第几集）。对用户称呼一集用播出位置与标题。保留计划返回或要求的、仍然有效的临时选择。
3. 用户只要求检查进度或了解下一步时，报告计划中的内容现状（`status.content`）、问题和 `next_action`，不修改项目。
4. 用户要求推进时，依据 `workflow_plan.next_action` 路由并执行该动作；`next_alternatives` 非空表示分岔，列出并列选项由用户选定。按需向对应的 ArcReel 工具传入 project、`next_action.args`、target 字段和非空 `requested_ids`。
5. 用户点名一个操作时，看 `status.operations` 中该操作的准入：`admitted` 就执行，不必等它成为下一步；`refused` 时把 `reason` 转述给用户并说明怎样补上。工具入口以同一判定拒绝时返回 `operation_not_admitted`，其 `params.reason` 与计划一致。`operations` 只陈述列出的操作；生成类入口沿用各入口的准入判定（ADR 0073），被拒时转述入口返回的理由。
6. 动作需要用户选择或确认时，说明影响并等待明确同意。`blockers` 非空时展示阻断原因并停止修改项目。`next_action.type` 为 `create_edit_timeline` 时，调用 `create_timeline`（`episode` 取 `next_action.args.episode_id`，`from` 传 `script`）为该集新建剪辑时间线；为 `none` 且计划 `steps` 中 `edit` 为 `completed` 时，说明工作流已走完；其余 `none` 而没有阻断的情况，报告 `status.issues`。
7. 生成动作返回 `generation_batch` 时，保留 `batch_id`，并按每次返回的 `poll_after_seconds` 调用 `get_generation_batch`，直到结果为 `done: true`。之后再调用 `get_workflow_plan`，按新的 `next_action` 路由。计划因已有任务返回 `wait_for_task` 时，等待其 `poll_after_seconds` 后再次调用 `get_workflow_plan`，最多执行 `max_poll_attempts` 次；达到上限后相同任务仍在运行，则报告其 `task_ids` 并停止。其他动作完成后直接刷新计划。

仅在主题适用时读取对应参考：

- 遇到阻断、临时选择、计费动作或过期产物时，读取[计划安全与确认](references/plan-safety.md)。
- 解释不同模式的结构或引用时，读取[内容与生成模式](references/generation-modes.md)。
- 选择 ID，或报告批次结果、任务、供应商提交和产物状态时，读取[生成结果](references/generation-results.md)。