Manga Workflow

现有项目

1. 列出 projects/ 中的项目
2. 显示项目状态摘要
3. 从上次未完成的阶段继续

状态检测

进入工作流后，使用 Read 读取 project.json，使用 Glob 检查文件系统。按顺序检查，遇到第一个缺失项即确定当前阶段：

1. characters / scenes / props 中任一为空（定义缺失）？ → 阶段 1
2. 目标集 source/episode_{N}.txt 不存在？ → 阶段 2
3. 目标集 drafts/ 中间文件不存在？ → 阶段 3
   • narration: drafts/episode_{N}/step1_segments.md
   • drama: drafts/episode_{N}/step1_normalized_script.md
4. scripts/episode_{N}.json 不存在？ → 阶段 4
5. 任一类资产仍有缺 sheet 项（character 缺 character_sheet / scene 缺 scene_sheet / prop 缺 prop_sheet）？ → 阶段 5（三类并行）
6. 有场景缺少分镜图？ → 阶段 6
7. 有场景缺少视频？ → 阶段 7
8. 全部完成 → 工作流结束，引导用户在 Web 端导出剪映草稿

确定目标集数：如果用户未指定，找到最新的未完成集，或询问用户。

阶段间确认协议

每个 subagent 返回后，主 agent 执行：

1. 展示摘要：将 subagent 返回的摘要展示给用户
2. 获取确认：使用 AskUserQuestion 提供选项：
   • 继续下一阶段（推荐）
   • 重做此阶段（附加修改要求后重新 dispatch）
   • 跳过此阶段
3. 根据用户选择行动

阶段 1：全局角色/场景/道具提取

触发：project.json 中 characters / scenes / props 中任一为空（定义缺失）

dispatch analyze-assets subagent：

项目名称：{project_name}
项目路径：projects/{project_name}/
分析范围：{整部小说 / 用户指定的范围}
已有角色：{已有角色名列表，或"无"}
已有场景：{已有场景名列表，或"无"}
已有道具：{已有道具名列表，或"无"}

请分析小说原文，提取角色 / 场景 / 道具信息，写入 project.json，返回摘要。

阶段 2：分集规划

触发：目标集的 source/episode_{N}.txt 不存在

每次只切分当前需要制作的那一集。主 agent 直接执行（不 dispatch subagent）：

1. 确定源文件：source/_remaining.txt 存在则使用，否则用原始小说文件
2. 询问用户目标字数（如 1000 字/集）
3. 调用 peek_split_point.py 展示切分点附近上下文：

   python .claude/skills/manage-project/scripts/peek_split_point.py --source {源文件} --target {目标字数}
   

4. 分析 nearby_breakpoints，建议自然断点
5. 用户确认后，先 dry run 验证：

   python .claude/skills/manage-project/scripts/split_episode.py --source {源文件} --episode {N} --target {目标字数} --anchor "{锚点文本}" --dry-run
   

6. 确认无误后实际执行（去掉 --dry-run）

阶段 3：单集预处理

触发：目标集的 drafts/ 中间文件不存在

根据 content_mode 选择 subagent：

• narration → dispatch split-narration-segments
• drama → dispatch normalize-drama-script

dispatch prompt 包含：项目名称、项目路径、集数、本集小说文件路径、角色/场景/道具名称列表。

阶段 4：JSON 剧本生成

触发：scripts/episode_{N}.json 不存在

dispatch create-episode-script subagent：传入项目名称、项目路径、集数。

阶段 5：资产设计（character / scene / prop 三类并行）

前置条件：三类资产的定义（characters / scenes / props）均已通过阶段 1 写入 project.json。若任一类定义为空（数组缺失），应回到阶段 1 补提取，而非停留在阶段 5。

触发：三类资产中任一类存在缺 sheet 项：

• character 缺 character_sheet
• scene 缺 scene_sheet
• prop 缺 prop_sheet

调度规则（显式条件判断，按类型独立决定）：

对于 type ∈ {character, scene, prop}:
  若该类存在缺 *_sheet 项 → dispatch 对应的 `generate-assets` subagent
  若该类均已齐全         → 跳过，不 dispatch

三类判断彼此独立，结果可能 dispatch 0~3 个 subagent。
所有 dispatch 的 subagent 返回后，合并摘要展示给用户，进入阶段间确认。

下面三个 dispatch 块是模板，只实例化满足上述条件的那几个：

subagent — 角色设计

触发：有角色缺少 character_sheet

dispatch `generate-assets` subagent：
  任务类型：character
  项目名称：{project_name}
  项目路径：projects/{project_name}/
  待生成项：{缺失角色名列表}
  脚本命令：
    python .claude/skills/generate-assets/scripts/generate_asset.py --type character --all
  验证方式：重新读取 project.json，检查对应角色的 character_sheet 字段

subagent — 场景设计

触发：有场景缺少 scene_sheet

dispatch `generate-assets` subagent：
  任务类型：scene
  项目名称：{project_name}
  项目路径：projects/{project_name}/
  待生成项：{缺失场景名列表}
  脚本命令：
    python .claude/skills/generate-assets/scripts/generate_asset.py --type scene --all
  验证方式：重新读取 project.json，检查对应场景的 scene_sheet 字段

subagent — 道具设计

触发：有道具缺少 prop_sheet

dispatch `generate-assets` subagent：
  任务类型：prop
  项目名称：{project_name}
  项目路径：projects/{project_name}/
  待生成项：{缺失道具名列表}
  脚本命令：
    python .claude/skills/generate-assets/scripts/generate_asset.py --type prop --all
  验证方式：重新读取 project.json，检查对应道具的 prop_sheet 字段

阶段 6：分镜图生成

触发：有场景缺少分镜图

检查 project.json 的 generation_mode：

• "single" 或未设置 → dispatch generate-storyboard subagent（现有逻辑）
• "grid" → dispatch generate-grid subagent（新增）
  • generate-grid 自动按 segment_break 分组
  • 每组 ≥ 4 场景 → 生成宫格图
  • 每组 < 4 场景 → 退化为逐张生成

single 模式（默认）

dispatch generate-assets subagent：

dispatch `generate-assets` subagent：
  任务类型：storyboard
  项目名称：{project_name}
  项目路径：projects/{project_name}/
  脚本命令：
    python .claude/skills/generate-storyboard/scripts/generate_storyboard.py episode_{N}.json
  验证方式：重新读取 scripts/episode_{N}.json，检查各场景的 storyboard_image 字段

grid 模式

dispatch generate-assets subagent：

dispatch `generate-assets` subagent：
  任务类型：storyboard
  项目名称：{project_name}
  项目路径：projects/{project_name}/
  脚本命令：
    python .claude/skills/generate-grid/scripts/generate_grid.py episode_{N}.json
  验证方式：重新读取 scripts/episode_{N}.json，检查各场景的 storyboard_image 字段

阶段 7：视频生成

触发：有场景缺少视频

dispatch generate-assets subagent：

dispatch `generate-assets` subagent：
  任务类型：video
  项目名称：{project_name}
  项目路径：projects/{project_name}/
  脚本命令：
    python .claude/skills/generate-video/scripts/generate_video.py episode_{N}.json
  验证方式：重新读取 scripts/episode_{N}.json，检查各场景的 video_clip 字段

灵活入口

工作流不强制从头开始。根据状态检测结果，自动从正确的阶段开始：

• "分析小说角色" → 只执行阶段 1
• "创建第2集剧本" → 从阶段 2 开始（如果角色已有）
• "继续" → 状态检测找到第一个缺失项
• 指定具体阶段（如"生成分镜图"）→ 直接跳到该阶段

数据分层

• 角色 / 场景 / 道具完整定义只存 project.json，剧本中仅引用名称
• 统计字段（scenes_count、status、progress）读时计算，不存储
• 剧集元数据在剧本保存时写时同步