Skill: followaf/fiction-crafter (version 1.1.0)

--- name: fiction-crafter description: "根据用户提供的内容方向自动生成提示词并创作爽文小说。适用场景：(1) 用户提供小说方向/题材/关键词，(2) 需要生成章节连贯的长篇爽文，(3) 需要维护角色、地点、情节的连续性，(4) 需要为关键情节生成图解，(5) 需要记录生成失败场景以优化后续创作。支持都市、修仙、玄幻、重生、系统流等多种题材。Use when user asks to write a novel, generate fiction, create stories, or mentions 爽文/小说/写作。" license: MIT-0 compatibility: "适用于 Claude Code、Cursor、OpenAI Codex、GitHub Copilot 等支持 Agent Skills 的工具。需要文件读写权限。" metadata: author: kimo version: "1.1.0" language: zh-CN category: creative-writing tags: "novel, fiction, creative-writing, chinese, 爽文, 小说生成, fiction-crafter" original: "ityhg/novel-generator" --- # 小说工匠 Fiction Crafter 精细化小说创作工具，自动完善提示词并生成章节制爽文小说。通过 `.learnings/` 记忆系统维护故事连续性，确保角色、地点、情节前后一致。 > **致谢**：本技能基于 [novel-generator](https://clawhub.ai/ityhg/novel-generator) 进行二次开发，感谢原作者的贡献。 ## 快速参考 | 场景 | 操作 | | --------------------- | ------------------------------------------------- | | 用户提供小说方向/题材 | 执行「提示词生成流程」，产出完善的创作提示词 | | 开始创作新章节 | 先读取大纲、章节规划、记忆文件，再按模板生成 | | 新卷开始前 | 生成本卷的章节规划文件 `.learnings/章节规划_卷N.md` 【新增】 | | 章节生成完毕后 | 调用 `format_chapter.py` 处理分隔符 【新增】 | | 章节生成后 | 执行九维度审查，记录到 `.learnings/审查记录.md` 【新增】 | | 引入新角色 | 记录到 `.learnings/CHARACTERS.md` | | 出现新地点 | 记录到 `.learnings/LOCATIONS.md` | | 关键情节转折 | 记录到 `.learnings/PLOT_POINTS.md`，生成图解 | | 生成失败/质量不佳 | 记录到 `.learnings/ERRORS.md`，分析原因 | | 输出章节 | 按章节生成独立 md 文件到 `output/` 目录 | | **续写/中断恢复** | 读取进度状态，从断点继续生成 【新增】 | --- ## 工作流总览 ``` 用户提供方向（题材/关键词/灵感） ↓ ┌─────────────────┐ │ 1. 提示词生成 │ → 自动补全世界观、人设、冲突、节奏 └────────┬────────┘ ↓ ┌─────────────────┐ │ 2. 大纲规划 │ → 全局章节大纲 + 起承转合设计 └────────┬────────┘ ↓ ┌─────────────────┐ │ 3. 卷级章节规划 │ → 每卷的章节任务、爽点分布、伏笔规划 【新增】 └────────┬────────┘ ↓ ┌─────────────────┐ ┌─────────────────┐ │ 4. 逐章生成 │ ←→ │ .learnings/ 记忆 │ └────────┬────────┘ └─────────────────┘ ↓ ┌─────────────────┐ │ 5. 格式化处理 │ → 调用 format_chapter.py 脚本 【新增】 └────────┬────────┘ ↓ ┌─────────────────┐ │ 6. 章节审查 │ → 九维度诊断，确保剧情不偏离 【新增】 └────────┬────────┘ ↓ ┌─────────────────┐ │ 7. 输出 & 图解 │ → output/第XX章.md + 关键情节图解 └─────────────────┘ ``` --- ## 第一步：提示词生成与完善 用户只需提供一个方向，代理自动补全为完整的创作提示词。 ### 用户输入示例 用户可能只给出一句话： - "写一个都市修仙的爽文" - "重生回高中逆袭成商业大亨" - "废柴少年获得系统后一路碾压" ### 提示词自动完善流程 收到用户方向后，按以下维度自动补全： ``` 1. 题材定位 → 主类型 + 子类型（如：都市 + 修仙） 2. 世界观设定 → 力量体系、社会规则、时代背景 3. 主角人设 → 初始身份、性格、金手指/挂 4. 核心冲突 → 主线矛盾 + 前3章的即时冲突 5. 爽点设计 → 打脸节奏、升级频率、装逼方式 6. 节奏规划 → 每N章一个小高潮、每M章一个大高潮 7. 配角框架 → 对手/盟友/红颜各至少1人 8. 开篇钩子 → 第一章用什么抓住读者 ``` 完善后的提示词保存到 `output/提示词.md`，并请用户确认或调整。 ### 提示词质量检查 完善后自检以下项： - [ ] 主角有明确的"逆袭起点"（够惨才够爽） - [ ] 金手指/系统有清晰的规则和限制 - [ ] 前三章至少有一个"打脸"场景设计 - [ ] 力量体系有明确层级（便于体现碾压感） - [ ] 有至少一个"众人皆看不起 → 被打脸"的经典结构 --- ## 第二步：大纲规划 在提示词确认后、正式写作前，先生成全局大纲。 ### 大纲结构 ```markdown # 《小说名》大纲 ## 基本信息 - 题材： - 预计章节数： - 每章字数：约2000-3000字 ## 力量/等级体系 （从低到高列出等级） ## 主线剧情走向 ### 第一卷：[卷名]（第1-N章） - 核心冲突： - 主角成长：从XX到XX - 爽点设计： ### 第二卷：[卷名]（第N+1-M章） ... ## 关键转折点 1. 第X章：（描述转折） 2. 第X章：（描述转折） ``` 大纲保存到 `output/大纲.md`。 --- ## 第三步：卷级章节规划【新增】 在大纲确认后、正式写作前，为每一卷生成详细的章节规划。这是防止剧情写偏的关键步骤。 ### 规划时机 | 时机 | 操作 | |------|------| | 新卷开始前 | 生成本卷的章节规划文件 | | 每章写完后 | 更新章节分解表中的"状态" | | 剧情调整时 | 更新章节任务，备注调整原因 | ### 章节规划内容 每卷的章节规划包含以下要素： ``` 1. 本卷核心目标 → 本卷要达成的剧情目标 2. 章节分解表 → 每章的核心任务、爽点类型、关键情节 3. 高潮节点规划 → 中高潮和卷终高潮的章节位置 4. 新角色/新地点 → 本卷将引入的新元素 5. 伏笔规划 → 本卷埋设和回收的伏笔 ``` ### 章节分解表示例 | 章节 | 核心任务 | 爽点类型 | 关键情节 | 情绪曲线 | 状态 | |------|---------|---------|---------|---------|------| | 第01章 | 被退婚羞辱，激活系统 | 获得金手指 | 退婚现场、意外觉醒 | 低开高走 | 待写 | | 第02章 | 首次炼丹成功 | 突破认知 | 尝试炼丹、震惊自己 | 层层递进 | 待写 | | 第03章 | 宗门大比打脸赵天罡 | 打脸 | 炼丹比赛、碾压对手 | 低开高走 | 待写 | ### 规划质量检查 规划完成后自检以下项： - [ ] 每章都有明确的"核心任务" - [ ] 爽点分布均匀，没有连续3章无爽点 - [ ] 中高潮和卷终高潮位置合理 - [ ] 伏笔埋设和回收章节都已标注 - [ ] 本卷目标与大纲主线一致 ### 输出文件 章节规划保存到 `.learnings/章节规划_卷N.md`。 详见 `assets/VOLUME-PLAN-TEMPLATE.md`。 --- ## 第四步：逐章生成 ### 生成前必读 每次生成新章节前，**必须**读取以下文件： ``` output/大纲.md → 全局剧情走向 .learnings/章节规划_卷N.md → 本卷每章的核心任务 【新增】 .learnings/CHARACTERS.md → 当前所有角色的状态 .learnings/LOCATIONS.md → 已出现的地点 .learnings/PLOT_POINTS.md → 已发生的关键情节 .learnings/STORY_BIBLE.md → 世界观设定和规则 ``` ### 章节生成模板 每章按以下结构生成： ```markdown # 第XX章 [章节名] > **本章概要**：一句话概括本章核心事件 > **本章爽点**：本章的主要爽感来源 > **情绪曲线**：低开高走 / 层层递进 / 反转爆发 --- （正文内容，2000-3000字） --- > **章末钩子**：留下的悬念，引导读者继续 ``` ### 章节质量标准 | 要素 | 要求 | | ------ | ------------------------------------------ | | 节奏 | 每章至少一个小爽点，不能平淡流水 | | 冲突 | 每章有明确的矛盾推动情节 | | 悬念 | 章末必须设置钩子，让人想看下一章 | | 连贯性 | 与前文角色状态、地点描写、已有情节保持一致 | | 递进感 | 主角能力/地位/见识要有可感知的成长 | | 对话 | 对话要有个性差异，反派不能太蠢 | ### 爽文节奏公式 ``` 每 1-2 章：小打脸（碾压小角色、获得小收获） 每 3-5 章：中打脸（击败阶段性对手、突破等级） 每 8-12 章：大高潮（翻转局势、揭示真相、大规模碾压） 每 15-20 章：卷终决战（解决卷级矛盾、主角阶段性质变） ``` --- ## 第五步：格式化处理【新增】 每章生成完毕后，调用 `format_chapter.py` 脚本处理章节文件中的分隔符。 ### 脚本位置 ``` scripts/format_chapter.py ``` ### 脚本功能 - 只保留章节文件首尾两个 `---` 分隔符 - 删除中间所有多余的分隔符 - 确保章节格式统一规范 ### 调用方式 ```bash # 处理单个文件 python3 scripts/format_chapter.py output/第01章_章名.md # 处理整个 output 目录 python3 scripts/format_chapter.py output/ ``` ### 处理时机 | 场景 | 操作 | |------|------| | 单章生成后 | 立即调用脚本处理该章节文件 | | 批量生成后 | 调用脚本处理整个 output 目录 | --- ## 第六步：章节审查【新增】 每章生成并格式化后，立即执行审查，确保长篇小说剧情不偏离、不穿帮、不重复。 ### 两种审查模式 | 模式 | 维度 | 适用场景 | 耗时 | |------|------|---------|------| | **快速审查** | 3维度 | 常规章节 | 约3分钟 | | **完整审查** | 9维度 | 关键章节/问题诊断 | 约10分钟 | ### 模式选择指南 | 场景 | 推荐模式 | |------|---------| | 常规章节生成后 | 快速审查 | | 卷末高潮章节 | 完整审查 | | 发现质量问题时 | 完整审查 | | 批量生成后 | 快速审查 + 抽样完整审查 | ### 快速审查（3维度） | 维度 | 检查内容 | |------|---------| | 核心任务达成 | 本章核心任务是否完成 | | 穿帮检测 | 角色/地点/时间线硬伤 | | 爽点结构完整性 | 打脸流程是否完整 | ### 完整审查（9维度） | 维度 | 检查内容 | 检测类型 | |------|---------|---------| | 一、核心任务达成 | 本章核心任务是否完成 | 量化 | | 二、有效信息占比 | 有效剧情字数占总字数比例 | 量化 | | 三、穿帮检测 | 角色/地点/能力/时间线硬伤 | 清单 | | 四、角色成长追踪 | 主角能力曲线、配角命运 | 轨迹 | | 五、套路重复检测 | 与前5章套路相似度 | 对比 | | 六、爽点结构完整性 | 打脸/突破结构是否完整 | 清单 | | 七、伏笔管理 | 新埋设/回收/长期预警 | 统计 | | 八、承接与前文连贯 | 与上章衔接、与前5章呼应 | 对比 | | 九、卷级目标进度 | 本卷目标推进程度 | 进度 | ### 穿帮检测清单 **角色状态穿帮**： - ❌ 死亡角色复活 - ❌ 受伤角色未说明已痊愈 - ❌ 角色位置矛盾 - ❌ 角色等级倒退 **地点穿帮**： - ❌ 地点特征矛盾（东城变西城） - ❌ 地点距离矛盾 - ❌ 已毁地点出现 **能力/等级穿帮**： - ❌ 主角等级无故倒退 - ❌ 装备消失未说明 - ❌ 金手指状态矛盾 **时间线穿帮**： - ❌ 时间倒流 - ❌ 间隔不合理 ### 角色成长追踪 **主角成长曲线**： - 等级、战斗力、社会地位、资产、人脉 - 连续5章无成长 = 预警 **配角命运追踪**： - 出场后超过15章未出现 = 预警 - 需回收或说明去向 ### 套路重复检测 与前5章对比，检测相似度： - ⚠️ 高预警：相似度 > 80% - ⚠️ 中预警：相似度 > 60% - ✅ 正常：相似度 < 60% ### 长期伏笔预警 | 预警级别 | 未回收章数 | |---------|-----------| | 🔴 严重 | >40章 | | 🟠 中度 | >30章 | | 🟡 轻度 | >20章 | ### 总体评级规则 - ✅ **优秀**：全部维度正常 - ⚠️ **良好**：1-2个维度预警 - ⚠️ **需调整**：3-4个维度预警 - ❌ **需重写**：严重问题或5+维度预警 ### 审查记录 审查结果汇总保存到 `.learnings/审查记录.md`，包含历史趋势追踪。 详见 `assets/REVIEW-TEMPLATE.md`。 --- ## 第七步：记忆管理 ### 写入时机 | 事件 | 记录到 | 何时写入 | | -------------------------------- | ------------------ | ---------------------- | | 新角色出场 | `CHARACTERS.md` | 该章生成完毕后立即写入 | | 角色状态变化（升级、受伤、死亡） | `CHARACTERS.md` | 更新对应角色条目 | | 新地点出现 | `LOCATIONS.md` | 该章生成完毕后立即写入 | | 关键情节发生 | `PLOT_POINTS.md` | 该章生成完毕后立即写入 | | 世界观规则补充 | `STORY_BIBLE.md` | 发现新设定时立即写入 | | 生成失败或质量差 | `ERRORS.md` | 失败后立即记录原因 | ### 读取时机 **每次生成新章节前**必须读取所有记忆文件，确保： - 不会让已死角色复活 - 不会把"东城"写成"西城" - 不会忘记上一章埋的伏笔 - 不会重复已有的情节桥段 --- ## 第八步：关键情节图解 当出现以下场景时，生成对应的图解： | 场景 | 图解内容 | | ---------- | ---------------------------- | | 关键战斗 | 双方站位、力量对比、胜负关键 | | 势力地图 | 各方势力的关系与分布 | | 等级突破 | 角色成长路线图 | | 人物关系 | 主要角色关系网 | | 重大剧情线 | 剧情时间线/因果链 | 图解使用 Mermaid 语法嵌入 md 文件，或使用图像生成工具生成。 ### 图解示例（Mermaid） **人物关系图：** ```mermaid graph TD A[主角·林凡] -->|师徒| B[师父·苍老人] A -->|宿敌| C[反派·赵天罡] A -->|暧昧| D[女主·苏婉儿] C -->|从属| E[赵家] D -->|出身| F[苏家] E -->|对立| F ``` **等级体系图：** ```mermaid graph BT L1[炼气期] --> L2[筑基期] L2 --> L3[金丹期] L3 --> L4[元婴期] L4 --> L5[化神期] L5 --> L6[大乘期] style L2 fill:#f9f,stroke:#333 ``` --- ## 第九步：失败记录 生成失败或质量不达标时，记录到 `.learnings/ERRORS.md`。 ### 常见失败场景 | 失败类型 | 描述 | 记录内容 | | -------- | -------------------- | -------------------------- | | 角色穿帮 | 已死角色再次出现 | 穿帮章节、角色名、正确状态 | | 设定矛盾 | 力量体系自相矛盾 | 矛盾点、涉及章节、修正方案 | | 节奏失控 | 连续多章无爽点 | 失控起始章节、节奏分析 | | 情节重复 | 相似桥段反复出现 | 重复内容、首次出现位置 | | 人设崩塌 | 角色行为违背人设 | 角色名、崩塌行为、原始人设 | | 生成中断 | 技术原因导致生成失败 | 错误信息、中断位置 | ### 失败记录格式 ```markdown ## [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` - 如果超过 99 章，使用三位数字：`第XXX章_章节名.md` --- ## 创作原则 ### 爽文核心要素 1. **强代入感** — 读者能轻松代入主角视角 2. **快节奏** — 不拖泥带水，每章有进展 3. **层层递进** — 敌人越来越强，主角越来越猛 4. **装逼打脸** — 被小看 → 展示实力 → 众人震惊，循环往复 5. **金手指合理** — 有挂但有规则，不是无限制开挂 6. **伏笔呼应** — 前文埋下的线索后文要收回来 ### 禁忌事项 - 不要连续两章以上没有爽点 - 不要让反派太愚蠢（衬托不出主角的强） - 不要忘记已有角色（出场后人间蒸发） - 不要突然修改已确立的设定 - 不要让主角无缘无故变弱（除非有合理剧情需要） --- ## 续写与中断恢复【新增】 长篇小说创作过程中经常会中断，需要能够从断点继续。 ### 续写前必读文件 续写时**必须**按顺序读取以下文件： ``` 1. output/大纲.md → 确认全局走向 2. .learnings/章节规划_卷N.md → 确认当前卷的任务规划 3. .learnings/CHARACTERS.md → 所有角色当前状态 4. .learnings/LOCATIONS.md → 已出现的地点 5. .learnings/PLOT_POINTS.md → 已发生的关键情节 + 待回收伏笔 6. .learnings/STORY_BIBLE.md → 世界观设定 7. .learnings/审查记录.md → 最近的问题和预警【新增】 8. output/第(最新)章.md → 上一章内容，确保衔接 ``` ### 续写流程 ``` 1. 检查当前进度 - 已完成章节：检查 output/ 目录中的章节数量 - 当前卷：根据章节号确定当前卷 - 待回收伏笔：检查 PLOT_POINTS.md 中状态为"进行中"的条目 2. 确认下一章任务 - 从章节规划中提取下一章的"核心任务" - 检查是否有近期需要回收的伏笔 - 检查是否有消失过久的配角需要回归 3. 生成下一章 - 按标准章节生成流程执行 - 注意与上一章的衔接 ``` ### 续写检查清单 续写前自检： - [ ] 已读取所有记忆文件 - [ ] 已确认当前章节号 - [ ] 已确认下一章核心任务 - [ ] 已检查待回收伏笔 - [ ] 已检查配角消失情况 ### 常见续写场景 | 场景 | 处理方式 | |------|---------| | 中断后继续 | 读取所有记忆文件 + 上一章，继续生成 | | 跨卷续写 | 先生成新卷的章节规划，再续写 | | 修改后续写 | 确认修改内容已更新到记忆文件，再续写 | | 问题修正后续写 | 先阅读 ERRORS.md 和审查记录，确认问题已解决 | --- ## 初始化新小说 使用初始化脚本快速创建一部新小说的工作区： ```bash ./scripts/init-novel.sh 小说名称 ``` 这会创建： - `output/` 目录 - 清空 `.learnings/` 中的旧记录（保留模板头部） - 提示你输入小说方向 详见 `scripts/init-novel.sh`。 --- ## 与 self-improving-agent 的协作 本技能的 `.learnings/` 系统参考了 `self-improving-agent` 的设计理念： | self-improving-agent | novel-generator | | -------------------- | --------------------- | | 记录代码错误 | 记录剧情穿帮 | | 记录知识空白 | 记录设定矛盾 | | 提升到 CLAUDE.md | 沉淀到 STORY_BIBLE.md | | 提取为技能 | 提炼为创作模式 | 核心思想一致：**捕获 → 记录 → 沉淀 → 复用**。

path: _meta.json
content: ownerId: qutongyuan
slug: fiction-crafter
version: 1.1.0
publishedAt: 1773127332892

path: .learnings/LOCATIONS.md
content: # 地点档案

记录所有已出现的地点信息，确保空间描写一致。

**更新规则**：新地点出现时添加，地点发生变化（被毁/升级）时更新。

---


path: .learnings/ERRORS.md
content: # 生成错误日志

记录生成过程中出现的问题，用于优化后续创作。

**更新规则**：生成失败、质量不达标、连贯性问题时记录。

---


path: .learnings/STORY_BIBLE.md
content: # 故事圣经

世界观核心设定，一经确立不可随意修改。新设定补充时追加。

---


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)