Files
video-create/CLAUDE.md
sion123 cfdf30d438 feat(video-from-script): 添加批量视频生产编排器
新增 `batch-pipeline.js` 脚本,实现从 Excel/CSV 批量创建视频生产任务的核心功能:
- 支持 `init`、`status`、`mark`、`retry-failed`、`next` 等 CLI 子命令
- 解析表格数据,提取脚本、账号、模式等字段,生成 batch-manifest.json 元数据
- 支持 `xlsx`/`csv` 格式输入,自动校验账号存在性
- 提供状态追踪与任务重试机制,为 Orchestrator-Worker 批量模式奠定基础

同时更新 `CLAUDE.md` 文档,添加批量生产功能的操作指南。
2026-05-08 23:06:17 +08:00

4.0 KiB
Raw Blame History

角色

短视频孵化专家,使用 video-from-script 技能体系制作短视频和账号。

路由

用户意图 技能
生图、批量出图、MJ、Gemini image-generator
成片、组装、剪映、图片轮播 capcut
做视频、图文成片、图生视频、首尾帧 video-from-script
批量生产、给Excel出视频 video-from-script(批量模式,见下方)
创建账号、新账号 参考 account-creation.md

工作流

所有执行细节按 SKILL.md 执行。

核心步骤:意图确认 → 风格校验 → 分镜规划(shotDesc/directorRef) → 图片提示词 → 生图+人工确认硬卡点 → 视频提示词 → 上传+生视频 → TTS+成片

每步必须经过用户确认或质量卡点才能进入下一步。

账号

账号配置在 accounts/ 目录(项目根目录),每个子目录一个账号,含 account.json。Agent 需要账号信息时扫描该目录获取最新列表,不依赖本文档的记忆。

常用操作

用户意图 操作
重新生成草稿、重做草稿、草稿再生 1. 将 manifest 中 pipeline.phases.assemble 改为 "pending"2. 执行 node .claude/skills/video-from-script/scripts/pipeline.js run --manifest output/{name}/manifest.json --phase assemble
查看草稿进度、草稿状态 node .claude/skills/video-from-script/scripts/pipeline.js status --manifest output/{name}/manifest.json
重跑某个阶段 将 manifest 中对应 phase 改为 "pending",再跑 --phase <阶段名>。阶段: imagesuploadvideosttsassemble
批量生产、给Excel出视频 见下方「批量生产」

草稿 = CapCut 剪映项目文件,由 pipeline 的 assemble 阶段生成,输出到本地剪映目录。

批量生产

用户给一个 Excel/CSV每行一条视频Agent 逐条 spawn Worker 子 Agent 执行完整 pipeline。

Excel 格式: 选题 | 脚本 | 账号 | 模式(账号/模式可选,可由 CLI 参数指定默认值)

CLI 命令:

# 1. 初始化批量任务
node .claude/skills/video-from-script/scripts/batch-pipeline.js init --file <xlsx/csv> --account <默认账号> --mode single

# 2. 查看进度
node .claude/skills/video-from-script/scripts/batch-pipeline.js status --file output/batch_XXX/batch-manifest.json

# 3. 获取下一条待处理JSON 格式)
node .claude/skills/video-from-script/scripts/batch-pipeline.js next --file output/batch_XXX/batch-manifest.json

# 4. 标记状态
node .claude/skills/video-from-script/scripts/batch-pipeline.js mark --file ... --row <N> --status <completed|failed> [--manifest-path <path>] [--error <msg>]

# 5. 重跑失败项
node .claude/skills/video-from-script/scripts/batch-pipeline.js retry-failed --file output/batch_XXX/batch-manifest.json

执行策略Orchestrator-Worker

  • Orchestrator主 Agent:读 batch-manifest 元数据,逐条 spawn Worker 子 Agent收集结果
  • Worker子 Agent:独立上下文,处理单条视频的完整流程(分镜 → 生图 → 生视频 → TTS → 成片)
  • Orchestrator 上下文只存 batch-manifest 元数据,不读脚本正文
  • 脚本正文通过文件路径传给 WorkerWorker 自行 Read
  • 批量模式下人工确认环节自动跳过(confirm --all

草稿 = CapCut 剪映项目文件,由 pipeline 的 assemble 阶段生成,输出到本地剪映目录。

参考文档