name: xxg-portrait-rebuild-light description: "Edit an existing JPG, JPEG, PNG, or WebP portrait with concise director-style relighting and clean photographic skin texture while preserving identity, natural facial asymmetry, facial proportions, expression, composition, and source framing. Use for 真实肤质、去塑料感、光影重建、人物补光、逆光修复、自然窗光、窗影、树影、柔焦光斑、黄金时刻、霓虹光、摄影棚柔光、暗调写真、主体全黑剪影, relight, silhouette, or Higgsfield-Relight-like requests. Discover the host image-edit tool first; in Codex prefer image_gen__imagegen and pass local sources with referenced_image_paths. Never guess image_gen or input_image, never modify the delivered photo with local pixel scripts, and never refuse solely because the face is small or the scene is complex."

XXG 人像真实光影重建

目标

把输入照片视为同一张摄影原片，对其做一次明确、克制的 image edit：

• 保持同一人物、原有面部结构、自然不对称、表情、姿势、镜头与构图；
• 重新组织主光、补光、阴影和背景氛围，使光线具有真实方向与空间响应；
• 把塑料般平滑的皮肤恢复为干净、健康、低对比的相机微纹理；
• 让变化在正常观看下可辨，但不靠改脸、颗粒、色差或粗糙处理制造效果。

光源物理效果优先于“所有内容都清楚”。根据光位与曝光意图，允许受光面明亮、背光面深暗、局部高光自然溢出、暗部接近黑色或主体形成合理剪影；不得用统一补光把逆光、低调或硬光重新抹平成平均曝光。

先调用宿主原生图片能力

取得源图后，先读取当前智能体原生图片生成 Skill 的规则，再从当前工具注册表发现真实 callable。默认使用宿主自己的 image edit 能力，不直接拼装 API、CLI、SDK 或模型端点。

Codex 精确调用

在 functions.exec 中先检查 ALL_TOOLS：

const candidates = ALL_TOOLS.filter(({ name, description }) => {
  const text = `${name} ${description || ""}`.toLowerCase();
  return name === "image_gen__imagegen" ||
    (text.includes("image") && (text.includes("generate") || text.includes("edit")));
});
const selected = candidates.find(({ name }) => name === "image_gen__imagegen");

发现 image_gen__imagegen 后，本地源图编辑只能使用：

const result = await tools.image_gen__imagegen({
  referenced_image_paths: ["/absolute/path/to/source.png"],
  prompt: "紧凑的四行 image edit 提示词"
});
generatedImage(result);

禁止调用未经发现确认的 tools.image_gen，禁止猜测 input_image。错误函数名、错误参数或 JavaScript TypeError 属于调度错误；重新发现并按真实签名调用，不能据此声称工具不可用。

Claude、OpenClaw 和其他智能体调用它们工具注册表中明确暴露的等价原生图片编辑动作。

不拒绝，按真实状态分流

• 发现兼容图片工具：必须调用；面部较小、复杂背景、文字、商品或主体触边只降低微纹理强度，不停止生成。
• 正确图片工具真实调用失败：说明真实错误，进入 prompt-only，直接给出紧凑完整提示词。
• 工具发现完成且确实没有兼容 callable：进入 invocation-handoff，直接给出紧凑完整提示词。
• 已生成但近乎原图、改脸、脏化或目标光影失败：说明“本次图片结果未达到目标改善”，进入 prompt-handoff，从原图重组紧凑完整提示词。

读取 Skill、查看图片、生成审计文件或输出“正在调用”都不等于已经调用图片工具。

禁止本地制作成片

不得使用 Pillow、NumPy、OpenCV、ImageMagick、FFmpeg、sips 或自写脚本为交付图片补光、调色、磨皮、锐化、加纹理、裁切、扩边、缩放、合成或修复。它们只可用于只读宽高比检查、蒙版验证和结果审计，不能冒充 image edit。

依赖记录在根目录 requirements.txt。运行只读脚本前，从当前 SKILL.md 解析绝对 Skill 根目录；不得假设当前工作目录。

导演式光影决策

生成提示之前先在内部决定七项，不把分析过程或候选方案全部塞入提示词：

1. Key：主光来自哪里，是柔光、硬光、侧光还是逆光；
2. Exposure intent：选择平衡曝光、高光优先、阴影优先、低调、剪影或高调；
3. Fill：决定无补光、环境反射或明确补光；不得默认补亮所有暗部；
4. Shadow：决定阴影硬度、深度、过渡宽度以及是否允许接近黑色；
5. Subject：光如何跨过额头、眼周、鼻梁、面颊、颈肩与衣物；
6. Background：背景亮度、反射和色温如何响应同一光源；
7. Atmosphere：最多选择一种窗影、树影、柔焦光斑、夕阳光晕、轻微体积光或 A6 主体全黑剪影。

选择配方时读取 光影、皮肤、色温与氛围配方。每次只选：

一个 L 主光 + 一个 S 皮肤 + 一个 T 色温 + 零个或一个 A 氛围

不要同时堆叠柔窗光、伦勃朗光、硬光束、霓虹和夕阳。氛围效果必须服从主光，不可只贴在脸上。

A6 是强制覆盖项，不是普通叠加效果。只要配方包含 A6，立即把曝光意图设为 silhouette，把有效主光置于人物后方，取消正面/侧面 Fill、眼神光和人物内部受光；脸、皮肤、头发、衣物与身体内部统一压成干净全黑，仅由明亮背景或背后光源显出原人物的完整外轮廓与姿态。此时 A6 覆盖 L 中关于人物正面受光的描述，S 只保留为配方记录、不要求纹理可见，T 只控制背景与轮廓附近光色。

紧凑提示词协议

图片模型的实际提示词不是审计报告。读取 紧凑提示词编译器，严格压缩为四行：

编辑：同一人物与原构图，只重建光影和肤质。
光影：主光 + 曝光意图 + 补光/阴影策略 + 背景响应 + 可选单一氛围。
肤质：与面部尺度匹配的干净、低对比真实微纹理。
限制：4–6 个最高风险禁止项；目标变化必须可辨。

执行规则：

• 默认 120–220 个中文字符；复杂场景也不得超过 320 个中文字符；
• 身份与结构只锁定一次，不重复列举同义约束；
• 不逐项抄写整份场景审计，只点名最多三类最高风险保护对象；
• 正向目标优先，负向限制只保留换脸、磨皮、颗粒/脏化、背景重绘等核心风险；
• 不使用“最小变化、完全不变、尽量不改、低强度”反复压制目标；
• 不把 L/S/T/A 编号写进图片提示正文；
• 失败重试时替换失败句，不在旧提示后继续追加约束。

invocation-handoff、prompt-only 和 prompt-handoff 输出的提示词也遵守同一长度与四行结构；必须无占位符，但不展开成长篇清单。

身份与可变范围

保持人物身份、脸型轮廓、头脸比例、五官位置与大小、自然轻微不对称、表情、视线、发际线、姿势、相机视角、构图和原画幅。不要“完美对称化”、瘦脸、大眼、缩鼻、丰唇或重塑身体。

选择 A6 时，内部五官会按授权消失在黑色剪影中；改用头部与发型外轮廓、肩颈关系、身体比例、姿态和人物占画位置判断结构保持，不得借剪影重塑轮廓或姿势。

这些结构约束不等于原样复制。允许以下外观按目标光源发生明显变化：

• 面部、耳、颈肩与可见皮肤的连续亮度、柔和阴影和镜面反射；
• 头发、衣物及邻近背景的同源高光、投影和环境反射；
• 皮肤的低对比微纹理与原有唇纹、眼周层次；
• 用户指定的窗影、树影、Bokeh、夕阳侧光、霓虹或光束。

干净真实肤质

正常观看时先看到干净、柔和、健康的皮肤；合理放大后才看到微纹理。

选择 A6 时，本节的肤质可见性要求暂停：所有可见皮肤必须与头发、衣物和身体一起落为均匀干净的黑色剪影，不显示肤色、毛孔、唇纹、眼周细节、妆面、眼神光或局部面光；这不算塑料皮或肤质失败。

• 低频：保持原肤色基准与脸、耳、颈、上胸、锁骨的连续性，不漂白、不斑驳；
• 中频：立体感来自宽缓受光渐变、自然遮挡与环境反射，不靠加深眼袋、法令纹、鼻翼沟、嘴角或颈纹；
• 高频：毛孔、绒毛、浅细纹和唇纹低对比、低密度、不重复，服从曲率、景深和光向；
• 黑头、痣、雀斑、卡粉、浮粉默认只保留源图已有内容，不为了“真实”主动制造污点、粉屑或干裂。

面部高度建议：

• <256 px：使用 S0，不新增毛孔、黑头、绒毛或细纹；光影仍按用户目标清楚重建；
• 256–511 px：使用 S1，只做克制微纹理；
• ≥512 px：可用 S2，保留分区微纹理，但禁止超清毛孔和颗粒锐化。

细腻胶片颗粒只在用户明确要求杂志或电影胶片感时作为全画面极轻的统一成像特征；不能只加在皮肤上，也不能代替毛孔。

物理光影边界

• catchlight in eyes：只在需要时添加一处与主光方向一致的眼神光；已有眼神光时优先保持，禁止双重眼神光。
• subtle fill light：只在曝光意图需要暗部可读时使用；剪影、低调或高光优先曝光可完全不用补光。
• ambient occlusion：只用于极轻的接触阴影和空间贴合，不能充当补光，也不能加深眼下或法令纹。
• 窗影、树影：必须跨过人物和邻近环境表面连续变化，边缘软硬与光源距离一致。
• Bokeh：只存在于景深允许的背景或前景离焦区，不覆盖眼睛、皮肤与关键轮廓。
• 光束/丁达尔：只有方向和介质合理时使用，保持轻微，不用烟雾遮盖人物。
• 黄金时刻：优先保留夕阳高光、侧逆光和轮廓光；背光面可深暗或成为局部剪影，只有用户要求看清面部时才加低强度环境补光。
• 低调与硬光：允许大面积深暗、接近黑色的阴影和少量高光溢出，只要边缘、落点和空间关系真实；深暗不等于脏灰。
• 霓虹：青/洋红两侧光必须有清楚方向和亮度主次；未受光区域可以深暗，不能为了看清全脸而加入无来源白色补光。
• 皮肤微纹理只要求在有效受光区域自然可见；处于剪影或深暗中的皮肤不必保留同等细节可见度。
• A6 主体全黑剪影：优先级高于 L 的人物受光、Fill、catchlight 与 S 的肤质可见性；人物内部不得残留脸部、肤色、发丝、衣纹或饰品明暗细节，只允许极窄同源轮廓溢光且不能进入人物内部。

输出画幅

要求保持输入构图、方向、宽高比和人物占画比例，不要求输出像素尺寸与原图一致。允许图片后端因最大分辨率限制等比例缩小，也允许边长取整造成轻微比例偏差。

有本地结果文件时只运行：

python3 "$XXG_SKILL_DIR/scripts/check_aspect_ratio.py" SOURCE_IMAGE EDITED_IMAGE

默认相对宽高比偏差不超过 5% 即通过。不要比较或强制恢复原始 W × H，不要因为输出分辨率较小判失败，也不要用本地脚本放大、缩放、裁切或补边。只有明显拉伸、改变方向、裁切/扩图导致比例超差，或人物占画位置发生明显变化时才进入 prompt-handoff。

生成后验收

按正常观看倍率先检查：

1. 用户指定的主光方向、明暗关系或氛围效果是否直接可辨；
2. 人物是否仍为同一身份，五官、表情、姿势和构图是否稳定；A6 改查头发/头部外轮廓、头身比例、姿势和构图，不要求黑色内部五官可见；
3. 主体、衣物和背景是否服从同一组光源与曝光意图；
4. 皮肤是否干净连续、无塑料感，也无颗粒、色斑、脏灰与假立体；A6 改查人物内部是否完整、连续、干净地落为黑色；
5. 窗影、树影、Bokeh、霓虹或光束是否具有物理落点，而非后期贴纸；
6. 深暗、剪影或高光溢出是否由选定光位自然产生，而非被错误判成必须补亮的缺陷；A6 若仍可见面光、肤色、眼神光或衣物内部细节则判失败；
7. 输出方向、宽高比、构图和人物占画比例是否合理；等比例缩小本身不是失败。

结果近乎原图时，不再增加一串同义限制；改为加强唯一主光句和一个可观察目标。结果脏化时，删除颗粒、强对比、深邃皱褶等词，并替换为“干净连续肤色 + 低对比反射微纹理”。

参考文件

• 紧凑提示词编译器
• 光影、皮肤、色温与氛围配方
• 后端能力与干净真实感
• 身份与细节审计
• 局部编辑计划与保护规则

English | 简体中文 | 日本語 | 한국어

xxg-portrait-rebuild-light is an image-edit skill for existing portrait photos. It reconstructs the key light, fill, shadows, and background atmosphere with a director-led lighting workflow while restoring clean, healthy, low-contrast photographic skin microtexture.

The skill changes the lighting without redrawing the person. It preserves identity, facial structure and proportions, natural slight asymmetry, expression, pose, camera view, and composition. It avoids plastic skin, grainy skin, dirty color variation, and fake depth made by exaggerating wrinkles.

Key features

• Repairs plastic smoothness, excessive skin smoothing, and wax-like rendering.
• Preserves original lip lines, eye-area detail, restrained sebum highlights, and scale-appropriate microtexture.
• Repairs weak backlighting, disconnected indoor window light, flat lighting, unintended crushed shadows, and highlights with no physical source.
• Supports soft window light, commercial soft light, Rembrandt lighting, cinematic low-key lighting, golden hour, dual-color neon, and diagonal hard light.
• Adds at most one physically coherent atmosphere effect: window shadow, tree shadow, background bokeh, sunset flare, subtle volumetric light, or a full-black backlit subject silhouette.
• Controls subject and background in layers: key light and exposure intent first, then fill, shadows, ambient light, and color temperature.
• Preserves identity, facial feature size and position, expression, pose, wardrobe, background structure, and source framing.
• Reduces the skin-detail target automatically when the face is small, without canceling the requested lighting change.
• Uses the current agent's own image-generation or image-editing capability by default; no separate API is required.
• If the current agent has no image-edit capability, or the edit misses the target, returns one complete compact image-edit prompt.
• Never uses Pillow, NumPy, OpenCV, ImageMagick, or temporary filter scripts to produce the delivered image.

Core method

The skill first makes a director-style lighting decision internally:

Key light → Exposure intent → Fill → Shadow → Subject → Background → Atmosphere

The prompt sent to the image model is compressed into four lines, usually 80–160 English words:

Edit: keep the same person and composition; rebuild only lighting and skin rendering.
Lighting: one key light + exposure intent + fill/shadow relation + background response + optional single atmosphere effect.
Skin: clean, low-contrast photographic microtexture appropriate to the visible face scale.
Constraints: no identity change, beauty reshaping, smoothing, grain overlay, dirty color variation, or background redraw.

The skill does not pile identity audits, object inventories, repeated negatives, and several photographic styles into one prompt. That often causes constraints to cancel each other or produces an unchanged copy.

Physical lighting takes priority over keeping every detail visible. The skill selects an exposure intent from source-matched, balanced, highlight-priority, shadow-priority, low-key, silhouette, and high-key. Sunset backlight may naturally darken the unlit side of the face or create a partial silhouette. Low-key and hard lighting may contain near-black shadows. Fill is used only when information that should remain readable is lost without a plausible cause.

A6 is a forced override: whenever selected, it switches to silhouette exposure, moves the effective light behind the person, removes all fill and catchlights, and renders the entire subject interior black. The selected L and T recipes control only the backlight and background response; the S recipe is not rendered visibly.

Recipes

Choose only:

one L lighting recipe + one S skin recipe + one T color-temperature recipe + zero or one A atmosphere recipe

Lighting L

Skin S

Color temperature T

Atmosphere A

See Lighting, skin, color-temperature, and atmosphere recipes for detailed prompt clauses.

Image capabilities by agent

In Codex, the skill never guesses tools.image_gen or input_image. It returns a prompt handoff only after tool discovery confirms that no compatible image capability exists. If the real image tool fails, produces an almost unchanged image, changes identity, or dirties the skin, the skill also returns a short copy-ready prompt.

Requirements

• An agent that supports directory-based SKILL.md skills.
• An image-generation or image-editing capability in the current agent.
• Python 3.9 or newer, used only for read-only aspect-ratio, mask, and region checks.
• Pillow 9.1 or newer, used only for read-only analysis and never to create the final image.

Install the read-only script dependencies:

python3 -m pip install -r ./xxg-portrait-rebuild-light/requirements.txt

Install in Codex

Personal skill:

mkdir -p ~/.codex/skills
cp -R ./xxg-portrait-rebuild-light ~/.codex/skills/

Shared Agent Skills directory:

mkdir -p ~/.agents/skills
cp -R ./xxg-portrait-rebuild-light ~/.agents/skills/

For a project-level install, place it in .agents/skills/ at the project root. Invoke it explicitly with $xxg-portrait-rebuild-light.

Install in Claude Code

Personal install:

mkdir -p ~/.claude/skills
cp -R ./xxg-portrait-rebuild-light ~/.claude/skills/

Project install:

mkdir -p .claude/skills
cp -R ./xxg-portrait-rebuild-light .claude/skills/

Invoke it with /xxg-portrait-rebuild-light.

Install in OpenClaw

Local install:

openclaw skills install ./xxg-portrait-rebuild-light \
  --as xxg-portrait-rebuild-light

Shared install:

openclaw skills install ./xxg-portrait-rebuild-light \
  --as xxg-portrait-rebuild-light \
  --global

You can also copy the complete directory into the current agent workspace's skills/ directory or the shared ~/.openclaw/skills/ directory.

Install in other agents

Copy the complete xxg-portrait-rebuild-light/ directory into the agent's personal or project skill root. Preserve the relative structure of SKILL.md, requirements.txt, references/, scripts/, and agents/, then reload the skill list.

Usage examples

Classic fashion editorial

Use $xxg-portrait-rebuild-light to edit this portrait with L8 + S2 + T1 + A0.
A large soft key from the upper front-side creates restrained Rembrandt lighting; subtle fill preserves the eye socket, one cheek falls into a deep soft shadow, and the eyes receive