---
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 原生竖屏完整页。
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`。失败返修仍请求完整页，每个页输入最多三次调用。
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) 处理。