comic-asset-ref-generator
Phase-1 (S4) of a comic movie — PRODUCE the canonical reusable references the whole spiral conditions on. Per asset it bakes ONE canonical 1:1 white-bg identity ref via the agent mcp__codex__codex sidecar bake (Codex native image_gen — conditioned, never hand-pasted) OR, for a deterministic motif (clock/chart/stamp/star-map), emits a single-source parametric SVG from a python generator (asset_lib.py). Hashes + base64-encodes the bake into the asset node's output_ref (all 6 fields or it's a schema violation), versions every ref _v{NNN} with a supersedes self-edge, and runs a single-source collision gate. GENERATES ONLY — it NEVER self-locks/approves (that is the cross-model asset-review-loop's job, a different model family). Identity is BRING-YOUR-OWN; the ARIS chibi duo is only the worked example.
wanshuiyin · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add wanshuiyin/ARIS-Movie-Director --skill comic-asset-ref-generator技能说明
name: comic-asset-ref-generator description: "Phase-1 (S4) of a comic movie — PRODUCE the canonical reusable references the whole spiral conditions on. Per asset it bakes ONE canonical 1:1 white-bg identity ref via the agent mcp__codex__codex sidecar bake (Codex native image_gen — conditioned, never hand-pasted) OR, for a deterministic motif (clock/chart/stamp/star-map), emits a single-source parametric SVG from a python generator (asset_lib.py). Hashes + base64-encodes the bake into the asset node's output_ref (all 6 fields or it's a schema violation), versions every ref _v{NNN} with a supersedes self-edge, and runs a single-source collision gate. GENERATES ONLY — it NEVER self-locks/approves (that is the cross-model asset-review-loop's job, a different model family). Identity is BRING-YOUR-OWN; the ARIS chibi duo is only the worked example." argument-hint: [asset_id | --batch-from-outline <outline_id> | --regenerate <asset_id> --reason ""] allowed-tools: Bash(*), Read, Write, Edit, Grep, Glob, mcp__codex__codex, mcp__codex__codex-reply
comic-asset-ref-generator — the Reference Producer (Phase 1 · S4)
The missing Layer-2 of comic-author: take the storyboard's consolidated ASSET_REQUESTS and produce, for
every declared asset, the one canonical artifact that every downstream panel bake will condition on —
so the film never grows two visual dialects and every panel of the same character/prop/motif reads as the same
thing. This is precisely the producer of comic.json's identity_refs (e.g. duo_canonical_ref_v001.png +
per-character locks like executor.hoodie #1D4684 / reviewer.beard true) that the proven comic created by
hand. It is the upstream sibling of comic-blueprint-author (which
authors per-panel content-SVGs) and feeds comic-asset-review-loop and
the comic-director spiral.
Two asset classes, two production routes — this is the load-bearing fork:
storyboard.consolidated_asset_requests
├── identity / scene / prop ──▶ RASTER ref: agent mcp__codex__codex sidecar bake, CONDITIONED on a labeled white-bg
│ (a face, a hoodie, condition + real identity refs → 1:1 (or 16:9 scene) PNG
│ an empty room) → output_ref{file_path,data_url,sha256,width,height,mime} (ALL 6)
│
└── deterministic motif ──▶ SVG SOURCE: ONE parametric builder in asset_lib.py
(clock / chart / stamp (ddl_chip / stamp / mug / curve_panel / tokyo_chip / starmap …)
/ mug / star-map) the "ref" IS the single-source SVG — NOT an image bake
→ records generator_script, owner_script, file_sha256
both routes → review_status:"pending" (NEVER "locked" here) → collision gate → asset-review-loop
The battle lesson, landed as the fork above: a clock, a chart, a verdict stamp, a star-map is deterministic
content — you do NOT bake it as a fuzzy image and hope the digits land; you build it once from a python
generator (asset_lib.py) so all 18 instances of the DDL timeline, all 7 verdict stamps, both the labeled and
the wordless star-map render from the same coordinates and never diverge. An identity (a face, a costume) is
not deterministic — that you bake once via the sidecar bake (Codex's native image tool), conditioned on a
labeled white-bg reference and the real identity refs, never a free prompt, never a hand-paste.
Constants
- GENERATOR (raster route) = the agent's
mcp__codex__codexsidecar bake:model: "gpt-5.5",config{ model_reasoning_effort: "xhigh", include_image_gen_tool: true },sandbox: "workspace-write", plusapproval-policy: "never"— an mcp-call argument, NOT a.bakereq.jsonfield (the sidecar payload carries no such key). This exact shape is the empirical v3.5 lesson: withoutworkspace-write+approval=never+include_image_gen_tool=true, Codex falls back to writing descriptive text (or an SVG renderer) instead of firing its native image tool.image_genis incompatible withminimaleffort; the shipped bake runsxhigh— the samegpt-5.5 + xhighsingle compat default pinned inrun_comic.get_bake_plan()(contractbakereq/v1, the digest the p0_proof cert binds to; a config-driven model/effort override is planned, not yet implemented). Honest scope: this Phase-1 raster ASSET bake is paid and runs PRE-P0 — the p0_proof cert gates the Phase-2/3 PANEL bakes only (no cert can exist beforecomic.jsoncompiles, and assets must lock first); the gate on THIS spend is the cross-modelcomic-asset-review-loop+ the single-source collision gate (P5), not P0. NB the Codex CLI reviewers elsewhere in the pipeline pin no model (they follow the local codex config — currentlygpt-5.6-sol) at effortxhigh; only the bake payload pinsgpt-5.5. The authoritative bake reply is the.bakestatus.jsonsidecar ({status, failure_kind, mcp_output, request_id}— P2r step 3) + the native PNG on disk; codex is never asked to emit a JSON-line self-report (that was a retired codex-exec-era contract). - SVG SOURCE (deterministic route) = a pure-python parametric builder living in
gen/asset_lib.py, emitted by a thingen/gen_core_assets.pywriter. The palette is pinned tocomic.jsonui_tokens — never re-typed per asset. This route calls no image model and spends zero credits. - MAX_GEN_RETRIES = 2 (3 attempts total) — on
ok:falseOR a missing / zero-byte / invalid PNG (file <path>check). Append"[retry {n}: previous failure was: {reason}]"to the prompt each retry. - VERSIONING = monotonic 3-digit
_v{NNN}(duo_canonical_ref_v001.png,ddl_widget_template_v1.svg). Version only grows; the prior artifact stays on disk for t