// 根据用户提供的内容方向自动生成提示词并创作爽文小说。适用场景：(1) 用户提供小说方向/题材/关键词，(2) 需要生成章节连贯的长篇爽文，(3) 需要维护角色、地点、情节的连续性，(4) 需要为关键情节生成图解，(5) 需要记录生成失败场景以优化后续创作。支持都市、修仙、玄幻、重生、系统流等多种题材。Use when user asks to write a novel, generate fiction, create stories, or mentions 爽文/小说/写作。
| name | novel-generator |
| description | 根据用户提供的内容方向自动生成提示词并创作爽文小说。适用场景：(1) 用户提供小说方向/题材/关键词，(2) 需要生成章节连贯的长篇爽文，(3) 需要维护角色、地点、情节的连续性，(4) 需要为关键情节生成图解，(5) 需要记录生成失败场景以优化后续创作。支持都市、修仙、玄幻、重生、系统流等多种题材。Use when user asks to write a novel, generate fiction, create stories, or mentions 爽文/小说/写作。 |
根据用户提供的内容方向，自动完善提示词并生成章节制爽文小说。通过 .learnings/ 记忆系统维护故事连续性，确保角色、地点、情节前后一致。
| 场景 | 操作 |
|---|---|
| 用户提供小说方向/题材 | 执行「提示词生成流程」，必须参考 references/prompt-guide.md 补全各要素 |
| 开始创作新章节 | 先读取 .learnings/ 中的记忆文件，再按下方章节模板生成 |
| 引入新角色 | 记录到 .learnings/CHARACTERS.md |
| 出现新地点 | 记录到 .learnings/LOCATIONS.md |
| 关键情节转折 | 记录到 .learnings/PLOT_POINTS.md，生成图解 |
| 生成失败/质量不佳 | 记录到 .learnings/ERRORS.md，分析原因 |
| 输出章节 | 按章节生成独立 md 文件到 output/ 目录 |
用户提供方向（题材/关键词/灵感）
↓
┌─────────────────┐
│ 1. 提示词生成 │ → 自动补全世界观、人设、冲突、节奏
└────────┬────────┘
↓
┌─────────────────┐
│ 2. 大纲规划 │ → 全局章节大纲（基于提示词生成）
└────────┬────────┘
↓ ╱
┌─────────────────┐ ┌─────────────────┐
│ 3. 逐章生成 │ ←→ │ .learnings/ 记忆 │
└────────┬────────┘ └─────────────────┘
↓
┌─────────────────┐
│ 4. 输出 & 图解 │ → output/第XX章.md + 关键情节图解
└─────────────────┘
收到用户的小说方向后，生成临时小说名和完善的提示词，请用户确认。
::: warning 【强制】提示词未经用户确认之前，禁止创建项目文件夹和写入任何文件。 :::
用户只需提供一个方向，代理自动补全为完整的创作提示词。
提示词指南见 references/prompt-guide.md，完整示例见 references/examples.md（示例一）。
用户可能只给出一句话：
收到用户方向后，按以下维度结合 references/prompt-guide.md 的详细指导自动补全：
1. 题材定位 → 主类型 + 子类型（如：都市 + 修仙）
2. 世界观设定 → 力量体系、社会规则、时代背景
3. 主角人设 → 初始身份、性格、金手指/挂
4. 核心冲突 → 主线矛盾 + 前3章的即时冲突
5. 爽点设计 → 打脸节奏、升级频率、装逼方式
6. 节奏规划 → 每N章一个小高潮、每M章一个大高潮
7. 配角框架 → 对手/盟友/红颜各至少1人
8. 开篇钩子 → 第一章用什么抓住读者
完善后的提示词保存到 output/提示词.md，并请用户确认或调整。
必须参考 references/examples.md 中的示例一进行校验。
# 《[小说名]》创作提示词
## 一、题材定位
- **主类型**: [都市/玄幻/修仙/科幻/末世/历史/游戏...]
- **子类型**: [重生/系统/穿越/废柴逆袭/退婚/赘婿...]
- **基调**: [热血/轻松/暗黑/搞笑/装逼打脸...]
- **目标读者**: [男频/女频/通用]
## 二、世界观设定
### 时代背景
[现代都市/古代仙侠/未来星际/异世界...]
### 力量体系
| 等级 | 描述 | 代表人物 |
|------|------|---------|
| 第一层 | [描述] | [举例] |
| 最高层 | [描述] | [举例] |
### 社会规则
- [核心规则1：如弱肉强食、实力至上]
- [核心规则2：如宗门体系、家族势力]
## 三、主角设定
- **姓名**: [姓名]
- **初始身份**: [越底层越好，衬托逆袭]
- **年龄**: [年龄]
- **性格**: [表面特征 + 内在特征]
- **初始困境**: [开局有多惨]
- **金手指/系统**: [具体能力和规则]
- 能力1：[描述]
- 限制条件：[不能无限开挂]
- 成长路线：[如何升级]
## 四、核心冲突
### 主线矛盾
[贯穿全书的最大矛盾是什么]
### 前期冲突（第1-5章）
- 即时冲突：[开篇就面对的问题]
- 对手：[第一个被打脸的对象]
- 爽点：[第一波装逼打脸怎么打]
## 五、爽点设计
### 打脸套路（循环使用）
1. [套路1：如被嘲笑实力弱 → 一招秒杀]
2. [套路2：如被下战书 → 轻松碾压 → 众人震惊]
### 升级节奏
- 每 [N] 章突破一次小等级
- 每 [M] 章突破一次大境界
## 六、配角框架
### 盟友
| 姓名 | 身份 | 与主角关系 | 作用 |
|------|------|-----------|------|
| [名] | [身份] | [关系] | [推动剧情/提供助力] |
### 对手/反派
| 姓名 | 身份 | 与主角矛盾 | 结局 |
|------|------|-----------|------|
| [名] | [身份] | [矛盾] | [被打脸/洗白/死亡] |
### 红颜/CP
| 姓名 | 身份 | 感情线 | 作用 |
|------|------|--------|------|
| [名] | [身份] | [发展] | [助力/牵挂/动力] |
## 七、开篇设计
### 前三章节奏
- 第1章：[核心事件] → 读者情绪：[好奇/同情/期待]
- 第2章：[核心事件] → 读者情绪：[紧张/兴奋]
- 第3章：[核心事件] → 读者情绪：[爽快/震惊] ← 第一个爽点高潮
## 八、风格指南
- **叙述视角**: [第一人称/第三人称有限/全知]
- **语言风格**: [简洁干练/古风韵味/幽默吐槽/中二热血]
- **每章字数**: [2000-3000字]
在提示词确认后、正式写作前，先生成全局大纲。
情节结构参考：references/plot-structures.md。
::: warning 【强制】在生成大纲之前，必须先询问用户目标总字数。
参考示例：references/examples.md（示例四）
# 《小说名》大纲
## 基本信息
- **小说名**: [小说名]
- **题材**: [题材标签，如：都市+修仙+系统流]
- **每章字数**: 2500-3000字
- **总字数**: 约XX万字
- **总章节数**: 约XXX章
## 故事简介
[一句话概括故事核心设定和主线]
---
## 篇章剧情走向
---
### 第一卷：[卷名]（第1-N章）
**核心弧线**：[从XX到XX的成长线]
**一句话**：[本卷核心内容的一句话概括]
**核心困境**：[始终存在的核心矛盾，如：身份差距/实力不足/外敌压迫/时间限制等]
**登场角色**：
- [角色名]（[形态/身份]，[角色定位]）
**爽点节奏**：
| 章节 | 事件 |
|------|------|
| X-X | [小打脸：建立基地/收编队友] |
| X-X | [中打脸：首次对决/突破等级] |
| X-X | [大高潮：大事件+卷终决战] |
**关键节点**：
| 节点 | 内容 | 预估章节 |
|------|------|---------|
| 起 | [开局事件] | 1-2 |
| 压制 | [遭遇强敌被压制] | 3-X |
| 成长 | [发现成长方法/积累资源] | X-X |
| 转机 | [获得关键能力/盟友/情报] | X-X |
| 高潮 | [卷终决战/重大转折] | N-1 ~ N |
---
### 第二卷：[卷名]（第N+1-M章）
...
提示：长篇爽文建议按卷规划，每卷80-100章（约20-25万字），每卷有独立的核心弧线和卷终高潮。
大纲保存到 output/大纲.md。
读取以下记忆文件：
::: warning 【强制】未读取以下记忆文件，禁止生成新章节。
.learnings/CHARACTERS.md → 当前所有角色的状态
.learnings/LOCATIONS.md → 已出现的地点
.learnings/PLOT_POINTS.md → 已发生的关键情节
.learnings/STORY_BIBLE.md → 世界观设定和规则
::: warning 【强制】完成写作计划确认前，禁止开始生成正文。 :::
对照 output/大纲.md，确认以下内容：
=== 本章写作计划 ===
【章节定位】本章是第XX章，属于第X卷"[卷名]"
【大纲要求】根据大纲，本章应完成：
1. [从大纲中提取的本章任务]
2. [...]
【上章回顾】上一章结束时：
- 主角状态：
- 关键事件：
- 未解决的伏笔：
【偏离风险】预判本章可能偏离的点：
- [需要特别注意的设定/情节]
- [可能的偏移风险]
【确认】□ 已对照大纲确认，准备开始生成
| 要素 | 要求 |
|---|---|
| 节奏 | 每章至少一个小爽点，不能平淡流水 |
| 冲突 | 每章有明确的矛盾推动情节 |
| 悬念 | 章末必须设置钩子，让人想看下一章 |
| 连贯性 | 与前文角色状态、地点描写、已有情节保持一致 |
| 递进感 | 主角能力/地位/见识要有可感知的成长 |
| 对话 | 对话要有个性差异，反派不能太蠢 |
每章按以下结构生成（纯文本格式，无任何 Markdown 标记）：
章节正文示例见 references/examples.md（示例二）
第XX章 [章节名]
【本章概要】一句话概括本章核心事件
【本章爽点】本章主要的爽感来源（打脸/突破/获宝/逆转...）
【情绪曲线】[低开高走 / 层层递进 / 反转爆发 / 紧张释放]
【涉及角色】[本章出场的角色列表]
【涉及地点】[本章场景所在地]
（正文内容，2000-3000字）
（开篇：承接上章 / 场景切入 / 对话开场）
（发展：矛盾升级 / 信息揭示 / 力量展示）
（高潮：本章爽点 / 冲突爆发 / 反转发生）
（收束：结果呈现 / 众人反应 / 章末钩子）
【章末钩子】[留下的悬念，引导继续阅读]
【下章预告】[下一章将要发生什么的简要提示]
::: warning
【强制】字数统计必须使用 scripts/check_chapter_wordcount.py 脚本，禁止AI自行估算。每章字数必须控制在 2000-3000 字范围内，超出或不足都必须调整至达标后方可移入 output/。
:::
# 检查单个章节（必须执行）
python scripts/check_chapter_wordcount.py output/第01章_章节名.md
# 检查所有章节
python scripts/check_chapter_wordcount.py --all
::: warning 【强制】字数检查通过后、进入检查清单前，必须完成偏离检测。未通过偏离检测的章节禁止移入 output/。 :::
生成章节后，对照 output/大纲.md 进行偏离检测：
=== 偏离检测 ===
【本章目标】根据大纲，本章应完成：
1. [对照大纲列出本章应该发生的事件]
2. [对照大纲列出本章应该推进到的阶段]
【实际结果】本章实际写了：
1. [实际发生的事件]
2. [实际推进到的阶段]
【偏离判定】
□ 无偏离 — 本章完全符合大纲
□ 轻度偏离 — [列出具体偏移点，但不影响主线，可接受]
□ 严重偏离 — [列出具体偏移点，已影响主线走向，必须修正]
【偏离详情】（如有偏离，填写以下内容）
- 偏移事件：
- 大纲预期：
- 实际走向：
- 修正建议：
【爽点节奏检查】
- 本章是否有明确爽点？[是/否]
- 如有，是哪种类型？[打脸/突破/获宝/逆转/其他]
- 如否，说明原因：
【结论】
✓ 通过检测 — 可以进入检查清单
✗ 需要修正 — 请根据【修正建议】重写或调整
偏离判定标准：
| 级别 | 描述 | 处理方式 |
|---|---|---|
| 无偏离 | 本章完全在大纲框架内 | 直接通过 |
| 轻度偏离 | 局部细节不一致，但主线正确 | 记录但不阻断，可修正后通过 |
| 严重偏离 | 主线走向错误、关键事件遗漏或添加了不该发生的重大事件 | 必须修正后才能通过 |
常见偏离场景：
| 偏离类型 | 表现 | 严重程度 |
|---|---|---|
| 跳过关键事件 | 大纲要求第N章发生A事件，但直接跳到了B事件 | critical |
| 角色提前出现 | 大纲第N章才出场的角色，在第M章就出现了 | high |
| 等级/境界错误 | 主角还没到大纲设定的境界，却表现出更高境界的能力 | high |
| 势力关系错误 | 把敌对势力写成盟友，或反之 | critical |
| 世界观规则违反 | 出现了违反 STORY_BIBLE.md 中核心规则的设定 | critical |
| 支线喧宾夺主 | 大纲中的小支线变成了本章主线 | medium |
每章生成后自检：
::: warning 【强制】未通过以下全部检查的章节，禁止移入 output/ 目录或用于后续章节生成。 :::
连贯性检查：
质量检查：
scripts/check_chapter_wordcount.py 统计字数记忆更新检查：
记忆文件条目示例见 references/examples.md（示例三）。
CHARACTERS.md：
# 角色档案
记录所有已出场角色的信息，每次生成新章节前必读。
**更新规则**：新角色出场时添加，角色状态变化时更新，角色死亡时标记。
---
## [角色姓名]
**首次出场**: 第XX章
**身份**: [身份描述]
**阵营**: 主角方 | 敌对 | 中立
**等级/实力**: [当前等级]
**当前状态**: 活跃 | 受伤 | 失踪 | 死亡
**性格特征**: [2-3个关键词]
**与主角关系**: [关系描述]
**标志性特征**: [外貌/口头禅/习惯等辨识特征]
### 经历摘要
- 第XX章：[关键事件]
LOCATIONS.md：
# 地点档案
记录所有已出现的地点信息，确保空间描写一致。
**更新规则**：新地点出现时添加，地点发生变化（被毁/升级）时更新。
---
## [地点名称]
**首次出场**: 第XX章
**类型**: 城市 | 宗门 | 秘境 | 战场 | 居所 | 其他
**所属势力**: [势力名]
**地理位置**: [相对位置描述]
**环境特征**: [2-3个关键描述]
**重要事件**: [在此地发生过什么]
**当前状态**: 正常 | 被毁 | 封禁 | 已离开
PLOT_POINTS.md：
# 关键情节档案
记录所有关键情节点，维护故事主线连贯性。
**更新规则**：每章生成后记录关键事件，标注是否有未解决的伏笔。
---
## [PLOT-YYYYMMDD-XXX] 情节标题
**章节**: 第XX章
**记录时间**: ISO-8601
**类型**: 主线推进 | 伏笔埋设 | 伏笔回收 | 转折点 | 打脸 | 突破
**状态**: 进行中 | 已完结 | 伏笔待回收
### 事件描述
[发生了什么]
### 涉及角色
[哪些角色参与]
### 后续影响
[这个情节会影响后续什么]
STORY_BIBLE.md：
# 故事圣经
世界观核心设定，一经确立不可随意修改。新设定补充时追加。
---
## 世界观基础
[基本世界背景]
## 力量体系
[完整等级体系和规则]
## 核心规则
[这个世界的基本法则，如：实力至上、弱肉强食]
## 禁忌/限制
[什么是绝对不能打破的设定]
## 主线目标
[全书终极目标]
| 事件 | 记录到 | 何时写入 |
|---|---|---|
| 新角色出场 | CHARACTERS.md | 该章生成完毕后立即写入 |
| 角色状态变化（升级、受伤、死亡） | CHARACTERS.md | 更新对应角色条目 |
| 新地点出现 | LOCATIONS.md | 该章生成完毕后立即写入 |
| 关键情节发生 | PLOT_POINTS.md | 该章生成完毕后立即写入 |
| 世界观规则补充 | STORY_BIBLE.md | 发现新设定时立即写入 |
| 生成失败或质量差 | ERRORS.md | 失败后立即记录原因 |
::: warning 【强制】每章生成完毕后，必须立即更新对应记忆文件，未更新的记忆文件禁止用于下一章生成。 :::
读取所有记忆文件，确保：
::: warning 【强制】未完整读取记忆文件，禁止生成新章节。 :::
当出现以下场景时，生成对应的图解：
| 场景 | 图解内容 |
|---|---|
| 关键战斗 | 双方站位、力量对比、胜负关键 |
| 势力地图 | 各方势力的关系与分布 |
| 等级突破 | 角色成长路线图 |
| 人物关系 | 主要角色关系网 |
| 重大剧情线 | 剧情时间线/因果链 |
图解使用 Mermaid 语法嵌入 md 文件，或使用图像生成工具生成。
人物关系图：
graph TD
A[主角·林凡] -->|师徒| B[师父·苍老人]
A -->|宿敌| C[反派·赵天罡]
A -->|暧昧| D[女主·苏婉儿]
C -->|从属| E[赵家]
D -->|出身| F[苏家]
E -->|对立| F
等级体系图：
graph BT
L1[炼气期] --> L2[筑基期]
L2 --> L3[金丹期]
L3 --> L4[元婴期]
L4 --> L5[化神期]
L5 --> L6[大乘期]
style L2 fill:#f9f,stroke:#333
生成失败或质量不达标时，记录到 .learnings/ERRORS.md。
| 失败类型 | 描述 | 记录内容 |
|---|---|---|
| 角色穿帮 | 已死角色再次出现 | 穿帮章节、角色名、正确状态 |
| 设定矛盾 | 力量体系自相矛盾 | 矛盾点、涉及章节、修正方案 |
| 节奏失控 | 连续多章无爽点 | 失控起始章节、节奏分析 |
| 情节重复 | 相似桥段反复出现 | 重复内容、首次出现位置 |
| 人设崩塌 | 角色行为违背人设 | 角色名、崩塌行为、原始人设 |
| 生成中断 | 技术原因导致生成失败 | 错误信息、中断位置 |
## [NOVEL-ERR-YYYYMMDD-XXX] 失败类型
**记录时间**: ISO-8601
**章节**: 第XX章
**严重程度**: low | medium | high | critical
### 问题描述
具体发生了什么
### 影响范围
影响了哪些章节、角色、情节线
### 修正方案
如何修复，是否需要重写
### 预防措施
如何避免同类问题再次发生
output/
├── 提示词.md # 完善后的创作提示词
├── 大纲.md # 全局章节大纲
├── 第01章_[章名].md # 各章节独立文件
├── 第02章_[章名].md
├── 第03章_[章名].md
├── ...
├── 人物关系图.md # 关键图解
├── 势力分布图.md
└── 等级体系图.md
第XX章_章节名.md（XX 用两位数字，如 01、02）[图解类型].md第XXX章_章节名.md::: warning 【强制】以下禁忌必须严格遵守，违反将导致故事质量严重下降。 :::
::: warning 【强制】用户确认提示词（包含小说名）后，必须立即运行初始化脚本创建项目工作区。 :::
${SKILL_DIR}/scripts/init-novel.sh <小说名>
这会创建 小说名/ 文件夹，包含：
output/ - 章节输出目录references/ - 参考指南.learnings/ - 记忆文件scripts/ - 脚本工具（不含 init-novel.sh）
[HINT] Download the complete skill directory including SKILL.md and all related files