novel-to-comic git:20261009.91c1409A

Immutable. This exact content never changes and is served at /api/v1/blob/b416544cbf74a5f5.

---
name: novel-to-comic
description: "将小说忠实改编为完整漫画：按原文章节逐章完成细节清单、详细剧本和逐格分镜，禁止过度概括、漏关键剧情或虚构；本卷汇总审查锁定后再制作，整页一次生成，手机单页1080×2400、单页限定3–4格纵排（常规3格、信息简单可4格）且字高可读，维护人物一致性、整页验收并导出。用于小说转漫画、续做和定向返修。"
---

# 通用小说转完整漫画

将用户实际提供的小说制作成可阅读的完整漫画。作品内容只写入作品项目，不把测试样例的人物、情节或世界观带入用户作品；tests/fixtures 中的原创短篇仅用于隔离验证。

## 规范权威来源映射（Source of Truth）

为避免规则分散与多处重复引发指令漂移，本项目各领域规范以对应权威文件为唯一准则：

| 规范领域 | 权威文件 | 核心职责 |
|---|---|---|
| **总览流程与快速指引** | `SKILL.md` | 全流程 SOP、各阶段核心原则与执行边界 |
| **命令行与流水线调用** | `scripts/comic_pipeline.py` & [commands.md](references/commands.md) | CLI 参数契约、环境检测、脚本命令与默认值 |
| **改编原则与三级证据** | [adaptation.md](references/adaptation.md) & [detail-records.md](references/detail-records.md) | 原著忠实度、视觉推断边界、章节细节契约与自校验 |
| **手机单页尺寸与可读性** | [phone-reading.md](references/phone-reading.md) | 1080×2400竖屏单页、纵排、建议字高、占屏与实际视口验收（字体验收放宽，字体大小仅为建议不作为卡点） |
| **分镜密度与整页规划** | [narrative-density.md](references/narrative-density.md) | 整章规模（不设上限）与单页成图（限定3–4格，常规3格，信息简单可4格）两层级规划 |
| **人物设定与美术基准** | [characters.md](references/characters.md) & [art-direction.md](references/art-direction.md) | 角色档案、视觉设计层级、风格定位与基准图登记 |
| **整页出图与气泡排版** | [production.md](references/production.md) | 一页一次调用、完整提示词打磨与原生对白气泡 |
| **质量关卡与双轨审查** | [quality.md](references/quality.md) | 机械门禁校验与人工语义/视觉审查双轨分离标准 |
| **任务委派与环境自适应** | [parallel-work.md](references/parallel-work.md) | 环境自适应委派机制、子代理模型对齐建议与双子代理审批权责边界 |
| **岗位角色与独立提示词库** | [roles/README.md](roles/README.md) & `roles/*.md` | 各岗位专属独立提示词（总导演及9大子代理）、单一角色严格注入与上下文物理隔离规范 |
| **数据结构与数据契约** | [schemas.md](references/schemas.md) | 全卷 `project.json` (Schema v6) 字段定义与数据契约 |
| **异常恢复与版本变更** | [recovery.md](references/recovery.md) | 流程中断恢复、版本分叉隔离与多轮返修处理 |
| **工程模板权威库** | `assets/templates/` (`book_docs/`, `volume_docs/`) | 项目顶层与分卷模块化 Markdown 说明文档模板 |

## 核心原则：忠实原著与改编推断边界

### 三级证据体系（Three-Tier Evidence Model）
为平衡小说文学叙事与漫画视听语言的媒介特征，防止将合理分镜误判为虚构，同时死守剧情真实性底线，实行三级证据分类：

1. **第一类：原文明示事实（Explicit Canonical Facts）——【严格忠实，必须有明确出处】**
   - 剧情事件走向、对白核心意义、角色发言态度、既定身份与人际关系、因果动机、情节揭示、原文明示的场景环境与关键道具。
   - **红线要求**：必须 100% 严格忠实原著，具备真实 `source_unit_ids` 绑定与精准原文短引句；严禁遗漏有效细节，严禁以概括跳过过程。
2. **第二类：视觉呈现选择（Visual Staging Choice）——【允许专业转译，标明视觉呈现】**
   - 为在画格中具象化第一类事实所需的分镜机位（景别/俯仰角度）、构图透视、分格节奏、肢体动作中间过渡、微表情神态、符合世界观的光影与环境细节。
   - **红线要求**：属于漫画转译的合理艺术推断，在分镜与细节记录中明确标明为“视觉呈现（visual staging）”。无需伪造逐字引句，但必须服从角色性格基调、情节氛围与美术规范，不得冲突或喧宾夺主。
3. **第三类：新增实体/情节/因果（Fabricated Canonical Elements）——【绝对禁止，一票否决】**
   - 小说中完全未发生的新事件、凭空捏造的感情线或平行冲突、改变故事走向的自创动机、与原作设定冲突的魔改剧情、无中生有的虚假对白。
   - **红线要求**：绝对严厉禁止。一旦发现，判定为 Major/Critical 缺陷，一票否决，绝不得锁定剧本或放行出图。

### README 与工程文档剧情描述零臆测
项目顶层 `README.md`、各卷 `README.md`、`docs/overview.md`（作品概述/故事梗概）、`docs/info.md`（本卷叙事焦点）等工程文档，凡涉及对剧情的描述与概括，必须完全严格摘自已阅读并核实的原文真实事件。尚未提供或未读到的后续分卷，严禁根据常识猜测、网络同名故事记忆或主观臆想编造任何剧情，统一如实标注“待后续原文输入后提取真实剧情”。

## 双轨质检体系：机械门禁与人工语义审查

必须在流程中严格区分**机械门禁通过**与**人工语义/视觉审查结论**：
- **机械门禁（Automated Gate）**：由辅助脚本校验 JSON 结构、字段合法性、SHA256 哈希、文件真实性及关联引用。机械通过仅代表数据结构闭环与可追溯，**绝不代表剧情未被遗漏，绝不代表模型实际精读了原文，绝不代表画面合格**。
- **人工语义与视觉审查（Semantic & Visual Review）**：主代理（或人工审阅人）必须亲自通读原文、核对分镜、审阅原图与排版。审查证据必须明确指向具体原文段落、具体画格 ID、角色对比基准和问题修订记录，严禁填写形式化虚假报告。

## 两层级分镜规划原则

- **层级一：整卷/整章叙事总规模（不设固定格数硬上限）**：默认完整细节改编，忠实覆盖全部有效原文，保留独立事件、人物弧线、因果、支线、伏笔、对白交锋与心理/情绪转折。**整章叙事总格数不设固定硬上限**。约 2,000 字中文章节常规参考 50–80 格（初始按约 60 格规划），交锋密集时 80–120 格或更多，事件较少时 30–50 格；绝不为了省页数过度概括，也绝不为了凑格虚构新情节。
- **层级二：单张成图与成品页规模（限定 3–4 格整宽纵排）**：针对手机竖屏沉浸阅读体验与 AI 画面原生像素质量，**单页漫画格数调整为 3~4 格，常规模式下 3 格，信息简单可以使用 4 格**；严禁单页少于 3 格（条漫节奏散漫或画格过少）或超过 4 格（单格过扁、面部模糊、对白拥挤），禁止双列小格或 2×2 网格。一章 60 格通常规划为 15–20 张成品页；一页对应一次生成调用，完整页内原生绘制所有镜头、边框与气泡，不建立独立画格图片。

## 手机单页尺寸与可读性规范

编剧、出图、排版和验收前读取 [phone-reading.md](references/phone-reading.md)。建议规格：画布 1080×2400（宽高比 9:20，高宽比建议 2.0–2.4），单页限定 3–4 格整宽纵排（常规 3 格，信息简单可 4 格）；正文建议字高 48–60 像素（360 宽视口建议约 16 CSS 像素，仅作为排版参考建议，字体验收放宽，字体大小不应成为卡点），清晰易读、画面自然饱满即可。页面 QA 记录 `phone_readability` 与逐页 `phone_reading_notes`。

## 不可跳过的制作顺序与独立卷原则

以当前卷为独立制作与锁定单位，不可跳过的标准制作顺序统一为：
**本卷原文归档 → 按章委派编剧子代理推进编写（读本章 → 细节清单 → 逐场详细剧本 → 逐格分镜 → 对照原文核查）→ 每五章阶段双子代理双轮审批与打磨整改（初审扣分挑刺-打磨修改-复审核销，杜绝一把过虚高） → 本卷汇总审查修订 → 本卷锁定 → 基准制作或继承 → 按章正文生成验收 → 排版 → 本卷交付。**

在有效剧本锁定前，不生成或编辑任何角色设定图、试画、样章、封面或正文图。不能以摘要、大纲、少量章节分镜替代本卷详细分镜剧本。

## 主代理定位：总导演与总制片人（严禁下场干活铁律）

- **总导演严格扮演与协调统筹（严禁肉身下场干活）**：主代理扮演总导演兼总制片人（Showrunner），严格遵循其专属提示词 [roles/lead_director.md](roles/lead_director.md)。**绝对禁止主代理下场干具体的活**（包括但不限于：严禁肉身精读写初稿分镜、**严禁亲自整改被驳回的不合格剧本**、严禁亲自编写出图提示词、严禁亲自调用绘图工具、严禁亲自填报整页 QA 报告、**严禁通过 Python 脚本批量合成伪造虚假审查报告**）。
- **指定严格扮演角色与单一提示词注入（上下文物理隔离）**：
  主代理通过 `invoke_subagent` 派发子代理时，**必须指定其严格扮演的角色，并仅注入该子代理专属的系统提示词（位于 `roles/` 目录）**。**各角色拥有完全独立的上下文，不需要也不应读取其他角色的扮演提示词**：
  - **改编编剧师（Screenwriter）**：注入 [roles/screenwriter.md](roles/screenwriter.md)，逐章精读原著，提炼三级证据细节清单，编写逐格分镜草稿；
  - **剧本改稿整改师（Script Reviser）**：注入 [roles/script_reviser.md](roles/script_reviser.md)，**专职承接驳回剧本的画格级整改任务**，增补 Establishing Shot、扩充高潮交锋镜头、补齐吃瘪吐槽笑点，严禁主导演代劳；
  - **红队审评官 A（Auditor A - 场景与高潮）**：注入 [roles/script_auditor_a.md](roles/script_auditor_a.md)，每 5 章充当严苛啄木鸟，量化扣分场景与高潮缺陷，绑定真实引句驳回并复审核销；
  - **红队审评官 B（Auditor B - 笑点与台词）**：注入 [roles/script_auditor_b.md](roles/script_auditor_b.md)，每 5 章量化扣分幽默笑点过滤与台词 AI 腔，绑定真实引句驳回并复审核销；
  - **全卷文学终审编辑（Chief Script Editor）**：注入 [roles/chief_script_editor.md](roles/chief_script_editor.md)，全卷汇总后执行 `coverage`、`continuity`、`comic` 三轮拉网自校验；
  - **概念美术与人设设计师（Art Director）**：注入 [roles/art_director.md](roles/art_director.md)，提炼角色档案、制定风格指南与基准图提示词；
  - **分镜提示词工程师（Prompt Engineer）**：注入 [roles/prompt_engineer.md](roles/prompt_engineer.md)，将锁定分镜编译打磨为 3~4 格整宽纵排（常规 3 格，信息简单可 4 格）、建议字高 48-60px（作为参考建议）、气泡排版的完整页提示词；
  - **画面渲染执行员（Render Operator）**：注入 [roles/render_operator.md](roles/render_operator.md)，调用生图工具一次性生成包含所有画格与气泡的原生 1080×2400 PNG；生图失败可重试六次；
  - **画面与排版品控员（QA Inspector）**：注入 [roles/qa_inspector.md](roles/qa_inspector.md)，在手机 360/390/430px 视口下核验原生整页，实测字高与文字错漏，填写真实整页 QA；字体验收放宽，字体大小仅为建议不作为卡点；三次审图不符合标准时兜底选择一张最符合的图片并解释缺陷处；
  - **后制包装与交付员（Packager）**：注入 [roles/packager.md](roles/packager.md)，执行页面归档（`prepare-pages`）、排版审阅汇总、多格式导出（HTML/PDF/CBZ）与完整性校验。
- **子代理模型选用建议（建议与主代理保持一致）**：调度各专业子代理时，建议使用与主代理同等水平或一致的模型（在支持继承或指定模型的宿主中优先对齐主代理模型），以保证编剧精读、改稿增补、红队双审、提示词打磨及品控质检等全流程子代理具备充分且一致的理解力与审查深度。
- **主代理核心统筹权责**：主代理仅负责工单拆解派发、审查争议客观仲裁（下达整改指令单）、运行 CLI 机械门禁校验（`check-*`）、全卷剧本锁定（`lock-script`）与最终交付物验收放行（`complete`）。

## 1. 建立和读取项目

1. **唯一默认复制归档保护原稿**：运行 `init-book` 时，唯一默认行为是将小说文本**复制归档**到书名项目内的 `source_texts/` 统一集中管理并校验 SHA256，**完整保留外部原稿在原位置不变**。仅在用户明确指定 `--action move` 时才执行移动。切分长篇文本存入 `split_texts/`。
2. **模块化文档体系**：书名根目录自动生成总览 `README.md` 与 `docs/` 模块文档（`overview.md`、`structure.md`、`worldview.md`、`characters.md`、`art_direction.md`、`progress.md`）；各分卷目录维护卷级精简 `README.md` 与卷级 `docs/`（`info.md`、`status.md`、`commands.md`、`structure.md`、`notes.md`、`deliverables.md`）。模板统一由 `assets/templates/` 动态渲染载入。
3. **分卷独立初始化**：只有新卷或新作品才运行 `init`，自动归档原稿副本至卷内 `source/originals/`，仅支持单一权威版本 `schema_version=6`，其他版本明确拒绝，不迁移旧项目。已有项目先通过 `status` 续做。

## 2. 本卷剧本与多轮审查修订

1. **改编编剧师子代理逐章推进与细节充分展开**：主代理调度独立的改编编剧师子代理（Screenwriter Subagent），按原文章节顺序完整精读当前章正文，保存 `docs/adaptation/<chapter_id>.md` 细节清单与详细场戏，在 `scripts/chapters/<chapter_id>.json` 保存分镜草稿及 `chapter_adaptations`。
   - **防遗漏三大铁律**：严禁过度概括或跳步省略。必须充分阐述关键场景空间与氛围细节（建立身临其境的视听张力）、层层推进关键剧情冲突与高潮转折（拒绝一格带过）、原汁原味还原原著笑点/幽默梗/吐槽与反差互动（严禁遗漏喜剧包袱）。
   - 正文细节严格遵循三级证据分类，第一类事实提供原文短引句与分镜摘句，第二类标明视觉呈现，严禁第三类虚构。主代理执行 `check-adaptation` 并完成语义核查后进入下一章。
2. **每五章阶段剧本审查与打磨整改（全覆盖与指纹绑定）**：根据本卷实际正文章节计算应审批次（每 5 章为一批，尾批不足 5 章单独成批），由审评子代理 A 与 B 执行阶段审查：
   - **客观严谨与证据绑定**：子代理通读原文与分镜草稿，按场景空间、剧情高潮、幽默还原（严肃章节不适用）与台词人设维度客观评估。允许充分检查无缺陷的初审直接通过；若发现重大缺陷，必须绑定真实逐字引句并驳回整改；
   - **仲裁裁定与剧本改稿整改师执笔整改**：总导演客观裁定扣分项（可裁定误报并记录理由），下发整改单；由剧本改稿整改师子代理（subagent_reviser）亲自修改分镜并记录画格前后实质对比（`before_revision` vs `after_revision`），严禁主导演代改；
   - **复审核销与指纹绑定**：审评子代理复核修改画格，缺陷全部闭环（或裁定消除）且复审得分 ≥85 分后通过。阶段报告必须绑定对应章节的内容指纹（`stage_script_hash`），剧本修改后旧阶段报告自动失效需重审。全卷必须完整覆盖所有批次方可推进。
3. **汇总与全卷文学终审**：完成全部章节并通过各阶段审批后汇总本卷工作 JSON，执行 `set-script` 导入并运行 `check-script` 结构预检。运行 `preflight-typeset` 预检对白气泡容量可行性，并查看 `estimate-cost` 全卷页数与调用量估算。主代理调度**全卷文学终审编辑子代理**产出绑定当前剧本指纹的 JSON 审查报告并运行 `review` 登记：
   - `coverage`：核对全部有效原文事件无遗漏、无过度概括、无新增虚构（第一、三类证据审查）；
   - `continuity`：核对因果逻辑、状态转换与知情范围，所有因果转折严格来源于原著；
   - `comic`：核对镜头视听节奏、第二类“视觉呈现”合理自然、台词对白忠于原著语气和原意。
4. **锁定剧本**：三类报告对应同一剧本指纹且阶段审查全覆盖通过后，主代理执行 `lock-script` 输出 `full-script.md`。任何出图前必须先运行 `assert-art` 放行。

## 3. 人物、场景和美术基准

在剧本通过后落实美术规范到基准图：
- **概念美术与人设设计师子代理设计**：制定风格指南与角色档案（男女造型清晰，主角面部五官精细，建立多角度与多表情设定板），编写基准图出图提示词；
- **主代理登记基准图**：审阅品控报告，通过 `register-reference` 登记基准图。续卷可直接复用前卷已通过的基准图。

## 4. 整页漫画一次生成

正文唯一流程是完整页提示词→一次绘图→一张完整PNG→一份整页验收报告。禁止分格生成、裁切画格、跨页合图、后续拼版或代码补字；不保留旧生产接口与兼容操作。

1. **分镜提示词工程师子代理编写打磨**：必须读取 [production.md](references/production.md) 和 [page-prompt-template.md](assets/page-prompt-template.md)，按锁定本页全部分镜、人物状态和原样台词编写完整页提示词。提示词子代理打磨画幅、格数（3~4格纵排，常规模式3格，信息简单可4格）、布局、视觉中心、连续性、气泡位置与归属，消除冲突和漏台词。
2. **渲染执行员子代理调用出图**：主代理运行 `build-prompt --page <page_id>` 编译完整页内容，打磨后 `begin-page --page <page_id> --prompt <file>` 登记调用。渲染子代理调用一次绘图工具，只请求一张包含全部画格与气泡的 1080×2400 原生竖屏完整页。若生图失败（工具报错、网络超时、API异常等），允许重试最多六次。
3. **画面与排版品控员子代理多视口质检**：品控子代理可运行 `preview-page --page <page_id> --file <image>` 预先生成 360/390/430 手机预览，核对页内全部镜头、人物、气泡位置与实测字高（放宽字体验收，字体大小仅为建议，不作为卡点）；运行 `qa-inputs --page <page_id> --attempt <num> --file <image>` 读取机械字段，填写一份真实整页 QA。主代理执行 `finish-page` 或 `fail-page`。失败返修仍请求完整页，每个页输入最多三次调用。如果累计三次审图均不符合标准，启动兜底择优机制：选择一张最符合标准的图片，并在 QA 报告中详细解释该图片的缺陷处（写入 defect_explanation），出具带缺陷说明的放行验收报告并执行 `finish-page` 验收入库，避免流程阻塞。
4. **后制包装子代理归档**：运行 `prepare-pages` 按顺序复制完整原生 PNG 并生成缩小手机预览。

## 5. 质检、恢复与交付

1. **页面审阅与导出**：后制包装子代理整理页面审阅数据后，主代理执行 `review-layout`，运行 `export` 导出离线 HTML 阅读器、PDF 与 CBZ，运行 `verify-export` 校验交付完整性。
2. **最终验收**：主代理执行 `complete` 记录真实最终验收，准确报告本卷交付完成，更新本卷 `README.md` 与顶层总览看板。
3. **中断恢复**：中断或返修时，运行 `status` 依据真实文件和指纹恢复，复用输入一致且已验收的成果，严格按 [recovery.md](references/recovery.md) 处理。