# Chinese Novelist

> 分章节创作引人入胜的中文小说。支持各种题材（悬疑/言情/奇幻/科幻/历史等），支持10-50章长篇创作，每章3000-5000字，使用追读理由和结尾策略轮换避免机械化钩子。强调爽文节拍、深度润色去除AI痕迹，验收失败自动修复并复检，确保文字自然流畅。 当用户要求：写小说、创作故事、分章节写作、连续剧情、章节悬念、长篇小说时使用。

- Skill: `xmzdesign/chinese-novelist` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add xmzdesign/chinese-novelist`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xmzdesign/chinese-novelist/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: xmzdesign (https://skillmd.com/u/xmzdesign)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xmzdesign/chinese-novelist

---


# Chinese Novelist: 中文小说创作助手

## 网文顶层设计与黄金法则

1. **代入感先成立** - 用现实共鸣、规则、证据和代价合理化虚构中的不合理
2. **爽点必须兑现** - 让财富、权力、能力、身份、关系或尊严的升级可被读者看见
3. **期待承上启下** - 每章同时处理填坑与挖坑，但不强制硬悬念钩子
4. **核心循环不断档** - 主角反复进入问题、解决冲突、获得收益、升级并面对更难挑战
5. **合理化主角行动** - 主角优先用熟悉领域、能力来源、信息差或规则优势取胜
6. **系统流有内在规则** - 金手指、系统、重生经验或职业能力必须有触发、边界、代价和升级路径
7. **黄金三章留住读者** - 前三章必须快速抛出核心梗、优势来源、初始冲突和第一次有限兑现
8. **展示而非讲述** - 用动作和对话表现，不要直接陈述
9. **冲突驱动剧情** - 每章必须有冲突或转折

## 质量产出硬约束

- **质量前置，不靠写后补救**：正文前必须把 `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 核心原则

1. **先契约后写作**：每章写作前必须存在 `chapter-contracts/第XX章.md`
2. **先场景卡后正文**：启用 `sceneCardPolicy` 时，`sceneCardStatus == "pass"` 且 `sceneCardIssues` 为空后才写正文
3. **先 QA 后完成**：章节只有在 `qaStatus == "pass"` 且无阻塞项时，才能标记 `completed`
4. **先反 AI 后评分**：`antiAiStatus == "pass"` 且 `literaryScore` 达标后，才允许通过
5. **先追读后放行**：`readerHookStatus == "pass"`，有 `memorableMoment`、`chapterTurnPageHook` 和合法 `endingStrategy`
6. **先网文顶层后完成**：启用 `webNovelDesign` 时，`webNovelStatus == "pass"` 且 `webNovelIssues` 为空后才可通过
7. **先编辑审稿后完成**：启用 `editorGate` 时，`editorGateStatus == "pass"`、`editorGateScore` 达标且无读者流失风险后才可通过
8. **至少三轮检测**：`reviewRoundCount >= 3`，任一轮阻塞失败都不得通过
9. **修复后必须复检**：`repairRequired == false`、`needsRecheck == false`、`lastFailureCodes` 为空后才可收口
10. **Hook 失败即阻断**：`post-draft`、`pre-mark-pass`、`stop`、`session-close` 任一失败时，按 Next action 继续执行
11. **全局状态集中写入**：并行 Agent 不直接改 `01-大纲.md` 和 `02-写作计划.json`，由 Orchestrator/State Keeper 合并
12. **失败项定向修复**：修复阶段只处理 QA 报告中的失败项，最多 3 轮

## 核心流程

进入每个阶段时，先阅读对应的流程文档以获取详细执行指令。

### 第0步：初始化与偏好加载

读取用户偏好，检测未完成项目（中断续写），展示个性化欢迎。 → 详见 [phase0-initialization.md](references/flows/phase0-initialization.md)

### 第一阶段：三层递进式问答

通过递进式问答收集创作需求，确定小说定位与标题：

- **核心定位**（必答，Q1-Q3）：题材创意、主角设定、核心冲突 → 详见 [phase1-layer1-core.md](references/flows/phase1-layer1-core.md)
- **深度定制与规格**（Q4-Q8）：世界观、视角基调、核心主题、读者定位、章节数量、配置确认 → 详见 [phase1-layer2-customize.md](references/flows/phase1-layer2-customize.md)
- **标题生成**：AI 基于创意元素生成候选标题，用户选择或自定义 → 详见 [phase1-layer3-title.md](references/flows/phase1-layer3-title.md)

### 第二阶段：规划 + 二次确认

创建项目文件夹（`./chinese-novelist/{timestamp}-{小说名称}/`），生成质量基准、大纲、人物档案、网文顶层设计、黄金三章设计、章节契约和写作计划 JSON，等待用户确认。 → 详见 [phase2-planning.md](references/flows/phase2-planning.md)

### 第2.5步：写作模式选择

规划确认后，选择写作模式：
- **逐章串行**（`serial`）：主 Agent 自己逐章写，全程无中断
- **子Agent并行**（`subagent-parallel`）：将章节分成批次，派生子 Agent 并行写作
- **Agent Teams**（`agent-teams`）：Claude Code 多 Agent 协作模式，Agent 间可通讯（需手动开启）

→ 详见 [phase3-writing.md](references/flows/phase3-writing.md)

### 第三阶段：Novel Harness 创作（无需用户确认）
> 切记，一旦进入这个阶段，所有过程都禁止向用户确认。用户就是你的读者，你必须把完整的小说创作完成才能与用户报告

根据用户选择的写作模式（串行/并行/Teams）逐章执行 Novel Harness 章节 sprint。每章创作前必须读取章节契约、`01-大纲.md` 对应规划、`00-人物档案.md`、`04-网文顶层设计.md`、`05-质量基准.md` 和上一章摘要；正文前必须先通过场景卡，写完后必须运行 hook、QA、Editor Gate、失败自动定向修复，修复后重新三轮检测。所有小说都必须通过网文顶层设计、爽文专项、编辑审稿和机械化结尾检查。支持中断续写。 → 详见 [phase3-writing.md](references/flows/phase3-writing.md)

### 第四阶段：最终总验收（无需用户确认）

全程无需用户介入，汇总章节 QA、字数、状态、伏笔、时间线和人物弧线；未通过章节回到第三阶段最多修复 3 轮，并在每轮修复后重新发起检测。汇报完成前必须运行 stop hook。 → 详见 [phase4-validation.md](references/flows/phase4-validation.md)

## 共享机制

偏好系统、写作计划系统、质量基准、网文顶层设计、场景卡、编辑审稿、黄金三章、章节契约、文学质量门禁、追读力门禁、三轮检测、自动修复复检、Novel Hook、QA 评分、进度收口、黄金法则、字数检查脚本和 flow smoke test 等跨阶段共享机制。 → 详见 [shared-infrastructure.md](references/flows/shared-infrastructure.md)

### 运行时初始化

如果目标仓库尚未配置 Claude/Codex hooks，先运行：

```bash
python scripts/init_novel_harness.py --target-dir .
```

该命令会初始化 `AGENTS.md`、`CLAUDE.md`、`.claude/settings.json`、`.codex/hooks.json` 和 hook 脚本。初始化后即使模型没有主动阅读流程文档，Stop hook 也会在汇报完成前拦截未 QA、未修复、未复检的项目。