generate-assets
GitHub统一生成角色、场景、道具、商品四类资产图,通过MCP工具管理待生成资源并执行图像合成,支持批量生成与局部编辑审核。
触发场景
安装
npx skills add ArcReel/ArcReel --skill generate-assets -g -y
SKILL.md
Frontmatter
{
"name": "generate-assets",
"description": "统一资产生成 skill:接受 `--type=character|scene|prop|product`,或不传自动扫所有 pending(缺 sheet)资源并按类型分发。当用户说“生成角色图”\/“生成场景图”\/“生成道具图”\/“生成商品图”、想为新资产创建参考图、或有资产缺少 *_sheet 时使用。"
}
生成资产图
为项目的角色、场景、道具、商品创建资产图,保证整个视频中视觉元素的一致性。 图像供应商由项目设置选择(不锁定具体 backend)。
Prompt 编写原则详见
.claude/references/generation-modes.md的"Prompt 语言"章节。
共同约定
- 所有资产
description用叙事式段落,而不是关键词列表。 - 用户只需在 project.json 中维护
description;最终交给图像 backend 的完整 prompt (含布局 / 防崩短语 / 反向提示词)由lib/prompt_builders.py在 server 端拼好, WebUI 与 Skill 走同一份真相源。 - Pending 判定:Artifact Manifest 中该资产图状态为
missing;stale产物复用,不计入待生成。
角色(character)
description 编写指南
用连贯段落描述外貌、服装、气质,包含年龄、体态、面部特征、服饰细节。
示例:
"二十出头的女子,身材纤细,鹅蛋脸上有一双清澈的杏眼,柳叶眉微蹙时带着几分忧郁。身着淡青色绣花罗裙,腰间系着同色丝带,显得端庄而不失灵动。"
输出布局
横版 16:9 三视图,纯白背景:正面 / 正侧(90° 侧视图)/ 背面水平排列。 三个面板中角色面部、发型、服装、配饰需保持完全一致。
用户填写 description 时只需关心外貌 / 服装等内容;布局由 builder 注入。
场景(scene)
description 编写指南
用连贯段落描述形态、光线、氛围,突出能跨场景识别的独特特征。
示例:
"村口的百年老槐树,树干粗壮需三人合抱,树皮龟裂沧桑。主干上有一道明显的雷击焦痕,从顶部蜿蜒而下。树冠茂密,夏日里洒下斑驳的树影。"
输出布局
横版 16:9 单张环境全景建立镜头。
道具(prop)
description 编写指南
用连贯段落描述形态、质感、细节,突出能跨场景识别的独特特征。
示例:
"一块翠绿色的祖传玉佩,约拇指大小,玉质温润透亮。表面雕刻着精致的莲花纹样,花瓣层层舒展。玉佩上系着一根红色丝绳,打着传统的中国结。"
输出布局
横版 16:9 单张道具资产图,纯净浅灰背景。
商品(product)
description 编写指南
用连贯段落描述商品外观、品牌文字、配色、材质、比例与结构。
输出布局
横版 16:9 单张商品资产图,纯净浅灰背景、均匀棚拍布光。
工具调用
入队走 MCP 工具:
| 操作 | 工具 |
|---|---|
| 列出所有/某类 pending | mcp__arcreel__list_pending_assets({"type": "character"})(type 可省略) |
| 生成所有 pending(四类各一轮) | mcp__arcreel__generate_assets({}) |
| 生成某类全部 pending | mcp__arcreel__generate_assets({"type": "character"}) |
| 生成指定多个 | mcp__arcreel__generate_assets({"type": "prop", "names": ["玉佩", "密信"]}) |
| 生成单个 | mcp__arcreel__generate_assets({"type": "scene", "names": ["村口老槐树"]}) |
| 生成单个商品 | mcp__arcreel__generate_assets({"type": "product", "names": ["保温杯"]}) |
结果按 requested / succeeded / failed / blocked / skipped 逐 ID 返回,ID 形如 character/张三;
已失效但可复用的旧图进入 skipped,不会自动重生;
按每一项自带的 problem.code 与 problem.action 决定下一步,不要解析文本。
结构详见 .claude/references/generation-results.md。
工作流程
- 加载项目元数据 — 从 Artifact Manifest 找出资产图状态为
missing的资产 - 入队生成任务 — description 直接作为 prompt 提交;server 端
lib.prompt_builders注入布局 / 防崩 / 反向 - 审核检查点 — 展示每张资产图,用户可批准、要求重新生成,或要求编辑
- 更新 project.json — 更新
character_sheet/scene_sheet/prop_sheet/product_sheet路径
审核检查点:编辑 vs 重新生成
用户对资产图提意见时先判断诉求类型,选错路径会推翻已满意的部分或丢掉预期外的改动:
- 只想改局部(换发色、去掉杂物、调整光线氛围等),且构图和整体设计满意 → 用
mcp__arcreel__edit_images({"resource_type": "character", "edits": [{"id": "张三", "instruction": "把头发改成红色"}]})保底图微调,一次可对同类型多个资产批量下发 - 想推翻构图/整体设计重来,或本来就要改 description(进而改变后续按 description
重新生成的结果)→ 用
generate_assets按更新后的 description 重新生成整图 - 编辑不会更新
description/ prompt——编辑后再触发generate_assets仍按原 description 重画,编辑效果只能从版本历史找回
质量检查
- 角色:三个面板(正面 / 正侧 / 背面)的面部、发型、服装、配饰完全一致
- 场景:整体构图和标志性特征突出、光线氛围合适
- 道具:主体清晰、细节符合描述、特殊纹理清晰可见
- 商品:参考图中的品牌、文字、配色、材质、比例与结构保持一致,不保留手部、模特及其他出镜人物
版本历史
-
44d22bf
当前 2026-08-28 10:40
新增商品(product)资产类型支持;调整角色版式为三视图横排,场景/道具/商品改为单张输出;同步相关提示词与文档。
- feafcb4 2026-08-20 00:25


