xmzdesign Chinese Novelist: 中文小说创作助手
网文顶层设计与黄金法则
- 代入感先成立 - 用现实共鸣、规则、证据和代价合理化虚构中的不合理
- 爽点必须兑现 - 让财富、权力、能力、身份、关系或尊严的升级可被读者看见
- 期待承上启下 - 每章同时处理填坑与挖坑，但不强制硬悬念钩子
- 核心循环不断档 - 主角反复进入问题、解决冲突、获得收益、升级并面对更难挑战
- 合理化主角行动 - 主角优先用熟悉领域、能力来源、信息差或规则优势取胜
- 系统流有内在规则 - 金手指、系统、重生经验或职业能力必须有触发、边界、代价和升级路径
- 黄金三章留住读者 - 前三章必须快速抛出核心梗、优势来源、初始冲突和第一次有限兑现
- 展示而非讲述 - 用动作和对话表现，不要直接陈述
- 冲突驱动剧情 - 每章必须有冲突或转折
质量产出硬约束
- 质量前置，不靠写后补救：正文前必须把
05-质量基准.md、04-网文顶层设计.md、章节契约和场景卡转成可写的章节任务；不要先写一章再靠 QA 大修。 - 真实细节必须变成压力：酒店、手机、账单、前台、体检、行程、职业流程等细节，必须改变主角处境或逼出选择；只出现不施压的细节视为资料堆砌。
- 场景必须改变局面：每个场景都要让人物、信息、资源、关系、危险或读者期待发生变化；没有变化的场景先删、合并或重排，后半章不得退化成主角整理信息。
- 事件链推着主角走：中后段必须连续发生外部事件，如催促、临时改约、被试探、差点露馅、被低估、被加测、被迫短答；禁止长时间停在理解规则和理性判断。
- 主角先是人，再是能力载体：主角必须先被事件打到，出现错愕、迟疑、愧疚、下意识撒谎、说完后后悔、身体不听使唤等反应，再靠能力应对。
- 配角必须制造压迫：配角不能只念流程或提供信息，至少要催时间、打断、质疑、提醒、要求签字、拿走物件、要求短答或制造误判。
- 爽点必须有因果链：
satisfactionBeats不能只写“主角很爽/打脸成功”，必须写清压迫或误判、主角行动、可见收益、旁人或局势反应、下一步期待。 - 读者流失点提前拦截：每章都要在前 300 字、约 1000 字、中段和结尾四个位置自检，任何一处明显流失都不得进入完成态。
- 禁止格言式总结句：禁止用“不是 X，而是 Y”“再往前是 X，再往后是 Y”“知道答案的人也得……”这类聪明句替代动作、关系变化和悬念。
- 修复按层级回退：结构问题回章节契约或场景卡，情节问题重写关键场景，人物问题补动机和代价，文字问题才做 humanize；禁止用泛泛润色掩盖结构失败。
特性说明
- 网文顶层设计：所有小说默认生成
04-网文顶层设计.md，检查代入感、爽点、期待感、核心循环、合理化主角和系统流规则 - 质量基准前置：所有小说默认生成
05-质量基准.md，先确定目标读者、作品承诺、质量红线和流失雷区 - 场景卡先行：每章正文前先生成
scene-cards/第XX章.md，确认每个场景都有目的、冲突、信息释放、情绪兑现和局面变化 - 编辑审稿门禁：QA 后增加 Editor Gate，按真实读者流失点检查前 300 字、1000 字主冲突、中段空转、兑现和结尾
- 黄金三章专项：开篇三章按“启示 → 转折 → 小高潮”设计和验收
- 文学质量门禁：反 AI 一票否决，章节必须达到最低文学质量分
- 追读力门禁：每章必须有亮点、幽默/反差调味和明确追读理由
- 爽文专项：所有小说默认检查
satisfactionBeats、shuangwenStatus和爽文专项问题 - 反套路结尾：通过
endingStrategy轮换结尾类型，拦截每章同质硬钩子 - 三轮检测：所有 QA 检测至少重复 3 轮，最终按保守聚合放行
- 中断续写：自动检测未完成项目，从断点继续创作
- Novel Harness 章节闭环：每章执行 read task → contract → scene card → draft → humanize → QA → Editor Gate → fix → recheck → mark_pass → session_close
- Novel Hook 机制：写完、放行、停止和收口前用 hook 拦截跳过 QA/优化/复检的问题
- 运行时初始化：提供
scripts/init_novel_harness.py，生成AGENTS.md、CLAUDE.md、.claude/、.codex/ - 自动修复复检：验收失败自动定向修复，修复后作废旧结论并重新三轮检测
- 自动校验：每章写完立即生成 QA 报告，最终再做全书验收
- 并行写作（可选）：支持子Agent按故事弧并行写作，通过章节契约和
02-写作计划.json协调状态
Novel Harness 核心原则
- 先契约后写作：每章写作前必须存在
chapter-contracts/第XX章.md - 先场景卡后正文：启用
sceneCardPolicy时，sceneCardStatus == "pass"且sceneCardIssues为空后才写正文 - 先 QA 后完成：章节只有在
qaStatus == "pass"且无阻塞项时，才能标记completed - 先反 AI 后评分：
antiAiStatus == "pass"且literaryScore达标后，才允许通过 - 先追读后放行：
readerHookStatus == "pass"，有memorableMoment、chapterTurnPageHook和合法endingStrategy - 先网文顶层后完成：启用
webNovelDesign时，webNovelStatus == "pass"且webNovelIssues为空后才可通过 - 先编辑审稿后完成：启用
editorGate时，editorGateStatus == "pass"、editorGateScore达标且无读者流失风险后才可通过 - 至少三轮检测：
reviewRoundCount >= 3，任一轮阻塞失败都不得通过 - 修复后必须复检：
repairRequired == false、needsRecheck == false、lastFailureCodes为空后才可收口 - Hook 失败即阻断：
post-draft、pre-mark-pass、stop、session-close任一失败时，按 Next action 继续执行 - 全局状态集中写入：并行 Agent 不直接改
01-大纲.md和02-写作计划.json，由 Orchestrator/State Keeper 合并 - 失败项定向修复：修复阶段只处理 QA 报告中的失败项，最多 3 轮
核心流程
进入每个阶段时，先阅读对应的流程文档以获取详细执行指令。
第0步：初始化与偏好加载
读取用户偏好，检测未完成项目（中断续写），展示个性化欢迎。 → 详见 phase0-initialization.md
第一阶段：三层递进式问答
通过递进式问答收集创作需求，确定小说定位与标题：
- 核心定位（必答，Q1-Q3）：题材创意、主角设定、核心冲突 → 详见 phase1-layer1-core.md
- 深度定制与规格（Q4-Q8）：世界观、视角基调、核心主题、读者定位、章节数量、配置确认 → 详见 phase1-layer2-customize.md
- 标题生成：AI 基于创意元素生成候选标题，用户选择或自定义 → 详见 phase1-layer3-title.md
第二阶段：规划 + 二次确认
创建项目文件夹（./chinese-novelist/{timestamp}-{小说名称}/），生成质量基准、大纲、人物档案、网文顶层设计、黄金三章设计、章节契约和写作计划 JSON，等待用户确认。 → 详见 phase2-planning.md
第2.5步：写作模式选择
规划确认后，选择写作模式：
- 逐章串行（
serial）：主 Agent 自己逐章写，全程无中断 - 子Agent并行（
subagent-parallel）：将章节分成批次，派生子 Agent 并行写作 - Agent Teams（
agent-teams）：Claude Code 多 Agent 协作模式，Agent 间可通讯（需手动开启）
→ 详见 phase3-writing.md
第三阶段：Novel Harness 创作（无需用户确认）
切记，一旦进入这个阶段，所有过程都禁止向用户确认。用户就是你的读者，你必须把完整的小说创作完成才能与用户报告
根据用户选择的写作模式（串行/并行/Teams）逐章执行 Novel Harness 章节 sprint。每章创作前必须读取章节契约、01-大纲.md 对应规划、00-人物档案.md、04-网文顶层设计.md、05-质量基准.md 和上一章摘要；正文前必须先通过场景卡，写完后必须运行 hook、QA、Editor Gate、失败自动定向修复，修复后重新三轮检测。所有小说都必须通过网文顶层设计、爽文专项、编辑审稿和机械化结尾检查。支持中断续写。 → 详见 phase3-writing.md
第四阶段：最终总验收（无需用户确认）
全程无需用户介入，汇总章节 QA、字数、状态、伏笔、时间线和人物弧线；未通过章节回到第三阶段最多修复 3 轮，并在每轮修复后重新发起检测。汇报完成前必须运行 stop hook。 → 详见 phase4-validation.md
共享机制
偏好系统、写作计划系统、质量基准、网文顶层设计、场景卡、编辑审稿、黄金三章、章节契约、文学质量门禁、追读力门禁、三轮检测、自动修复复检、Novel Hook、QA 评分、进度收口、黄金法则、字数检查脚本和 flow smoke test 等跨阶段共享机制。 → 详见 shared-infrastructure.md
运行时初始化
如果目标仓库尚未配置 Claude/Codex hooks，先运行：
python scripts/init_novel_harness.py --target-dir .
该命令会初始化 AGENTS.md、CLAUDE.md、.claude/settings.json、.codex/hooks.json 和 hook 脚本。初始化后即使模型没有主动阅读流程文档，Stop hook 也会在汇报完成前拦截未 QA、未修复、未复检的项目。