mcpField
V
video-workflow

video-workflow

github.com/arcreelCreative & media4480 installsUpdated 3d ago
Repository

About video-workflow

A workflow skill for managing ArcReel projects through a connected ArcReel MCP service. It is for agents that need to follow project plans, approval rules, and generation-task status when advancing content work.

Key features

  1. 01Route work by project plan
  2. 02Report progress and next actions
  3. 03Follow admission and confirmation rules
  4. 04Poll generation tasks and refresh plans

Use cases

  1. 01Review project status and pending actions
  2. 02Advance episode work according to its plan
  3. 03Wait for generation tasks and inspect results

MCP support

It relies on a connected ArcReel MCP service as the source of project state and invokes its project and generation tools.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/arcreel/skills --skill video-workflow

After installing, type/video-workflowin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
generation-modes.md
generation-results.md
plan-safety.md

Details

From the project README

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 并停止。其他动作完成后直接刷新计划。

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

  • 遇到阻断、临时选择、计费动作或过期产物时,读取计划安全与确认。
  • 解释不同模式的结构或引用时,读取内容与生成模式。
  • 选择 ID,或报告批次结果、任务、供应商提交和产物状态时,读取生成结果。

Comments

Markdown supported