jeffstric/zjt/location-prop-image-designer
Claude Code and agent skill by jeffstric/zjt
- community
Checking that the SKILL.md file is still in the repository.
场景道具图片设计师专门负责管理和生成场景和道具的视觉形象。它能够扫描所有场景和道具,识别缺少参考图像的项目,并批量生成场景和道具的参考图像。
Install
npx vskill@latest install jeffstric/zjt/location-prop-image-designerSKILL.md
场景道具图片设计师 (Location & Prop Image Designer)
技能描述
场景道具图片设计师专门负责管理和生成场景和道具的视觉形象。它能够扫描所有场景和道具,识别缺少参考图像的项目,并批量生成场景和道具的参考图像。
⚠️ 核心规则:生成方式选择(强制执行)
✅ 强制规则:
- 2个或更多场景 → 优先使用
generate_4grid_location_images()(4宫格批量生成) - 如果场景数量为2或3个,用全高黑色占位图片补齐到4个(提示词:"A pure black background image, solid black color, 16:9 aspect ratio, full height")
- 例如:2个场景 → [场景1, 场景2, 黑色占位, 黑色占位](顺序:左上、右上、左下、右下)
- 例如:3个场景 → [场景1, 场景2, 场景3, 黑色占位](顺序:左上、右上、左下、右下)
- 如果4宫格生成失败,则改用
generate_text_to_image()逐个生成 - 2个或更多道具 → 优先使用
generate_4grid_prop_images()(4宫格批量生成) - 如果道具数量为2或3个,用全高黑色占位图片补齐到4个(提示词:"A pure black background image, solid black color, 16:9 aspect ratio, full height")
- 例如:2个道具 → [道具1, 道具2, 黑色占位, 黑色占位](顺序:左上、右上、左下、右下)
- 例如:3个道具 → [道具1, 道具2, 道具3, 黑色占位](顺序:左上、右上、左下、右下)
- 如果4宫格生成失败,则改用
generate_text_to_image()逐个生成 - 仅1个场景或道具 → 使用
generate_text_to_image()(单个生成)
🚫 违规行为(禁止):
- ❌ 在4宫格生成成功的情况下,仍然逐个生成
- ❌ 未尝试4宫格生成就直接逐个生成(当场景/道具数量>=2时)
执行前验证(必须):
优势:
- 批量生成2-4个场景/道具,大幅提升效率
- 自动切分和更新,无需手动处理
- 高分辨率4K图像质量
- 保持同批次场景/道具视觉风格一致
- 对于2-3个场景/道具,空余位置用全高黑色占位图片填充(提示词设为"A pure black background image, solid black color, 16:9 aspect ratio, full height")
- 填充顺序:按Shot 1→Shot 2→Shot 3→Shot 4的顺序填充(先上排后下排,先左后右)
图像生成方式
4宫格批量生成(推荐方式)
为了提高生成效率和保持视觉一致性,场景和道具采用4宫格批量生成方式:
生成流程:
- 分组:将需要生成的场景/道具按每4个一组进行分组
- 生成4宫格:使用2x2布局一次性生成4个场景/道具的设计图
- 自动切分:后端代码会自动使用
image_grid_splitter.py工具将4宫格图像切分为4个独立图像(AI无需手动调用切分工具) - 保存:切分后的图像会自动保存到对应场景/道具的
reference_image字段
4宫格生成JSON格式:
切分顺序:
⚠️ 重要说明:
- AI无需手动调用切分工具 - 后端代码会自动处理4宫格图像的切分和保存
- 如果场景/道具数量不是4的倍数,最后一批可以少于4个
- 同一批次的4个场景/道具会保持一致的视觉风格
- 切分后的图像会自动保存到场景/道具的
reference_image字段
🔴 防止图片中出现文字(Seedream文字抑制规则 - 强制执行)
问题背景: Seedream等生图模型有在生成的图片中自动添加文字(如标题、标签、水印、标识、中英文文字、印章等)的倾向。必须在提示词中采取强力措施抑制文字生成。
强制规则(每个提示词必须遵守):
规则1:提示词末尾必须追加反向文字声明
每个提示词的最后(结尾处)必须追加以下反向文字声明:
规则2:提示词中避免使用可能诱导文字生成的词汇
以下词汇可能诱导生图模型在图片中添加文字,应当避免或替换:
- ❌ "title" → ✅ 不使用,或改用描述性语言如 "top section"
- ❌ "label" → ✅ "color swatch" 或 "color block"
- ❌ "caption" → ✅ 不使用
- ❌ "name tag" → ✅ 不使用
- ❌ "header" → ✅ "top area" 或 "upper section"
- ❌ "written in" → ✅ 不使用
规则3:双重保险机制
- 即使模板中已包含"No text"相关描述,末尾仍必须追加上述完整的反向文字声明
- 这是因为Seedream等模型对提示词末尾的指令更为敏感,将禁止文字声明放在末尾效果最佳
主要功能
- 场景道具列表管理 - 获取所有场景和道具列表并分析参考图像状态
- 缺失图像识别 - 识别没有参考图像的场景和道具
- 图像提示词生成 - 基于场景道具特征和标准模板创建专业的图像生成提示词
- 任务状态检查 - 确保同一场景或道具没有正在进行的图像生成任务
- 批量图像生成 - 为多个场景和道具依次生成参考图像
工作流程
0. 获取世界画风信息(必须首先执行)
- 调用
read_world()获取世界设定信息 - 提取以下关键画风字段并缓存:
visual_style: 画面风格(如:日系动漫、写实、Q版等)era_environment: 时代环境(如:古风、现代、科幻等)color_language: 色彩语言(如:暖色调、冷色调、高饱和等)composition_preference: 构图倾向- 这些信息将用于所有场景和道具的提示词生成,确保画风一致性
1. 场景道具列表获取与分析
- 使用
list_location_jsons()获取所有场景文件列表 - 使用
list_prop_jsons()获取所有道具文件列表 - 对每个场景调用
read_location_json(场景名)读取详细信息 - 对每个道具调用
read_prop_json(道具名)读取详细信息 - 检查每个场景和道具的
reference_image字段是否为空或缺失 - 仅处理符合条件的项目:
- ✅ 没有参考图像(
reference_image为空或null) - ✅ 没有正在进行的图像生成任务
- 生成需要图像的场景和道具清单
2. 批量任务状态检查
- 对每个需要生成图像的场景调用
get_task_status(item_type=2, item_name=场景名) - 对每个需要生成图像的道具调用
get_task_status(item_type=3, item_name=道具名) - 严格过滤规则:
- ❌ 跳过状态为
processing、pending、in_progress的项目 - ❌ 跳过已有
reference_image的项目 - ✅ 仅处理状态为
completed、failed、not_found或无记录的项目 - 创建可以立即处理的场景和道具队列
3. 获取生图模型算力信息(必须在生成前执行)
- 在批量生成场景和道具图像前,必须先调用 `get_text_to_image_model_info()` 获取当前生图模型的算力信息
- 提取以下关键字段:
computing_power: 单张图像算力消耗cost_per_image_default_size: 默认尺寸单张算力消耗cost_per_image_max_size: 最大尺寸单张算力消耗supported_sizes: 支持的尺寸列表supports_grid_image: 是否支持4宫格生成driver_hint: 模型特定的强制约束(⚠️ 必须严格遵守,否则生成会失败)- 使用获取到的算力值计算总消耗,代替任何写死的算力数值
- 如果算力不足,向用户报告所需算力和当前模型信息
⚠️ 返回值示例及关键字段说明:
🔴 `driver_hint` 强制约束(违反将导致生成失败):
driver_hint包含当前生图模型的硬性限制和约束条件- 这些约束因模型不同而不同,必须每次调用后动态读取并严格遵守
- 常见约束示例:
- 提示词长度限制(如:5000字符以内)
- 特定格式要求
- 不支持的功能或参数
- 执行要求:
- 调用
get_text_to_image_model_info()后,立即检查 `driver_hint` 字段 - 在构建提示词时,必须确保所有提示词都符合 `driver_hint` 中的约束
- 如果提示词超出限制,必须精简提示词,删除冗余描述,保留核心视觉信息
- 绝对不允许无视
driver_hint的约束直接提交超限提示词
4. 逐个项目图像生成
4.1 场景信息深度提取
🚨 关键警告(生成提示词前必读):
在生成任何提示词之前,必须先执行以下检查:
如果你在写实风格的提示词中使用了 "anime" 或 "reference sheet",这是严重错误!
从场景数据中详尽提取以下信息(越详细越好):
基本信息:
- 场景名称(包含中英文)
- 场景类型(如:室内、室外、建筑、自然景观)
- 所属区域/地点
- 重要性等级
环境特征(必须详细描述):
- 地形地貌:平原、山地、水域、建筑结构等
- 建筑风格:古典、现代、奇幻、废墟等
- 植被环境:森林、草原、花园、荒漠等
- 天气氛围:晴朗、阴霾、雨雪、雾气等
- 光照条件:日光、月光、人工照明、魔法光源等
空间布局:
- 主要区域划分和功能
- 重要地标和标志性建筑
- 道路、通道、入口出口
- 空间尺度和比例关系
装饰与细节:
- 建筑装饰:雕刻、壁画、门窗样式
- 环境装饰:雕像、喷泉、花坛、路灯
- 材质纹理:石材、木材、金属、织物
- 色彩搭配:主色调、辅助色、点缀色
氛围与情感:
- 整体氛围(如:庄严、温馨、神秘、荒凉)
- 情感基调(如:宁静、紧张、浪漫、恐怖)
- 文化特色和历史背景
4.2 道具信息深度提取
从道具数据中详尽提取以下信息(越详细越好):
基本信息:
- 道具名称(包含中英文)
- 道具类型(如:武器、工具、装饰品、魔法物品)
- 稀有度/重要性
- 所属者或来源
外观特征(必须详细描述):
- 整体形状:长短、粗细、弯曲、对称性
- 材质质感:金属、木材、宝石、皮革、布料等
- 表面纹理:光滑、粗糙、雕刻、镶嵌、磨损
- 颜色搭配:主色、辅色、光泽度、透明度
- 尺寸比例:长宽高、重量感、便携性
功能与用途:
- 主要功能和使用方法
- 特殊能力或魔法效果
- 使用场景和条件
- 操作方式和技巧要求
装饰与细节:
- 雕刻图案:花纹、文字、符号、徽章
- 镶嵌装饰:宝石、金属、珠宝、符文
- 配件组成:握柄、护手、链条、绳索
- 磨损状态:新旧程度、损伤、锈蚀、修复痕迹
象征意义:
- 文化象征和寓意
- 历史背景和传说
- 情感价值和纪念意义
4.3 场景图像提示词构建
🔴 重要:根据画风类型选择不同的模板格式
步骤1:判断画风类型
- 如果
visual_style包含"写实"、"真实"、"照片"、"摄影" → 使用写实风格模板 - 如果
visual_style包含"动漫"、"二次元"、"卡通" → 使用动漫风格模板
📷 场景写实风格模板(用于写实、照片、真实风格)
⚠️ 关键区别:写实风格不使用 "reference sheet"、"design reference"、"illustration" 等动漫设定图术语,而是使用摄影术语。
📸 场景动漫风格模板(用于动漫、二次元、卡通)
⚠️ 关键区别:动漫风格使用 "reference sheet"、"design reference"、"illustration" 等动漫设定图术语。
4.4 道具图像提示词构建
🔴 重要:根据画风类型选择不同的模板格式
步骤1:判断画风类型
- 如果
visual_style包含"写实"、"真实"、"照片"、"摄影" → 使用写实风格模板 - 如果
visual_style包含"动漫"、"二次元"、"卡通" → 使用动漫风格模板
📷 道具写实风格模板(用于写实、照片、真实风格)
⚠️ 关键区别:写实风格不使用 "reference sheet"、"design reference" 等动漫设定图术语,而是使用产品摄影术语。
📸 道具动漫风格模板(用于动漫、二次元、卡通)
⚠️ 关键区别:动漫风格使用 "reference sheet"、"design reference" 等动漫设定图术语。
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingscript_writer_core/skills/location-prop-image-designer/SKILL.md
Popularity
- Repository stars
- 190
- Repository forks
- 45
- 7-day trend score
- 26
Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 20 May 2026, 5 months ago.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/jeffstric/zjt/location-prop-image-designer)