comic-json-compiler
Phase-1 (S9, the FINAL comic-author step) — assemble the LOCKED storyboard + locked per-panel blueprints into ONE schema-valid `comic.json` (the comic-ir/1.0 contract boundary handed to comic-director / run_comic.py). Project the page_order + each panel's condition{} + render fields into `pages[]` + keyed `panels{}` per schemas/comic.schema.json; author ONLY authored fields and leave image_path/active_attempt_id/wiki_node_id EMPTY for the engine. THE step where page-count integrity is reconciled and the orphan-panel class of bug is caught (a panel defined in panels{} that no page references — ship that and the finale silently vanishes) — caught by an INLINE whole-comic reconcile this skill runs (page_refs vs panels{} keys vs the storyboard page_order), because the deterministic scripts are per-page and the schema leaves condition/content_svg OPTIONAL. Gated by comic-cross-layer-gate --gate compile (the DETERMINISTIC gate: both run_comic.py --dry-run AND cli/validate_wiki.py must exit 0
wanshuiyin · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add wanshuiyin/ARIS-Movie-Director --skill comic-json-compiler技能说明
name: comic-json-compiler
description: "Phase-1 (S9, the FINAL comic-author step) — assemble the LOCKED storyboard + locked per-panel blueprints into ONE schema-valid comic.json (the comic-ir/1.0 contract boundary handed to comic-director / run_comic.py). Project the page_order + each panel's condition{} + render fields into pages[] + keyed panels{} per schemas/comic.schema.json; author ONLY authored fields and leave image_path/active_attempt_id/wiki_node_id EMPTY for the engine. THE step where page-count integrity is reconciled and the orphan-panel class of bug is caught (a panel defined in panels{} that no page references — ship that and the finale silently vanishes) — caught by an INLINE whole-comic reconcile this skill runs (page_refs vs panels{} keys vs the storyboard page_order), because the deterministic scripts are per-page and the schema leaves condition/content_svg OPTIONAL. Gated by comic-cross-layer-gate --gate compile (the DETERMINISTIC gate: both run_comic.py --dry-run AND cli/validate_wiki.py must exit 0). Use when the user says '编译 comic.json', 'compile the comic', 'assemble comic.json', '出 comic.json', or the storyboard + all blueprints are locked and you need the single IR to hand to Phase 2/3. Do NOT use to author the page order (that is comic-storyboard-creator) or to bake panels (that is comic-director)."
comic-json-compiler — locked storyboard + blueprints → one schema-valid comic.json (S9)
The last node of the left third of Figure 1: take the locked storyboard_spec (the authoritative page
order + the MOTIF STATE TABLE) and the locked per-panel blueprint nodes and compile them into the single
comic.json (comic-ir/1.0) that is the contract boundary to comic-director
(Phase 2/3). You don't hand-write this file panel-by-panel — that already happened upstream; this step is the
deterministic projection + reconciliation that turns the authoring nodes into the IR and catches the
integrity bugs that only show up once everything is assembled — chiefly the page-count / orphan-panel
mismatch (the orphan-panel class). The two deterministic scripts the compile gate runs are
per-page (run_comic.py needs --page/--panels) and the JSON schema leaves condition/content_svg
OPTIONAL — so neither of them sees the whole pages[]/panels{} set and neither catches an orphan. That
whole-comic reconciliation against the storyboard authority is THIS skill's own inline job (the ~7-line set
diff below), run before the gate; the gate then certifies the per-page + wiki-conformance floor.
locked storyboard_spec (page_order = AUTHORITY) ┐
locked motif_ledger (per-panel ground-truth) │
locked panel_spec × N (the 9-field specs) ├─▶ ① ASSEMBLE pages[] + panels{} per comic.schema.json
locked blueprint × N (content_svg + expected_literals) │ (author ONLY authored fields; engine fields EMPTY)
locked prompt_bundle × N (optional, identity refs) ┘ ▼
② RECONCILE page-count integrity ── INLINE python (this skill; no phantom script)
(orphans · dangling refs · page_count vs page_order · grid2x2==4 · recap legitimacy)
▼
③ VALIDATE jsonschema(comic.schema.json) — SHAPE only (it does NOT enforce content_svg/literals)
▼
④ FAIL-CLOSED contracts (every panel a content_svg · baked figure ⇒ expected_literals) ← THIS skill asserts; schema won't
▼
⑤ comic-cross-layer-gate decision:compile_<slug> --gate compile (DETERMINISTIC: run_comic.py --dry-run per page AND cli/validate_wiki.py both exit 0)
▼
approve? ─ revise ─▶ fix the OFFENDING node upstream, recompile (you don't invent content)
│ approve
▼
⑥ EMIT comic.json (output-versioning) + movie.project.json pointer-hub + asset-copy manifest
Constants
- CONTRACT BOUNDARY =
comic.json(comic-ir/1.0) + the assets it references. Everything downstream (comic-director,run_comic.py, the Phase-3 viewer buildpackages/viewer/build_comic.py) reads ONLY this file + its assets — so a bug that survives this step survives to production. - AUTHORITY = the storyboard's
page_order. When the assembledcomic.jsonpage set disagrees with the lockedstoryboard_spec.page_order, the storyboard wins — the compiler conforms, it does NOT silently ship its own page count. (This is the converse of the storyboard gate's page-order veto.) - GATE =
comic-cross-layer-gate decision:compile_<slug> --gate compile(the target is the real wikidecisionnode this skill writes — there is NOcomicnode type andcomic.jsonis not a wiki node, so it can never be a gate target or an edge endpoint). Percomic-cross-layer-gatethecompilegate is purely DETERMINISTIC: NOreview:*fan-out, NO Codex adjudication (so unlike every other gate, the "create review nodes first" pre-step does NOT apply here). It PASSES (approve) iff BOTH on-disk scripts exit 0: `python3 skills/comic-director/scripts/run_comic.py --project --page --panels --d