jeffstric/zjt/location-prop-image-designer

Claude Code and agent skill by jeffstric/zjt

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

场景道具图片设计师专门负责管理和生成场景和道具的视觉形象。它能够扫描所有场景和道具,识别缺少参考图像的项目,并批量生成场景和道具的参考图像。

Install

npx vskill@latest install jeffstric/zjt/location-prop-image-designer

SKILL.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时)

执行前验证(必须):

IF 场景数量 >= 2:
尝试调用 generate_4grid_location_images
IF 场景数量 < 4:
用全高黑色占位图片补齐到4个(提示词:"A pure black background image, solid black color, 16:9 aspect ratio, full height")
顺序:先填充上方两个位置(Shot 1, Shot 2),再填充下方两个位置(Shot 3, Shot 4)
ENDIF
IF 4宫格生成失败:
记录失败原因
改用 generate_text_to_image 逐个生成
ENDIF
ELSE IF 场景数量 == 1:
调用 generate_text_to_image
ENDIF
IF 道具数量 >= 2:
尝试调用 generate_4grid_prop_images
IF 道具数量 < 4:
用全高黑色占位图片补齐到4个(提示词:"A pure black background image, solid black color, 16:9 aspect ratio, full height")
顺序:先填充上方两个位置(Shot 1, Shot 2),再填充下方两个位置(Shot 3, Shot 4)
ENDIF
IF 4宫格生成失败:
记录失败原因
改用 generate_text_to_image 逐个生成
ENDIF
ELSE IF 道具数量 == 1:
调用 generate_text_to_image
ENDIF

优势:

  • 批量生成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宫格批量生成方式:

生成流程:

  1. 分组:将需要生成的场景/道具按每4个一组进行分组
  2. 生成4宫格:使用2x2布局一次性生成4个场景/道具的设计图
  3. 自动切分:后端代码会自动使用 image_grid_splitter.py 工具将4宫格图像切分为4个独立图像(AI无需手动调用切分工具)
  4. 保存:切分后的图像会自动保存到对应场景/道具的 reference_image 字段

4宫格生成JSON格式:

json
{
"grid_layout": "2x2",
"grid_aspect_ratio": "16:9",
"global_watermark": "",
"shots": [
{
"shot_number": "Shot 1",
"prompt_text": "场景/道具1的完整提示词"
},
{
"shot_number": "Shot 2",
"prompt_text": "场景/道具2的完整提示词"
},
{
"shot_number": "Shot 3",
"prompt_text": "场景/道具3的完整提示词"
},
{
"shot_number": "Shot 4",
"prompt_text": "场景/道具4的完整提示词"
}
]
}

切分顺序:

┌─────────┬─────────┐
│ Shot 1 │ Shot 2 │ 场景/道具1(左上) → 场景/道具2(右上)
│ (左上) │ (右上) │
├─────────┼─────────┤
│ Shot 3 │ Shot 4 │ 场景/道具3(左下) → 场景/道具4(右下)
│ (左下) │ (右下) │
└─────────┴─────────┘

⚠️ 重要说明:

  • AI无需手动调用切分工具 - 后端代码会自动处理4宫格图像的切分和保存
  • 如果场景/道具数量不是4的倍数,最后一批可以少于4个
  • 同一批次的4个场景/道具会保持一致的视觉风格
  • 切分后的图像会自动保存到场景/道具的 reference_image 字段

🔴 防止图片中出现文字(Seedream文字抑制规则 - 强制执行)

问题背景: Seedream等生图模型有在生成的图片中自动添加文字(如标题、标签、水印、标识、中英文文字、印章等)的倾向。必须在提示词中采取强力措施抑制文字生成。

强制规则(每个提示词必须遵守):

规则1:提示词末尾必须追加反向文字声明

每个提示词的最后(结尾处)必须追加以下反向文字声明:

ABSOLUTELY NO text, NO watermark, NO letters, NO characters, NO words, NO signs, NO writing, NO typography, NO labels, NO captions, NO subtitles, NO Chinese characters, NO English text, NO numbers, NO logos, NO stamps, NO seals, completely text-free image, pure visual content without any written language
规则2:提示词中避免使用可能诱导文字生成的词汇

以下词汇可能诱导生图模型在图片中添加文字,应当避免或替换:

  • ❌ "title" → ✅ 不使用,或改用描述性语言如 "top section"
  • ❌ "label" → ✅ "color swatch" 或 "color block"
  • ❌ "caption" → ✅ 不使用
  • ❌ "name tag" → ✅ 不使用
  • ❌ "header" → ✅ "top area" 或 "upper section"
  • ❌ "written in" → ✅ 不使用
规则3:双重保险机制
  • 即使模板中已包含"No text"相关描述,末尾仍必须追加上述完整的反向文字声明
  • 这是因为Seedream等模型对提示词末尾的指令更为敏感,将禁止文字声明放在末尾效果最佳

主要功能

  1. 场景道具列表管理 - 获取所有场景和道具列表并分析参考图像状态
  2. 缺失图像识别 - 识别没有参考图像的场景和道具
  3. 图像提示词生成 - 基于场景道具特征和标准模板创建专业的图像生成提示词
  4. 任务状态检查 - 确保同一场景或道具没有正在进行的图像生成任务
  5. 批量图像生成 - 为多个场景和道具依次生成参考图像

工作流程

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: 模型特定的强制约束(⚠️ 必须严格遵守,否则生成会失败)
  • 使用获取到的算力值计算总消耗,代替任何写死的算力数值
  • 如果算力不足,向用户报告所需算力和当前模型信息

⚠️ 返回值示例及关键字段说明:

json
{
"success": true,
"task_id": 26,
"name": "GPT Image 2 图片编辑",
"computing_power": 2,
"supported_sizes": ["1k", "2k", "4k"],
"supported_ratios": ["1:1", "2:3", "3:2", "16:9", "9:16"],
"supports_grid_image": true,
"default_size": "1k",
"max_size": "4k",
"cost_per_image_default_size": 2,
"cost_per_image_max_size": 2,
"driver_hint": "提示词长度请控制在5000字符以内,超出将被API拒绝。请精简描述,避免冗余。"
}

🔴 `driver_hint` 强制约束(违反将导致生成失败):

  • driver_hint 包含当前生图模型的硬性限制和约束条件
  • 这些约束因模型不同而不同,必须每次调用后动态读取并严格遵守
  • 常见约束示例:
  • 提示词长度限制(如:5000字符以内)
  • 特定格式要求
  • 不支持的功能或参数
  • 执行要求:
  1. 调用 get_text_to_image_model_info() 后,立即检查 `driver_hint` 字段
  2. 在构建提示词时,必须确保所有提示词都符合 `driver_hint` 中的约束
  3. 如果提示词超出限制,必须精简提示词,删除冗余描述,保留核心视觉信息
  4. 绝对不允许无视 driver_hint 的约束直接提交超限提示词
4. 逐个项目图像生成
4.1 场景信息深度提取

🚨 关键警告(生成提示词前必读):

在生成任何提示词之前,必须先执行以下检查:

1. 调用 read_world() 获取 visual_style
2. 检查 visual_style 中是否包含"写实"、"真实"、"照片"、"摄影"等关键词
3. 如果包含 → 绝对禁止在提示词中使用以下词汇:
❌ "anime"
❌ "reference sheet"
❌ "design reference"
❌ "illustration"
必须使用以下词汇:
✅ "photography"
✅ "photograph"
✅ "architectural photography"
✅ "location shoot"

如果你在写实风格的提示词中使用了 "anime" 或 "reference sheet",这是严重错误!


从场景数据中详尽提取以下信息(越详细越好):

基本信息:

  • 场景名称(包含中英文)
  • 场景类型(如:室内、室外、建筑、自然景观)
  • 所属区域/地点
  • 重要性等级

环境特征(必须详细描述):

  • 地形地貌:平原、山地、水域、建筑结构等
  • 建筑风格:古典、现代、奇幻、废墟等
  • 植被环境:森林、草原、花园、荒漠等
  • 天气氛围:晴朗、阴霾、雨雪、雾气等
  • 光照条件:日光、月光、人工照明、魔法光源等

空间布局:

  • 主要区域划分和功能
  • 重要地标和标志性建筑
  • 道路、通道、入口出口
  • 空间尺度和比例关系

装饰与细节:

  • 建筑装饰:雕刻、壁画、门窗样式
  • 环境装饰:雕像、喷泉、花坛、路灯
  • 材质纹理:石材、木材、金属、织物
  • 色彩搭配:主色调、辅助色、点缀色

氛围与情感:

  • 整体氛围(如:庄严、温馨、神秘、荒凉)
  • 情感基调(如:宁静、紧张、浪漫、恐怖)
  • 文化特色和历史背景
4.2 道具信息深度提取

从道具数据中详尽提取以下信息(越详细越好):

基本信息:

  • 道具名称(包含中英文)
  • 道具类型(如:武器、工具、装饰品、魔法物品)
  • 稀有度/重要性
  • 所属者或来源

外观特征(必须详细描述):

  • 整体形状:长短、粗细、弯曲、对称性
  • 材质质感:金属、木材、宝石、皮革、布料等
  • 表面纹理:光滑、粗糙、雕刻、镶嵌、磨损
  • 颜色搭配:主色、辅色、光泽度、透明度
  • 尺寸比例:长宽高、重量感、便携性

功能与用途:

  • 主要功能和使用方法
  • 特殊能力或魔法效果
  • 使用场景和条件
  • 操作方式和技巧要求

装饰与细节:

  • 雕刻图案:花纹、文字、符号、徽章
  • 镶嵌装饰:宝石、金属、珠宝、符文
  • 配件组成:握柄、护手、链条、绳索
  • 磨损状态:新旧程度、损伤、锈蚀、修复痕迹

象征意义:

  • 文化象征和寓意
  • 历史背景和传说
  • 情感价值和纪念意义
4.3 场景图像提示词构建

🔴 重要:根据画风类型选择不同的模板格式

步骤1:判断画风类型

  • 如果 visual_style 包含"写实"、"真实"、"照片"、"摄影" → 使用写实风格模板
  • 如果 visual_style 包含"动漫"、"二次元"、"卡通" → 使用动漫风格模板

📷 场景写实风格模板(用于写实、照片、真实风格)

⚠️ 关键区别:写实风格不使用 "reference sheet"、"design reference"、"illustration" 等动漫设定图术语,而是使用摄影术语。

[画风描述], [时代环境], [色彩基调]. A professional architectural photography of [场景英文名] ([场景中文名]) from [作品/世界名称], shot with high-quality camera equipment. The location is captured without any people or objects present.
Wide-angle photograph showing the complete overview of [场景名] featuring [详细的环境描述,包括地形、建筑、植被、天气]. The scene displays [空间布局描述,包括主要区域、地标、道路]. Architectural style: [建筑风格详述]. Environmental features: [环境特征如光照、氛围、季节]. The location is completely empty with no people or objects. The overall mood conveys [基于场景特点的氛围描述]. Natural lighting and realistic textures are emphasized. No text, signs, or written language appear in the scene. ABSOLUTELY NO text, NO watermark, NO letters, NO characters, NO words, NO signs, NO writing, NO typography, NO labels, NO captions, NO subtitles, NO Chinese characters, NO English text, NO numbers, NO logos, NO stamps, NO seals, completely text-free image, pure visual content without any written language.

📸 场景动漫风格模板(用于动漫、二次元、卡通)

⚠️ 关键区别:动漫风格使用 "reference sheet"、"design reference"、"illustration" 等动漫设定图术语。

[画风描述], [时代环境], [色彩基调]. A professional location design reference sheet for [场景英文名] ([场景中文名]) from [作品/世界名称], set on a clean neutral background. The layout shows the location without any characters or props. Avoid including any text, words, or written characters in the image.
Large detailed illustration showing the complete overview of [场景名] featuring [详细的环境描述,包括地形、建筑、植被、天气]. The scene displays [空间布局描述,包括主要区域、地标、道路]. Architectural style: [建筑风格详述]. Environmental features: [环境特征如光照、氛围、季节]. The location is completely empty with no people or objects. The overall mood conveys [基于场景特点的氛围描述]. Do not include any text, signs, or written language in the scene. ABSOLUTELY NO text, NO watermark, NO letters, NO characters, NO words, NO signs, NO writing, NO typography, NO labels, NO captions, NO subtitles, NO Chinese characters, NO English text, NO numbers, NO logos, NO stamps, NO seals, completely text-free image, pure visual content without any written language.
4.4 道具图像提示词构建

🔴 重要:根据画风类型选择不同的模板格式

步骤1:判断画风类型

  • 如果 visual_style 包含"写实"、"真实"、"照片"、"摄影" → 使用写实风格模板
  • 如果 visual_style 包含"动漫"、"二次元"、"卡通" → 使用动漫风格模板

📷 道具写实风格模板(用于写实、照片、真实风格)

⚠️ 关键区别:写实风格不使用 "reference sheet"、"design reference" 等动漫设定图术语,而是使用产品摄影术语。

[画风描述], [时代环境], [色彩基调]. A professional product photography collection of [道具英文名] ([道具中文名]) from [作品/世界名称], shot in studio lighting against a clean white backdrop. The prop is photographed alone without any hands, characters, or other objects.
Three-Angle Photography: Three high-quality photographs of [道具名] arranged horizontally. Front Photograph (Left): [道具正面照片的详细描述,包括形状、材质、颜色、纹理、装饰细节]. Side Photograph (Center): [道具侧面照片的详细描述,展现厚度、轮廓、连接部分]. Back Photograph (Right): [道具背面照片的详细描述,必须与正面保持一致的设计元素和比例].
Physical characteristics: [尺寸比例描述], [材质质感如金属光泽、木纹理、宝石透明度等], [表面装饰如雕刻、镶嵌、符文等], [磨损状态和使用痕迹]. All three photographs maintain perfect consistency in proportions, colors, materials, and decorative elements. The prop shows [基于功能和历史的整体状态描述]. Professional studio lighting highlights textures and details. No characters, hands, text, words, or other objects appear in any photograph. ABSOLUTELY NO text, NO watermark, NO letters, NO characters, NO words, NO signs, NO writing, NO typography, NO labels, NO captions, NO subtitles, NO Chinese characters, NO English text, NO numbers, NO logos, NO stamps, NO seals, completely text-free image, pure visual content without any written language.

📸 道具动漫风格模板(用于动漫、二次元、卡通)

⚠️ 关键区别:动漫风格使用 "reference sheet"、"design reference" 等动漫设定图术语。

[画风描述], [时代环境], [色彩基调]. A clean prop design reference sheet for [道具英文名] ([道具中文名]) from [作品/世界名称], set on a white background. The prop appears alone without any characters or hands holding it. Avoid including any text, words, or written characters in the image.

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

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
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/jeffstric/zjt/location-prop-image-designer/badge)](https://verified-skill.com/skills/jeffstric/zjt/location-prop-image-designer)

Something wrong with this skill or its page? Tell us.