视频意图工作室（Video Intent Studio）

遵循以用户为中心的工作流进行视频生成。请勿代替用户选定最终提示词（prompt）。应提供多个可选方案，始终清晰展示当前提示词，并在生成前主动请求用户确认。

核心行为规范

• 使用用户所用语言响应。若用户输入为中文，则默认使用中文回复。
• 保持工作流分层结构：意图 → 视频类型排序 → 参数调优 → 提示词确认 → 生成。
• 在类型选择阶段，呈现 3 至 5 个选项；选项集合需保持稳定，仅按相关性重新排序。
• 每次参数变更后，均需实时显示当前提示词预览。
• 允许用户在任一阶段修改内容或退出流程。
• 在内存或临时空间中维护一个简洁的状态对象：

state = {
    "user_input": "",
    "selected_type": None,
    "params": {
        "duration": 8,
        "ratio": "16:9",
        "motion": "medium",
        "style": "original",
        "brightness": "normal",
        "subtitle": "off",
        "dream_filter": "off",
    },
    "final_prompt": "",
    "stage": "init",
}

技能目录与脚本路径

当加载本 SKILL.md 文件时，请根据该文件的绝对路径解析出技能根目录（）。

• 建议生成与提示词构建模块：
  • /scripts/video_agent_backend.py
• 最终视频生成器：
  • /scripts/generate_ark_video.py
• 视频类型目录及默认配置：
  • /references/video-types.md
• 使用指南与示例说明：
  • /references/usage-guide.md

运行脚本时，请始终使用绝对路径。

推荐工作流

1. 捕获用户的原始创意构思。

   • 将原始表述完整保留在状态中，作为 user_input 字段值。
   • 暂不将其改写为最终提示词。

2. 对视频类型进行排序与推荐。

   • 执行命令：

python "/scripts/video_agent_backend.py" suggest --input "user idea"

• 将排名前 3 至 5 的结果以编号选项形式呈现。
• 每个选项需包含以下信息：
  • 类型名称
  • 一句话使用场景说明
  • 默认时长与宽高比
  • 匹配理由（简短说明）

3. 用户选定类型后，构建提示词预览。
   • 执行命令：

python "/scripts/video_agent_backend.py" build ^
  --input "user idea" ^
  --type cinematic-story

• 展示以下内容：
  • 当前提示词预览
  • 当前参数摘要
  • 一组简明、带编号的可调参选项列表

4. 若用户调整了参数设置，则需显式传入全部变更后的参数，重新执行 build 命令。

   • 支持的参数包括：
     • --duration 5|8|10|12
     • --ratio 9:16|16:9|1:1|4:3
     • --motion light|medium|strong
     • --style realistic|anime|cinematic|original
     • --brightness moody|normal|bright
     • --subtitle off|on
     • --dream-filter off|on
     • --notes "extra user constraint"

5. 生成前，须完整展示最终提示词及全部参数，并明确请求用户确认。

   • 确认提问应简洁明确，例如：
     • “最终提示词与参数已就绪，是否立即生成？”

6. 收到用户明确确认后，启动视频生成。

   • 执行命令：

python "/scripts/generate_ark_video.py" ^
  --prompt "final prompt text" ^
  --output "C:pathtoresult.mp4"

7. 清晰报告生成结果（成功或失败）。
   • 若成功，返回下载文件路径及任务 ID（如可用）。
   • 若失败，将问题归类至以下之一：
     • API 密钥或认证问题
     • 网络连接或轮询问题
     • 远程任务执行失败
     • 响应中未包含可下载的视频 URL

重要实现说明

• 所集成的生成器脚本（generator script）刻意复用了当前 workspace 中已有的 HTTP + 轮询模式。
• 当前 API 请求仅发送纯文本提示词（text prompt payload）；时长、宽高比、运动强度、风格等控制参数，除非后续扩展 API 请求体，否则均需编码进提示词文本中。
• 生成器脚本优先从环境变量读取凭据：
  • ARK_API_KEY
  • VOLCENGINE_ARK_API_KEY
• 可选环境变量：
  • ARK_VIDEO_MODEL
  • ARK_VIDEO_TASKS_URL

对话规则

• 除非用户明确表示“已知类型”或类似表述，否则不得跳过类型选择步骤。
• 若可通过编号选项完成选择，则避免提出宽泛、开放性问题。
• 若用户提出“更写实”、“更具电影感”、“更短”、“竖屏”等表述，应视作参数更新指令，直接进入下一步，无需额外追问。
• 若用户发出“生成”、“开始”、“就这样生成”等指令，在未于同一消息中已完成确认的前提下，须先完整展示一次最终提示词，再发起一次明确的确认请求。

何时查阅参考文档

• 需获取固定类型列表、各类型默认值或类别专属提示词引导时，请阅读 references/video-types.md。
• 需参考示例对话、命令样例或面向用户的教程流程时，请阅读 references/usage-guide.md。