# Generate Grid

> 生成宫格分镜图。当用户说"生成宫格"、"宫格生图"、"用宫格装配生成分镜"时使用。自动按 segment_break 分组，选择最优宫格大小，生成链式过渡帧宫格联合图，随后切分落格为各分镜的起始分镜图。

- Skill: `arcreel/generate-grid` (Agent Skill)
- Install (CLI): `npx skillmds@latest add arcreel/generate-grid`
- Raw SKILL.md: https://api.skillmd.com/api/skills/arcreel/generate-grid/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: arcreel (https://skillmd.com/u/arcreel)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/arcreel/generate-grid

---


# 生成宫格分镜图

为开启宫格装配的项目生成宫格分镜图。自动按 segment_break 分组，每组生成一张宫格联合图（分镜数超过单张宫格格数上限的分组会切为多张，末张不足一档时落到更小档并补占位格）。宫格生命周期分两段：生成任务只产出联合图并记版本；切分落格是独立操作、唯一覆写分镜格的步骤。`generate_grid` 工具在每张联合图生成完成后自动执行切分，端到端仍产出各分镜的起始分镜图（仍走 i2v，与逐张生成的分镜图输入契约相同）。若某张切分失败，联合图已生成成功，引导用户在 Web 宫格面板重试切分即可，不要重新生成（避免重复计费）。

## 前置条件

- 项目 `generation_mode` 为 `"storyboard"` 且 `grid_storyboard` 为 `true`（宫格装配由用户在 Web 设置页开关，项目创建后不可经 Agent 改）
- 剧本已生成（scripts/episode_N.json 存在）
- 角色/场景/道具资产图（已生成的会作为参考图带入；一张都没有时退化为纯文生图，画面一致性会明显变差）

## 工具调用

| 操作 | 工具 |
|------|------|
| 整集生成 | `mcp__arcreel__generate_grid({"script": "episode_1.json"})` |
| 指定分镜所在的组 | `mcp__arcreel__generate_grid({"script": "episode_1.json", "scene_ids": ["E1S01", "E1S02", "E1S03"]})` |
| 列出当前分组信息 | `mcp__arcreel__generate_grid({"script": "episode_1.json", "list_only": true})` |

不传 `scene_ids` 时只补缺：分镜格已齐备的分组会被复用，不重新生成。
结果按 `requested / succeeded / failed / blocked` 逐**分镜** ID 返回：同组分镜共享一张宫格，
这张宫格的入队、任务与切分结果投影到它覆盖的每个分镜。联合图已生成但切分失败的分镜
带 `generation_post_processing_failed`，此时不要重新生成整张宫格（会重复计费）。
结构详见 `.claude/references/generation-results.md`。

## 输出

- 宫格联合图保存到 `grids/{grid_id}.png`（`grid_id` 自身即带 `grid_` 前缀，如 `grids/grid_a1b2c3d4e5f6.png`），每次生成/上传记为一个 grids 版本
- 帧链元数据保存到 `grids/{grid_id}.json`（`split_at` 记录最近一次按当前联合图切分落格的时间）
- 切分后的单元格按 `next_scene_id` 分配落盘，文件名与普通分镜图对齐为 `storyboards/scene_{id}.png`（无 first/last 后缀），每格覆写前后均入版本史