xxd-panel-019

name

xxd-panel-019

description

Create XXD Panel 019 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-019 or requests the exact Panel 019 style.

XXD Panel 019

Create fresh PNG artwork with references/original-prompt/zh-CN.md as the sole creative and aesthetic authority. This Skill is a runtime shell: it resolves delivery variables, appends them to the untouched source-brief body, executes bitmap generation, and verifies the result. It must not write a second art direction.

Authority boundary

1. Read references/original-prompt/zh-CN.md completely immediately before building every generation request.
2. Its first Markdown heading is an administrative document label, not creative content. Omit that heading from the image-generation request, then copy the entire remaining source-brief body verbatim. Do not summarize, translate, polish, expand, reinterpret, or replace that body with this file, a README, a sample, either runtime-adapter reference, or one of the reading translations in references/original-prompt/. Those translations exist for international readers and sharing; they are never runtime prompt alternatives.
3. The source brief owns subject transformation, composition inside the design region, colour, palette derivation or fixed colour choices, materials, texture, whitespace, text amount, wording logic, typographic character, and prohibitions.
4. Runtime instructions may change only: selected output mode, final canvas ratio or pixels, placement or visibility of the reality source, device profile, wallpaper relationship, target text language, and user-exact text.
5. Append all runtime instructions after the complete source-brief body. Never insert them into, or rewrite, its aesthetic paragraphs.
6. When a source brief describes an old 3:4 top-bottom container, treat that as the original presentation container. The selected mode-specific block replaces that container completely and decisively; every remaining aesthetic and transformation instruction stays active.
7. Never create a generic palette, extract extra colours, lock a swatch set, invent an “aesthetic motive,” pre-compose a title, generate a copy package, or run an external semantic-reading framework. If the source brief itself asks for any of those things, let the image model perform them exactly there.
8. Samples show outcomes only. Do not copy their subject matter, colours, text, layout accidents, or aspect ratio.

Use these roles when the container changes:

REALITY SOURCE = the uploaded photograph or other user-supplied source image
TRANSFORMED DESIGN = the source brief's “lower half” aesthetic transformation

The mode name is not a loose hint. For every requested asset, append exactly one of the four mode-specific delivery blocks below. Never send unused mode alternatives to the image model. Within the selected contract, let the image model decide proportions, scale, crop or environmental extension, whitespace, overlap and internal layout unless the user explicitly requests exact geometry.

Resolve only runtime variables

Every invocation is a new job unless the user explicitly asks to inspect, edit, continue, or reuse a named result. Repeating the same request requires fresh generation and a new task folder; an old matching file never completes a new request. Remembered delivery preferences may reduce repeated questions, but never authorize reuse of an old source, result, prompt, or task directory.

Inline fast path

Parse parameters anywhere after the invocation and input:

/xxd-panel-019 <source-or-directory> --mode top-bottom,design-only \
  --size auto,3:4,9:16,2160x3840 \
  --text prompt --locale ja-JP

• --mode: one or more of top-bottom, left-right, design-only, wallpaper-pack. Repeated flags and comma-separated values accumulate; accept natural-language equivalents and all / 全部.
• --size: one or more of auto, source, 1:1, 3:4, 4:3, 4:5, 5:4, 2:3, 3:2, 9:16, 16:9, 21:9, 5:7, 7:5, any custom ratio, or exact WIDTHxHEIGHT. Repeated flags accumulate; accept ×.
• --text: prompt, exact, or none. Accept legacy aliases auto → prompt and custom → exact without presenting the old labels to users.
• --copy "...": exact user text; implies --text exact. Do not rewrite or translate it.
• --locale: target language, market, or locale for visible text.
• --wallpaper: linked or independent.
• --wallpaper-size: labelled device sizes, for example phone=1440x3200,ipad=2048x2732,desktop=3840x2160,watch=1024x1024.
• --out: explicit output root.
• --prefs: last, edit, new, off, or clear; controls whether this invocation reuses, edits, ignores, suppresses, or clears the family-wide remembered delivery preference.

Explicit parameters override ambiguous prose. Multi-value parameters accumulate and deduplicate in user order; single-value parameters use the last explicit value. If every required variable is resolved, skip preflight and generate. If values are partial, ask only for unresolved variables. Ask about a direct contradiction such as --text none with --copy.

Remembered preference gate

After parsing current prose and inline parameters, read references/runtime-preferences.md completely and follow it before the ordinary preflight. When unresolved settings remain and a valid previous record exists, offer exactly three clear routes: reuse, reuse and edit, or fresh configuration. A fully specified current invocation remains a true fast path and skips this question.

The remembered record is shared across the XXD Panel family because these are common delivery variables, not Soldier aesthetics. Current explicit requirements always win. Never remember exact copy, source paths, Panel selection, generated content, model routes, credentials, or secrets. Once the current settings are fully resolved, save only the safe delivery fields through scripts/panel_preferences.py, unless the user selected --prefs off or asked not to remember the invocation.

Directory batch intake

A readable directory supplied as the source is explicit batch intent. Enter batch processing immediately; do not ask whether the user wants a batch and do not show an unrelated mode menu before inventory.

1. Recursively inventory supported raster files (.png, .jpg, .jpeg, .webp, .heic, .heif, .avif, .tif, .tiff, .bmp) case-insensitively. Respect an explicit top-level-only request or user exclusions.
2. Ignore hidden files and hidden directories, non-images, this Skill's generated task folders, and output roots inside the supplied tree. Do not follow a symbolic link whose resolved target escapes the supplied directory.
3. Use stable natural ordering by relative path. Report the discovered count and recursive scope before generation. Identify unreadable or undecodable candidates; never silently skip them. If no supported images exist, stop without creating an empty task directory.
4. Build one queue item per discovered source. All queue items use this same numbered Panel and its unchanged source brief; a Soldier never selects, blends, or switches to another Panel during a batch.
5. Resolve shared mode, size, text, locale, wallpaper, and output settings once for the whole batch. Parameters and clear prose still skip questions. Resolve auto and source per image because orientations may differ. Before execution, state the input count, shared settings, per-image exceptions, and total expected output count.
6. Treat every source as a logically isolated generation job: read the source brief afresh, construct its prompt independently, and never carry another image's content, inferred meaning, wording, prompt, anchor, or result into it. Wallpaper anchors belong only to their own source.
7. --text prompt generates source-grounded wording independently for each image. --text none applies to all images. A single --copy deliberately applies the same exact text to every image; when exact text differs, accept an explicit relative-path-or-filename → exact-text mapping and verify every intended source before generation. Never reuse one mapped caption for another source.
8. A failed source or asset must be named and reported without silently dropping later queue items. Apply the normal single-asset retry rule only to the failed output, continue with the remaining queue, and finish with succeeded/failed counts and paths.

One batch invocation is one physical task directory even though its queue items are logically isolated. Do not create a task directory per source.

Capability-adaptive preflight

Do not switch the user's session into Plan mode merely to obtain a question UI. A Skill describes behaviour but cannot create UI capabilities that the host has not exposed. Detect the actual question-tool schema and follow this order:

1. Real multi-select tool available — for example Claude Code AskUserQuestion with multiSelect: true: use genuine checkbox questions for modes and sizes. Use single-select questions for text mode and wallpaper relationship. Do not print a redundant numbered menu after showing the form.
   • First form: modes (top-bottom, left-right, design-only, wallpaper-pack) with multiSelect: true; size route (自动适配, 跟随原图, 常用比例, 自定义) with multi-select enabled when the host permits combined size sources; text mode as single-select.
   • When 常用比例 is selected, show real checkbox groups for all concrete ratios, split only as required by host option limits: square 1:1; portrait 3:4, 4:5, 2:3, 9:16, 5:7; landscape 4:3, 5:4, 3:2, 16:9, 21:9, 7:5. Accumulate selections across groups. When 自定义 is selected, collect one or more ratios or exact pixel targets through the host's free-input/Other path.
   • If wallpaper is selected, ask linked versus independent as a genuine single-select. Ask only unresolved questions and respect answers already present in prose or parameters.
2. Only a mutually exclusive question tool is available — for example Codex request_user_input: use it only for genuinely single-choice fields such as text mode, wallpaper relationship, or the size-entry route. Never represent modes or concrete sizes as a single-select when the user may choose several. Collect those multi-value fields with the two-round combination input below. Do not claim that a single-choice card is a checkbox.
3. No interactive question tool is available: use the same two-round combination input below. It is typed multi-value input, not a clickable form. Never draw Markdown - [ ] boxes or other fake controls.

Inline parameters and clear natural language always take priority. Skip every field already resolved. When all required values are present, skip every question and generate immediately.

Two-round combination-input fallback

First round — modes. This is a typed combination question, so label it honestly instead of calling it a checkbox:

请选择一个或多个成品类型：

1. 上下对照（原图在上，019 设计在下）
2. 左右对照（原图在左，019 设计在右）
3. 只要设计图（原图仅作参考，不出现在成品中）
4. 四端壁纸（手机、iPad、电脑、儿童手表）

可回复：1｜1+3｜2、4｜全部

Second round — when at least one ordinary mode is selected, ask size route and text mode together. If the selection contains only wallpaper-pack, skip the ordinary-size part and resolve text plus device sizes and wallpaper relationship.

请选择尺寸，可多选：

1. 智能推荐（显示本次计算出的比例与像素）
2. 跟随原图
3. 常用比例（可直接写 3:4、9:16 等一个或多个比例）
4. 自定义（输入一个或多个比例／准确像素）

请选择文字方式：

A. 模型根据原始提示词生成文字（注明语言或地区）
B. 使用我的准确文字（发送原文并注明语言或地区）
C. 不要文字

可回复：尺寸 1＋9:16；文字 A，日语
可回复：尺寸 3:4、16:9；文字 B，准确文字「……」，简体中文

If the user answers only 常用比例, show the grouped library once and accept any combination:

方形：1:1
竖版：3:4、4:5、2:3、9:16、5:7
横版：4:3、5:4、3:2、16:9、21:9、7:5
也可以直接输入准确像素。

Do not decide wording outside the source brief. For option A, provide only the target language to the image model; the image model follows the source brief's existing text logic. For option B, pass the user's characters verbatim and add no other copy. For option C, prohibit all visible text and pseudo-text.

Do not infer language or market from a person's appearance, name, clothing, scene, filename, metadata, signage, or the language used to operate the Skill. Resolve it explicitly whenever text is requested. Use natural target-language shaping, direction, punctuation, spacing, and line breaking. For Arabic, preserve connected forms and right-to-left text flow without indiscriminately mirroring the artwork.

If wallpaper-pack is selected, ask one additional single-choice question unless resolved:

四端壁纸采用哪种关系？

1. 连贯套装：先生成并确认一张定调图，其余三张参考原图＋定调图独立重构
2. 四张独立：四张都只参考原图，各自构图

Neither option crops or mechanically resizes one wallpaper into the other devices. Use the common device preset above unless the user supplies labelled device sizes. Ordinary-size choices do not multiply wallpaper outputs.

Size resolution

• No silent default ratio exists.
• For auto, recommend a whole-canvas ratio from the source orientation, selected mode, source brief and intended use, then show the resolved ratio and pixels. Do not derive panel boxes or crop coordinates; the image model composes the selected relationship inside that canvas.
• source means the source photograph's aspect for the whole requested ordinary output.
• Exact pixels override a ratio.
• Every distinct aspect ratio is a separate complete-canvas composition from the same source and the same verbatim style brief. Never crop one ratio from another. Multiple resolutions sharing one aspect may be exported from the highest-quality approved composition.
• A size set applies to every selected ordinary mode unless the user maps sizes per mode.
• Before generation, state the resolved modes, concrete sizes, text mode and locale, wallpaper relationship if relevant, and total output count. Do not ask for another confirmation when they are complete and consistent.

Build the generation prompt

For each distinct asset, concatenate exactly:

[VERBATIM SOURCE-BRIEF BODY FROM references/original-prompt/zh-CN.md,
EXCLUDING ONLY ITS ADMINISTRATIVE FIRST MARKDOWN HEADING]

[COMMON DELIVERY PREAMBLE]
[EXACTLY ONE SELECTED MODE BLOCK]
[EXACTLY ONE TEXT BLOCK]
[USER'S OTHER EXPLICIT REQUIREMENTS, IF ANY]

Use this common preamble:

MODE-SPECIFIC DELIVERY OVERRIDE — CURRENT ASSET

This block is the final authority only for the current presentation mode,
reality-source visibility, final canvas and device delivery. It completely
replaces the source brief's legacy statements about 3:4, upper/lower placement,
equal sections and the old top-bottom container.

Every source-brief instruction about the transformation's visual language,
subject identity, colour, material, texture, internal composition, whitespace,
text character and typography remains authoritative.

REALITY VIEW means the faithful photograph or factual scene defined by the source brief.
TRANSFORMED DESIGN means the source brief's designed reinterpretation of that reality view.

FINAL CANVAS: <resolved ratio and/or exact WIDTHxHEIGHT>
COMPOSITION METHOD: ONE COHERENT COMPLETE-CANVAS GENERATION
EXACT PANEL GEOMETRY: ONLY WHEN THE USER EXPLICITLY REQUESTS IT

Colour follows the original brief's existing colour instructions exactly.
Unless the user explicitly requests a colour change, do not add, replace,
summarize, or re-plan any palette.

Append exactly one of these mode blocks; do not include the other three.

Top-bottom:

OUTPUT MODE: TOP_BOTTOM

Create one complete canvas whose dominant structure is two primary horizontal
parts: the REALITY VIEW above and the TRANSFORMED DESIGN below. Together they
organize the composition across its full width. Let the image model determine
their visual proportion and each part's internal crop, extension, whitespace
and typography from the source, source brief and final canvas.

Left-right:

OUTPUT MODE: LEFT_RIGHT

Create one complete canvas whose dominant structure is two primary vertical
parts: the REALITY VIEW on the left and the TRANSFORMED DESIGN on the right.
Together they organize the composition from the top edge to the bottom edge;
all visible material, including typography, belongs within this left-right
structure. Let the image model determine asymmetric widths and each part's
internal crop, extension, whitespace and typography from the source, source
brief and final canvas.

Design-only:

OUTPUT MODE: DESIGN_ONLY

Create one full-canvas artwork entirely in the TRANSFORMED DESIGN language.
Use the REALITY VIEW only as the non-visible source of identity, structure,
relationships, colour logic and facts. Every visible visual element must be
part of the source brief's designed reinterpretation rather than an
untransformed presentation of the source photograph.

Wallpaper pack — one block per device asset:

OUTPUT MODE: WALLPAPER_PACK
DEVICE PROFILE: <resolved PHONE, IPAD, DESKTOP or WATCH>
WALLPAPER RELATIONSHIP: <resolved INDEPENDENT or LINKED>

Create one full-canvas wallpaper for this device entirely in the TRANSFORMED
DESIGN language. Use the REALITY VIEW only as a non-visible reference. Recompose
the artwork for this device's canvas and usable screen space; every visible
element belongs to the designed result.

Append exactly one text block after the selected mode block. If the user has other explicit requirements, append those verbatim after the text block at the very end.

Prompt-generated text:

TEXT MODE: ORIGINAL_PROMPT_GENERATED
TEXT LANGUAGE: <resolved language or locale>

The image model must generate any wording by following the original brief's
existing text-generation logic. Every visible word must arise naturally from
the current source image's content, atmosphere or implied meaning as interpreted
through that logic. Anything presented as factual or documentary information
must come from user-supplied, visibly readable or otherwise verified source
facts; when those facts are unavailable, use poetic non-factual wording. The
runtime shell is never a source of visible copy.

User-exact text:

TEXT MODE: USER_EXACT
TEXT LANGUAGE: <resolved language or locale>
TEXT: 「<user's exact characters>」

Use the supplied text verbatim. Do not rewrite, translate, spell-correct, or add
any other wording. Typography and placement still follow the original brief.

Text-free:

TEXT MODE: NONE
Render no letters, characters, numbers, logos, captions, labels, or pseudo-text anywhere.

If the user explicitly changes colour or another style variable, append that exact request at the very end, after the text block, and identify it as a user override. Do not elaborate it.

Immediately before generation, verify that the constructed prompt contains exactly one OUTPUT MODE: line and no instructions from an unselected mode.

Bitmap execution

• Prefer GPT Image 2 whenever the host's built-in image capability or an already configured compatible route exposes it.
• Also support Seedance 5.0 Pro, Nano Banana Pro (Gemini Image Pro), Nano Banana 2 (Gemini Image Flash), or another compatible bitmap model only when it can preserve the reference, requested canvas, language, and multi-reference needs. Changing the model must not change this workflow or the prompt-authority boundary.
• Judge readiness by an actual image-capability check, not one missing tool or environment variable. Never name or expose a provider, endpoint, credential, header, account, route, or secret.
• If the built-in image tool is exposed, follow the installed imagegen Skill and make one generation/edit call per distinct asset. A wallpaper pack requires four outputs, not one contact sheet.
• If built-in generation is not exposed, run python3 scripts/configured_imagegen.py probe. Its sanitized result is the only allowed diagnostic surface. If ready, use edit with the source and a private prompt file; use generate only when no image reference genuinely exists.
• Do not echo a credential or full prompt in shell history or logs. Do not inspect configuration files manually. Do not modify provider, account, billing, credential, or global routing settings unless the user explicitly requests that separate change.
• If no compatible route is verified, ask the user to enable a suitable image tool or voluntarily provide an API key for the task. Never ask them to expose an existing secret, and never assert that a key is missing without a trusted sanitized result.
• Generate finished raster imagery. SVG, HTML, CSS, Canvas, diagrams, and programmatic vector drawing are not substitutes.

Use one complete-canvas generation per output. Give the image model the source, complete source-brief body, common preamble, one selected mode block, one text block and final canvas in one request; do not pre-crop the source or generate separate panels. The model decides how to preserve the important subject and context inside the selected mode contract. Retry a failed complete canvas once by restating only a meaningful failed content or delivery constraint. Use scripts/compose_panel.py only when the user explicitly requests pixel-exact panel geometry or pixel-identical source preservation. The script may crop/paste/size/audit raster files; it must never invent the artwork or judge style.

For a linked wallpaper pack, generate one device image first as the visual anchor, then supply both the original source and that approved anchor to each remaining device generation. Recompose each canvas; never crop an earlier wallpaper or chain derivatives. For an independent pack, every device sees only the original source.

Source and output isolation

Use only sources attached to the current invocation, explicit image paths, an explicitly supplied input directory, or a prior source explicitly identified by the user as “the same image.” Scan a directory only under the directory-batch rules above; never scan Desktop, workspace roots, output folders, or unrelated directories for a substitute. Historical outputs and sample assets are not inputs unless explicitly named.

Write every selected final PNG directly inside the fresh task directory. The task directory is the only grouping layer:

~/Desktop/xxd/xxd-panel-019/<fresh-task>/
├── source-001-photo-name-top-bottom-3x4-1536x2048.png
├── source-001-photo-name-left-right-3x2-2160x1440.png
├── source-001-photo-name-design-only-3x4-1536x2048.png
├── source-001-photo-name-wallpaper-linked-phone-1440x3200.png
├── source-001-photo-name-wallpaper-linked-ipad-2048x2732.png
├── source-001-photo-name-wallpaper-linked-desktop-3840x2160.png
└── source-001-photo-name-wallpaper-linked-watch-1024x1024.png

Use zero-padded source-order prefixes plus a sanitized source stem for multiple inputs, for example source-001-street and source-002-flower. Follow with the mode, then a collision-safe size label; include wallpaper relationship and device for wallpaper files. If different relative paths share a stem, retain enough path context or a short collision suffix to keep names unique. Normalize ratio separators to x in filenames and include exact output pixels whenever they help distinguish requested variants. Do not create source, mode, size, or device subdirectories, and do not create empty directories for unselected modes.

--out replaces the root but not fresh-task isolation. Reserve a collision-safe task name before generation. Do not create an automatic collage, overview, mockup, or combined preview. Return absolute PNG paths in source order, then mode order 1→4; wallpaper order is phone, iPad, desktop, watch.

Acceptance gate

Inspect every final PNG at full size and thumbnail size. Accept only when:

• it is a fresh result from the correct current source or theme;
• mode, source visibility, whole-canvas ratio or exact pixels, count, and PNG format match the resolved runtime variables;
• the source remains recognisable and its important subject and context are not needlessly truncated, stretched or replaced;
• top-bottom reads as two primary horizontal parts, with the reality view above and transformed design below, while leaving their exact proportions to the image model;
• left-right reads as two primary vertical parts that organize the canvas from top to bottom, with the reality view left and transformed design right; typography is integrated into that structure rather than becoming a shared third band;
• design-only and every wallpaper contain a full-canvas transformed design: the reality source remains reference material, and no visible area presents it as an untransformed source photograph;
• no seam detection, midpoint percentage, coordinate measurement, or fixed-crop audit is used unless the user explicitly requested exact geometry;
• the result follows references/original-prompt/zh-CN.md, especially its own colour, material, composition, whitespace, and typography requirements, without an outer Skill palette or added art direction;
• prompt-generated text uses the requested language, follows the source brief's own text logic and is meaningfully rooted in the current source image; anything that reads as factual or documentary information is traceable to supplied, visible or verified facts; user-exact text is verbatim with no additions; text-free output contains no text or pseudo-text;
• linked and independent wallpaper rules are respected;
• for a directory batch, every discovered source appears exactly once in the queue, all requested outputs stay inside the one batch task directory, and the final report accounts for every success and failure;
• no SVG/code-rendered substitute, watermark, UI, route information, or secret appears.

When a result fails, retry only the failed source-brief or runtime requirement. Do not “improve” it by introducing a new aesthetic theory.

Runtime adapters

• references/original-prompt/README.md — language index for the canonical original and four faithful reading translations
• references/runtime-preferences.md — safe cross-invocation reuse, edit, fresh-start, and opt-out contract
• references/xxd-panel-019-prompt.zh-CN.md
• references/xxd-panel-019-prompt.en.md

These files document the same minimal adapter. They never replace references/original-prompt/zh-CN.md.