Agent Skills
› ArcReel/ArcReel
› generate-grid
generate-grid
GitHub为宫格分镜项目生成联合图并自动切分落格。支持按剧本或指定场景分组，处理超时与失败重试，复用已有资产以减少重复计费，输出标准化分镜文件及元数据。
Trigger Scenarios
生成宫格
宫格生图
宫格模式生成分镜
Install
npx skills add ArcReel/ArcReel --skill generate-grid -g -y
SKILL.md
Frontmatter
{
"name": "generate-grid",
"description": "生成宫格分镜图。当用户说\"生成宫格\"、\"宫格生图\"、\"宫格模式生成分镜\"时使用。自动按 segment_break 分组，选择最优宫格大小，生成链式过渡帧宫格联合图，随后切分落格为各场景起始分镜图。"
}
生成宫格分镜图
为开启宫格装配的项目生成宫格分镜图。自动按 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 后缀），每格覆写前后均入版本史
Version History
-
feafcb4
Current 2026-08-20 00:25
优化结果报告粒度至逐场景ID，区分成功/失败/受阻状态；修复空ID集合误判为全量重做的Bug；统一工具术语与产品命名规范。
- 24a1f5c 2026-07-25 06:26
