scenario-brand-kit

场景品牌套件

概览

先确定品牌形象，再进行呈现。配色和字体是在任何运行开始前写入规范的选择；Logo 只生成一次，作为真实矢量图重复使用；每个应用都引用已获批准的标志，而不是重新设计。连接方式和核心循环：参见 scenario 技能。在尚未确定方向时寻找灵感：scenario-inspiration。图像运行和参考配置：scenario-image。应用中准确的标语和 CTA：scenario-text-overlay。各展示位置的尺寸：scenario-formats。门控约定：scenario-asset-analysis。如果你可用的技能中缺少此处提到的同类技能，请让用户安装（npx skills add scenario-labs/skills --skill <name>）；若无人值守，则根据工具架构继续操作，并标明此缺失。

快速参考

需求	路径
规格	由你和用户在生成前先行撰写：规格表中的内容
Logo，原生	recommend capability="txt2img"，提示词要求生成真正可编辑的 SVG，而非栅格图：起作用的是这条要求，而不是 capability；跳过排名第一的 style 成员（没有样式输入就会拒绝运行，见 Icon strip），通过 search 搜索同名项即可找到纯 SVG 的同类项
Logo，描摹	现有的栅格图标：recommend capability="img2img"，提示词要求描摹为可编辑的 SVG，不要重新生成
把关	使用 text_inputs 将图标与规格一起提交给 asset_analyze；如果字标有偏差，就重新运行，绝不打补丁
变体	使用 asset_get 获取图标，保存其 url（curl -L）以获取已存储的 SVG，在本地重新着色，并对每个变体调用 upload_asset
应用场景	使用 recommend 并指定 capability="img2img"，将已批准的图标用作参考，在提示词中写明规格中的十六进制颜色值，每次运行只生成一种摆放方式
图标条	矢量生成器的 style 成员（search，filters={"tags": ["style-consistency", "svg"]}；其纯 SVG 成员不暴露 image 字段）：将图标的栅格渲染图（使用 asset_download 并指定 format png，可获取已存储 SVG 的栅格图）作为第一个图标的 styleReferenceImages，然后将该任务的 style_id（job_get，verbose=true，输出元数据）作为其余图标的 styleId，绝不要同时使用两者
展示板	model_scenario-compose-image（第一方合成器，id 固定）：将图标、色板、样张和应用场景作为定位图层，并通过 scenario-text-overlay 添加标签
整理套件	在首次运行前调用 collection_create；每个保留项生成后立即调用 collection_add_assets；对每个保留项调用 asset_update 设置其角色和规则

规格表

一份简短文档为每次运行和每道关卡提供依据：四到六个十六进制色值，各自标明用途（主色、文字色、纸张色、强调色）；强调色须在每个素材中反复出现，因为第二种强调色就等于没有强调色；两种字体系列，注明字重及用途（展示、正文）；一句简短具体、而非口号式的品牌语气描述；标志的留白空间和最小尺寸；三条“绝不”规则（绝不拉伸、绝不使用调色板以外的颜色、绝不使用其他字体设置文字标）。提示词须原样写出其中的十六进制色值，每道关卡都通过 text_inputs 将规格表全文传给 asset_analyze（改写会丢失准确拼写和色值用途）。字体须选用目标平台可加载的字体系列（广泛可用或已获授权）：生成的“字体”只是字体的图片，因此，真实文本由 scenario-text-overlay 使用规格表中的字体系列排版。文字标是个例外：它只绘制一次并融入标志，逐字母通过审核，此后便作为图稿重复使用。

实例：为一家新游戏工作室打造品牌形象

1. 先写规范。在动笔之前，先确定类别、受众、承诺和核心隐喻，因为第 2 步的标志源自这个隐喻。简报说明情绪基调；如果没有明确方向，scenario-inspiration 会将其转化为选定方向。生成任何内容之前，先写明配色、字体和规则，并与用户确认（无人值守时：遵循简报中的约束，自行决定其余内容，并标记为暂定）。首次生成之前，创建本次运行的集合（collection_create，目录写入通道，仅填写 name），然后每选定一个素材就用 collection_add_assets 将其加入；返回的 itemCount 即为回执。
2. 标志：使用 recommend，设置 capability="txt2img"，并在提示词中要求生成真正可编辑的 SVG，而非光栅图；对选定模型调用 model_schema_get。围绕工作室的业务提出一个创意，并不断简化，直到它在一种颜色下、favicon 尺寸时仍然清晰可辨：采用扁平闭合几何图形、少量颜色、规范中的十六进制色值，以及用于字标的工作室名称。说明要避免什么，否则模型会采用默认套路（渐变网格、闪光、不明所以的闪电、地球）。如果某个模型拒绝符合架构的调用，就放弃它并选择下一个选项，而不要调试，因为架构可能将某字段标为可选，而模型实际要求必须提供。生成 3 个候选方案，每个使用不同的构造方法，且最多组合其中两种方法，让这一组方案在某个维度上有所变化，而非反复生成同一个创意：将字母组合与隐喻融合、把产品的动词化为符号、将两个创意简化为一个、用负空间传达第二层含义、在明确指定的网格上构造几何图形。本轮传入 priority="cost"，因为 3 个方案中有 2 个会被丢弃，而 recommend 默认会选择质量优先的模型。每个候选方案分别调用一次 model_run，然后执行 jobs_wait 和 asset_display，让用户选择（无人值守时：对所有方案进行审核，保留最佳通过方案）。
3. 使用 asset_analyze 审核选定方案（写入通道，契约见 scenario-asset-analysis），并通过 text_inputs 提供规范：逐字母读取名称、几何形状闭合且居中、不与现有标志相似。这一步审核的是渲染结果，而非文件（scenario-asset-analysis），因此配色检查应在本地解析 SVG 的填充色。如果未通过，就收紧提示词后重新运行（对新任务执行 jobs_wait 后再审核），绝不能编辑偏离规范的输出。
4. 变体：对胜出的标志调用 asset_get，并使用 curl -L 保存其 url；该地址会原样提供已存储的 SVG（asset_download 会将其转换为光栅图，format 默认值为 png）。重新着色填充，制作单色、反白和纸张底色变体；对每个变体调用 upload_asset（kind 为 image）。标志只有一个，配色变体作为数据处理。
5. 应用场景：使用 recommend，设置 capability="img2img"；如果某个选项的 when_general_better 或 caveats 提及当前应用场景，就跳过该选项。严格按照架构的要求接入已批准的标志作为参考图（仅在 array: true 时使用数组；架构没有图像字段的选项无法容纳标志，应选择下一个选项）。每个应用场景（头像、横幅、印刷卡片或徽章）分别调用一次 model_run，每条提示词都要让场景服从标志，并禁止画面中出现文字或伪造的 UI（展示牌呈现的是标志在实际位置上的样子，而不是产品运行时的样子）：“the exact logo from the reference, unaltered, centered on...”。对这些任务执行 jobs_wait，然后根据规范逐一审核；如果输出尺寸下无法确认文字，就视为未经验证，而非通过（应放大后重新审核，或标记出来）；如果场景破坏了标志，就使用同一 img2img 调用重新生成，在提示词中指出缺陷，并以已批准的标志为事实依据。
6. 精确文字（标语、账号、URL）应使用规范中的字体，通过 scenario-text-overlay 合成，绝不能在展示牌图像的提示词中要求生成。尺寸根据 scenario-formats 中各应用场景的要求确定。
7. 展示板：应将整套素材作为一张完整画面来评估。model_scenario-compose-image 接收标志、配色样本、字体样张、放大的品牌声音文案、一张图像风格参考图（额外运行一次生成）、图标与徽章条，以及两个应用场景素材作为图层；在 canvasMode: "custom" 画布上，通过 x、y、anchor 和 zIndex 放置图层。另加一个根据主 SVG 在本地绘制的构造示意面板，绝不能生成（生成的示意图会展示标志并不具备的几何形状）；面板标签使用 scenario-text-overlay 渲染（图层字段和注意事项见 scenario-video-assembly）。每个图层都要明确设置 width 和 height，标志的尺寸要大于其他所有图层，并为每个图层设置 fit: "contain"：留空会采用原生尺寸（文档虽如此说明，但并不可靠）；同时设置两个尺寸会启用默认的 fill，导致图像拉伸，违反规范中禁止拉伸的规则。画布尺寸应根据最小的说明文字确定，而不是按屏幕尺寸设计（最大可达 7680x4320；如果使用 1920x1080 的展示板，配色说明文字可能只有约十像素高）；每个图层都要根据其所占的像素尺寸，从主 SVG 渲染，而不是到处重复使用同一张光栅图：保留矢量主图，就是为了避免任何图层被放大。组合之前，先对每个渲染结果调用 upload_asset，因为图层的 source 接收的是素材，而不是本地文件。
8. 本次运行过程中逐步填充的集合就是整套素材：SVG 主图、每个变体、每个应用场景素材和展示板。使用 asset_update 更新每项素材的描述，写明其用途和规则，并将规范说明表作为整套素材的使用页面交付。

常见错误

• 在规范存在之前生成应用：没有书面记录的十六进制色值和规则，就无从把关，组件包会在各个资源中逐渐偏离。
• 为每个应用重新设计 Logo，而不是引用现有 Logo：十个相似的版本，却没有统一的识别性。标志只生成一次，之后重复使用。
• 放大 Logo 的栅格图：矢量图本来就可以缩放；SVG 始终是主文件。
• 通过重新生成来更改颜色：SVG 中的填充和描边可以直接编辑文本；重新生成还会改变几何形状。
• 传入缩略图大小看起来没问题的字标：字形偏差在缩略图中不易察觉；把关流程会逐字读取并核对。
• 把调色板的十六进制色值当作一种感觉：未命名的颜色每次生成时都会偏暖或偏冷；每个提示词都应按规范写明颜色名称。
• 上传与主文件字节完全相同的变体：平台会返回主文件自身的资源 ID，因此组件包中的两个条目会悄然合并为一个，集合计数也会出错。没有任何改动的版本不算变体；上传前应修改填充色，或移除烘焙的底色路径。
• 从样机而不是主文件派生变体：从衍生品再派生会叠加瑕疵（scenario-formats 列出了操作顺序）。