name: xxd-panel-028 description: "Create XXD Panel 028 raster artwork from one image or a directory batch while treating the bundled original style brief as the sole aesthetic authority. Supports one or more top-bottom, left-right, design-only, and four-device wallpaper outputs; multiple ratios or exact sizes; prompt-generated, user-exact, or text-free typography; and inline parameters. Use when the user invokes xxd-panel-028 or requests the exact Panel 028 style."

XXD Panel 028

Create finished PNG artwork from the current user-supplied photograph or image directory. Read references/original-prompt/zh-CN.md completely immediately before every generation. That Chinese source brief is the sole creative and aesthetic authority; never summarise, translate, blend, or replace it with this file, a README, a sample, or another Panel.

Read references/soldier-runtime.md completely immediately before building every generation request. It is the sole family runtime contract for parameters, preference reuse, directory batches, preflight, prompt assembly, bitmap execution, output isolation, and acceptance. This Skill must not write a second art direction or a second runtime.

Write every selected final PNG directly inside one fresh task directory under ~/Desktop/xxd/xxd-panel-028/ (or the explicit --out root). Use collision-safe filenames; do not create source, mode, or size subdirectories and do not generate an automatic contact sheet.

References

• references/soldier-runtime.md — family runtime contract used at generation time
• references/original-prompt/zh-CN.md — canonical source brief used at runtime
• references/original-prompt/README.md — translation index and authority note
• references/runtime-preferences.md — safe delivery-preference reuse
• references/sample-workflow.md — sample-artwork maintenance only; never a runtime prerequisite
• references/xxd-panel-028-prompt.zh-CN.md and .en.md — delivery adapter notes matching the family runtime blocks

🦁 XXD Panel 028｜等距微景观

把照片安放成一件源图配色的等距纸上微缩景观

简体中文 · English · 日本語 · 한국어 · العربية

原始 X 样张

16:9 左右双联样张

以下四张为独立素材，完整 16:9 画布：左为现实摄影，右为本 Panel 设计转译，严格 50:50。文案由模型按原始提示词从当前照片智能生成。

3:4 上下双联样张

以下四张使用与 16:9 组完全不同的四张独立素材，重新生成完整 3:4 上下双联画布；上部保留现实摄影，下部遵循本 Panel 原始提示词重构。英文配字只从当前照片的内容、情绪或隐喻中生成。

当照片需要用于海报、封面、社交内容或壁纸时，真正需要解决的通常不是简单换一种画风，而是如何在重新设计之后，仍然保留主体身份、关键关系、情绪与辨识度。

Panel 028 适合这类任务：需要保留原图核心内容，同时希望最终视觉达到以下方向：把照片安放成一件源图配色的等距纸上微缩景观。它先从用途与期望结果出发，再决定构图、尺寸、文字和具体输出形式。

适合这些情况

• 保留内容： 原图中的人物、物件、动作和关系不能被无关模板替换。
• 提升表达： 希望照片获得更明确的编辑设计、艺术语言或叙事重点。
• 灵活交付： 同一素材需要对照图、纯设计图、多种比例或一套壁纸。

快速开始

无需先阅读全部参数。发送一张图片给 Agent，并说明：

用 XXD Panel 028 帮我处理这张图，先推荐最合适的构图和尺寸。

上方样张可用于确认视觉方向；准备开始时，直接前往开始使用。完整模式、尺寸和参数收录在后面的折叠资料中，可按需查阅。

快速判断：XXD Panel 028 适合你吗？

使用窍门

• 先给一张清楚的照片： 先选一张主体、动作和关系都容易辨认的图，再决定输出方式与比例。
• 一句话串起参数： 直接说“上下对照 / 左右对照 / 纯设计 + 16:9 / 3:4 / 手机壁纸”，也可以补充电脑、平板或电子手表尺寸。
• 把必须保留的内容说清楚： 指定人物、物件、动作、关系和文字；避免同时规定过多布局细节，让风格有空间完成设计。
• 文字有三种选择： 让模型按图片智能生成、用 --text exact --copy 锁定逐字文案，或用 --text none 完全不要文字。
• 说明现实区与设计区： 上下或左右对照时，注明哪一侧保留照片、哪一侧负责设计转译；纯设计和壁纸则说明整张画布都要重新设计。
• 先单张试，再批量做： 先用一张图确认模式、比例、文字和语言，再把同一套参数用于目录批处理；每轮只改一个变量，结果更容易比较。

开始使用

git clone https://github.com/nevertoday/xxd-panel-028.git
mkdir -p ~/.codex/skills
ln -s "$(pwd)/xxd-panel-028" ~/.codex/skills/xxd-panel-028

也可以直接使用 npx skills 安装：

npx skills add https://github.com/nevertoday/xxd-panel-028 --skill xxd-panel-028

该命令会从 GitHub 获取仓库，并把同名 Skill 安装到当前 Agent。若要安装到用户级 Codex Skills 目录，可在命令末尾加上 --global --agent codex --yes。

Claude Code 用户可以把同一目录链接到 ~/.claude/skills/xxd-panel-028。安装后重新启动 Agent 会话。

$xxd-panel-028
把这张照片做成左右双联，文案由你根据照片内涵创作，使用自然韩语。

只上传照片也可以调用。Skill 会先用分行编号菜单询问一个或多个模式，再询问文字设置；选择壁纸时还会确认连贯或独立以及设备尺寸。

完整规范：

• Skill 工作流
• 中文运行适配器
• 英文运行适配器
• 原始风格提示词

原始提示词 · 五种语言

打开统一的多语言目录： 简体中文原文 · English · 日本語 · 한국어 · العربية

简体中文文件保存小小东提供的逐字原文，并且是运行时唯一审美权威；其他四个版本是忠实的阅读译文，方便国际读者理解和转发，不会反过来改写生图提示词。

原始提示词优先，而不是二次导演

references/original-prompt/zh-CN.md 是本项目唯一的创作与审美权威。Skill 不再额外总结或扩写它，也不会统一规划颜色、色板、美学动机、标题或微文案。原始提示词要求怎样处理颜色、材料、构图、留白与文字，GPT Image 2 就按那套逻辑执行。

模式与尺寸会完整替换原始提示词旧有的 3:4 上下交付容器，但不改写它的转译美学。每张成品只向 GPT Image 2 发送一个已选模式的最终契约，不再把四种模式放进同一个通用模板让模型自行猜测。

四种可组合输出模式

模式可以单选或多选：top-bottom、left-right、design-only、wallpaper-pack；多选时，每个模式分别生成、分别拥有自己的提示词。

• top-bottom：整张画面由上方现实画面与下方设计转译两个主要部分组成。
• left-right：整张画面从顶部到底部保持完整左右结构，原图在左、设计在右；文字融入这两个区域，不再生成横跨全宽的第三块底栏。左右外部区域严格各占 50%；只允许在各自区域内部自由安排裁切、尺度、留白与排版。
• design-only：原图只作为不可见的身份、结构、颜色与事实依据；整张成品的每个可见元素都必须属于该 Skill 自己的设计转译语言。
• wallpaper-pack：每台设备分别生成完整画布的设计转译壁纸，原图不作为照片区域出现。

上下或左右都不做分界线、中线百分比或像素坐标检测。只有用户明确要求像素级分区或原片逐像素不变时，才使用确定性拼合。

普通成品尺寸同样可以多选：自动适配、跟随原图、1:1、3:4、4:3、4:5、5:4、2:3、3:2、9:16、16:9、21:9、5:7、7:5，或自定义比例／准确像素。没有静默默认尺寸；每个不同比例都会基于同一份原始提示词独立重构。

壁纸套装可选“连贯”或“四张独立”。连贯模式先生成一张定调图，其余设备同时参考原图与定调图重新构图；不会把一张图机械裁成四种尺寸。

每次调用只建立一个任务目录，所有最终 PNG 直接放在该目录中，不再按来源、模式、尺寸或设备创建子文件夹。文件名使用 source-序号-原文件名-模式-比例-像素.png；壁纸额外包含连贯关系与设备，例如 source-001-street-left-right-3x2-2160x1440.png、source-001-street-wallpaper-linked-phone-1440x3200.png。

直接传入一个图片目录时，这个士兵 Skill 会自动批量处理目录中的图片，并让每张图片都使用 Panel 028 的同一套原始审美。默认递归扫描常见位图，先报告数量，再统一确认一次模式、尺寸、文字和语言；每张图片独立生成，互不借用内容或文案。整批仍然只创建一个扁平任务目录，单张失败会被记录，但不会静默跳过后续图片。

文字方式

正式生图前只确认三种选择：

1. 模型根据原始提示词生成文字：用户只指定语言或地区，文字内容、数量、气质与排版由 GPT Image 2 按原始提示词生成；所有文字都从当前图片的内容、气质或隐喻中自然生长，任何事实或资料式信息都必须有用户输入、图片可见内容或已核实信息作为依据。
2. 使用我的准确文字：逐字传给图像模型，不改写、不翻译、不补标题；排版仍遵循原始提示词。
3. 不要文字：严格禁止文字与伪文字。

外层 Skill 不再预编标题、微文案或文案包。文字语言与操作语言分开确认，不根据人物、场景或文件名猜测国家与受众。

完整画布优先与位图边界

图像模型负责整张成品的审美重构，双联也默认一次直出完整画布。scripts/compose_panel.py 只保留为条件明确的兜底、无创尺寸校准和只读审计工具，不再预先规划每次任务，也不评价审美是否成功。

全部交付为 PNG 位图。每次调用都在 ~/Desktop/xxd/ 下创建新任务；已配置图像通道只返回脱敏状态，不公开供应商、端点、凭据、请求头、提示词、响应或账户信息。SVG、HTML、Canvas、图表和程序绘图不能替代最终作品。

能力自适应问询与快捷参数

同一个 Skill 会根据宿主真正提供的交互能力选择界面，不会把文本符号伪装成可点击控件：

• Claude Code 提供 AskUserQuestion + multiSelect: true 时：模式和尺寸使用真正的 checkbox；文字方式与壁纸关系使用单选。常用尺寸会按方形、竖版、横版分组展示，并累计多组选项；自定义尺寸进入自由输入。
• Codex 只提供 request_user_input 时：它只用于文字方式、壁纸关系等互斥单选，不拿来伪装模式或尺寸多选。模式与尺寸改用清楚的组合输入。
• 没有交互工具时：使用两轮文字问询。第一轮选择一个或多个模式；第二轮填写尺寸与文字方式。Skill 不显示假的 - [ ]，也不会为了获得表单要求用户切换 Plan mode。

默认第二轮只展示“智能推荐／跟随原图／常用比例／自定义”四个入口；只有选择常用比例时，才展开完整比例库：方形 1:1，竖版 3:4、4:5、2:3、9:16、5:7，横版 4:3、5:4、3:2、16:9、21:9、7:5。所有比例都可组合，也可直接输入准确像素。

全部设置都可以直接作为参数传入：

/xxd-panel-028 photo.jpg --mode top-bottom,design-only --size auto,3:4,9:16 --text prompt --locale ja-JP

支持 --mode、可重复或逗号分隔的 --size、--text prompt|exact|none、--locale、--copy、--wallpaper linked|independent、--wallpaper-size、--out 和 --prefs。参数齐全时跳过全部问询；参数不完整时只询问缺失项。

继承上次偏好，或全新配置

检测到历史偏好时，Skill 会先展示上次的模式、尺寸、文字与语言、壁纸关系和输出位置，再提供三个互斥选项：直接沿用、沿用并修改、全新配置。本次明确说出的要求始终优先；完整参数仍然直接执行。

可使用 --prefs last|edit|new|off|clear 直接指定行为：

/xxd-panel-028 photo.jpg --prefs last
/xxd-panel-028 photo.jpg --prefs edit
/xxd-panel-028 photo.jpg --prefs new

偏好只保存交付设置，不保存原图、准确文案、生成结果、Panel 选择、模型通道、API 凭据或其他敏感信息。

photo.jpg 也可以直接替换为图片目录路径；目录输入会自动进入批量，不需要额外的 --batch 开关。

参数速查

photo.jpg 可以替换为本地图片路径、已上传图片、图片目录或用户明确给出的其他来源。目录会自动进入批量处理。

按用途复制命令

# 上下对照：智能推荐画幅，模型按原始提示词生成简体中文文字
/xxd-panel-028 photo.jpg --mode top-bottom --size auto --text prompt --locale zh-CN

# 左右对照：3:2 横版，无文字
/xxd-panel-028 photo.jpg --mode left-right --size 3:2 --text none

# 只要设计图：9:16 手机竖版，日语文字
/xxd-panel-028 photo.jpg --mode design-only --size 9:16 --text prompt --locale ja-JP

# 四端连贯壁纸：先建立一张定调图，再按设备分别重构
/xxd-panel-028 photo.jpg --mode wallpaper-pack --wallpaper linked --text none

# 四张独立壁纸：同时指定四台设备的准确分辨率
/xxd-panel-028 photo.jpg --mode wallpaper-pack --wallpaper independent --wallpaper-size phone=1440x3200,ipad=2048x2732,desktop=3840x2160,watch=1024x1024 --text none

# 跟随原图比例
/xxd-panel-028 photo.jpg --mode design-only --size source --text none

# 同一用途生成方形、竖版和横版三种完整构图
/xxd-panel-028 photo.jpg --mode design-only --size 1:1,3:4,16:9 --text none

# 自定义比例与准确像素可以一起多选
/xxd-panel-028 photo.jpg --mode design-only --size 11:14,2160x3840,3840x2160 --text none

# 模型依照原始提示词决定文字，只限定语言
/xxd-panel-028 photo.jpg --mode design-only --size 3:4 --text prompt --locale en-GB

# 使用准确文案，不改写、不翻译、不补标题
/xxd-panel-028 photo.jpg --mode design-only --size 3:4 --copy "让风经过这里" --locale zh-CN

# 两种模式 × 三种尺寸，共生成六张独立完整构图
/xxd-panel-028 photo.jpg --mode top-bottom,design-only --size 1:1,3:4,9:16 --text prompt --locale zh-CN

# 整个目录统一使用 Panel 028；公共设置只解析一次
/xxd-panel-028 "/path/to/photos" --mode design-only --size auto,9:16 --text prompt --locale zh-CN

# 重复参数也会累积，并把本次任务放到指定根目录
/xxd-panel-028 photo.jpg --mode top-bottom --mode left-right --size 3:4 --size 16:9 --text none --out ./deliveries

生图模型优先级

GPT Image 2 是默认首选，并继续执行本项目现有的高保真垫图、生成前确认整张画幅、双联一次生成完整画布、脚本仅作条件式兜底等逻辑。

当当前工具或已配置兼容通道确实可用，并能满足原图保真、整张成品比例、目标语言文字和连贯壁纸多图参考等要求时，也支持 Seedance 5.0 Pro、Nano Banana Pro（Gemini Image