long-novel-writer
当用户需要写长篇小说、扩展小说创意、构建小说架构、生成正文章节或进行章节定稿更新时使用。此技能提供了一套完整的五阶段工作流,通过外部文档驱动状态机的方式,保障百万/千万级别小说的连贯性。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/jiaw-zh--long-novel-writer)HTML
<a href="/listings/jiaw-zh--long-novel-writer"><img src="/api/listings/jiaw-zh--long-novel-writer/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
**OpenClaw / 支持 OpenClaw Skills 的 agent:**
Install this skill: https://github.com/jiaw-Zh/long-novel-writer
**Claude Code:**
Install this Agent Skill from GitHub as a personal Claude Code skill: https://github.com/jiaw-Zh/long-novel-writer
**Codex:**
Use $skill-installer to install this skill from GitHub: https://github.com/jiaw-Zh/long-novel-writer
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
SKILL.md · Manifest · 66 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- ---
- name: long-novel-writer
- description: 当用户需要写长篇小说、扩展小说创意、构建小说架构、生成正文章节或进行章节定稿更新时使用。此技能提供了一套完整的五阶段工作流,通过外部文档驱动状态机的方式,保障百万/千万级别小说的连贯性。
- ---
- # 长篇小说写作器
- ## 核心定位
- 按"架构先行、分卷推进、状态驱动、检索校验"的方式创作百万至千万字级别小说。
- 不要一次性生成整部长篇正文。每次只推进一个明确层级:整书架构、卷规划、3-5 章小单元、单章正文、记忆更新、修订审校。
- ## 工作流
- 1. **作品初始化**
- - 读取或创建作品目录时,先看 `references/file-contract.md`(文件布局 + 立项 checklist + 导入 checklist)与 `references/memory-protocol.md`(记忆协议)。
- - **场景分支**:
- - 用户只有一句创意 → 走 dev 分支的"AI 创建小说"链路:扩展创意 → 提炼构思 → 故事核心 → 小说整体设定;然后走「立项 checklist」。
- - 用户已有设定(无正文)→ 直接走「立项 checklist」:metadata → 设定正典 → 实体档案 → 网文额外项 → 章节目录 → 空壳文件。
- - **用户已有正文但无记忆结构 → 走「导入既有作品 checklist」(13 步)**,用 `reverse_story_bible_prompt` / `extract_entities_prompt` / `canon_backfill_prompt` 等反推记忆层,然后从 N+1 章继续写。
- - `story-bible.md` 立项/导入时即写定并视为冻结基线,后续修订必须追加「变更记录」。
- 2. **百万字架构**
- - 将故事拆成:整书主线 -> 卷 -> 篇章单元 -> 3-5 章 chunk -> 单章。
- - 每卷必须有显性目标、隐藏危机、阶段反派或阻力、角色状态变化、伏笔回收表。
- - 对千万字目标,默认启用 `memory-protocol.md` 的分层摘要(L0–L5)+ 实体档案 + 章节索引。禁止只靠"一份不断覆盖的前文摘要"撑长篇。
- 3. **章节生成**
- - 写正文前先按 `memory-protocol.md` 第四节「写前组装协议」加载上下文(9 个固定步骤),不要凭感觉读文件。
- - 上下文至少覆盖:story-bible、当前卷/篇章摘要(前期缺失时以 story-bible 替代)、当前 + 下一章 blueprint、最近 3-5 章 L1 brief、上一章结尾段原文、出场实体档案、活跃伏笔、禁用桥段、关键词反查到的相关章节 brief。
- - 选择提示词按 `references/prompt-workflow.md`。第一章用 `first_chapter_draft_prompt_v2`,后续章节用 `next_chapter_draft_prompt_v2`。
- - 单章正文只输出正文,除非用户要求分析或拆解。
- 4. **章节落盘与记忆更新**
- - 正文生成后先跑 `memory-protocol.md` §5「写后校验闭环」:**前置字数门**(机械检查 `[word_min, word_max]`,偏短调 `enrich_prompt_v2`、偏长调 `condense_prompt_v2`、偏离 >30% 直接重写)+ 正典冲突检测、硬约束违背、桥段重复、伏笔账本对齐。
- - 通过后按固定顺序落盘:
- 1. `chapter-NNNN.md`(L0 正文)
- 2. `chapter-NNNN.brief.md`(L1,300-500 字,写完即冻结)
- 3. `chapter-NNNN.index.md`(YAML 章节索引)
- 4. `canon/facts.jsonl` 追加本章约束性事实(含 `known_by`)
- 5. `canon/promises.jsonl` 追加本章承诺/誓言变化
- 6. `canon/progression.jsonl` 追加本章境界/能力进阶
- 7. `canon/timeline.md` / `canon/rules.md` 追加更新
- 8. 相关实体档案追加「关键节点」+「变更记录」,更新「最后出场」「已知秘密」
- 9. `foreshadowing-ledger.md` + `subplots.md` 状态更新
- - 到达 chunk/arc/volume 末章时,生成对应 L2/L3/L4 摘要;卷结束时重生成 L5 `summaries/global.md`(旧版归档到「历史版本」段)。
- - **禁止回改已冻结的 L1/L2/L3/L4**。事实纠错走 `continuity-issues.md` + canon retraction 条目 + 实体档案变更记录。
- 5. **一致性审校**
- - 对长篇连载,默认进行"设定冲突、角色 OOC、伏笔遗漏、节奏断裂、重复桥段"检查。
- - 如果用户接入外部 RAG API 或知识库,保留外部检索能力;不要把"没有本地向量库"理解为不需要长期记忆。本项目的 `chapter-*.index.md` + 实体档案 + keywords 检索已足够支撑。
- ## 提示词使用原则
- - 原始提示词全文在 `references/prompts/`,先查 `references/prompt-index.md`。
- - 旧分支提示词适合完整写作链路:角色、世界观、剧情架构、章节目录、章节正文、摘要、知识库、角色状态、一致性。
- - dev 分支提示词适合从一句创意生成结构化小说基础信息。
- - 可以组合提示词,但不要机械拼贴。先判断任务层级,再选择最小必要 prompt。
- - 用户要求百万/千万字时,优先使用 `references/long-serial-method.md` 的长篇机制,而不是只放大章节数。
- - 体裁模式由 `metadata.md` 的 `体裁模式` 字段控制(网文/严肃文学/通用),决定提示词的写作约束分支。网文模式启用爽点密度、打脸循环、章末钩子等专用规则;严肃文学模式保留潜台词、心理深度等要求。
- - 摘要类提示词在新协议下的用法:`chapter_brief_prompt` 生成 L1;`chunk/arc/volume/global_summary_prompt` 分别生成 L2-L5;`update_character_state_prompt_v2` 输出落入实体档案「当前状态」段 +「变更记录」追加。
- ## 输出习惯
- 用中文回应中文请求。先给可执行结果,再给必要说明。创作时少讲道理,多产出可直接进入作品档案的内容。规划要清晰、有阶段、有回收点;正文要有场景推进、人物行动和情绪压力。
README.md · README · 118 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 长篇小说生成 SKILL
- > 原始项目:[AI_NovelGenerator](https://github.com/YILING0013/AI_NovelGenerator)
- 一个面向百万/千万字长篇的 AI 写作 SKILL,解决长篇小说后期走形的核心问题。
- ## 为什么需要这个
- AI 写长篇小说有一个根本性问题:**上下文窗口装不下整部作品**。即使是 1M token 的窗口,对 300 万字的小说也远远不够。结果是:
- - 早期设定被后期章节覆盖稀释,角色性格漂移
- - 数值、能力、物品归属前后矛盾
- - 伏笔埋了忘了回收,或回收时对不上原文
- - 配角消失几十章后再出场,agent 只能现编
- - 同类桥段反复出现,读者审美疲劳
- 这个 SKILL 用结构化记忆系统解决上述问题,而不是靠"更大的上下文窗口"。
- ## 核心特色
- ### 分层摘要冻结
- 将作品摘要拆为六层:L0(正文)→ L1(单章)→ L2(chunk)→ L3(篇章)→ L4(卷)→ L5(全书)。每层写定后冻结,不再被后续章节覆盖。彻底消除"电话传话"式的早期细节稀释。
- ### 实体中心档案
- 角色、地点、道具、势力、力量体系各自独立建档,包含硬约束、追加式时间线和变更记录。写作时只按需加载本章出场实体,精准且省 token。典型写前上下文用量 25k–40k token,1M 窗口极度宽裕。
- ### 正典账本(Canon Ledger)
- 五个只追加不修改的结构化文件:
- - `canon/facts.jsonl` — 原子事实断言,带原文引用和 `known_by` 字段
- - `canon/promises.jsonl` — 角色承诺/誓言,带截止日期
- - `canon/progression.jsonl` — 境界/能力进阶轨迹,校验单调性
- - `canon/rules.md` — 世界规则
- - `canon/timeline.md` — 时间线
- 写后校验时按实体过滤账本,数值漂移、能力越界、死而复生等硬冲突在落盘前即被拦截。
- ### POV 知识边界
- `facts.jsonl` 的 `known_by` 字段追踪每条秘密"谁知道"。写前加载出场角色的已知信息列表,防止角色使用尚未获得的信息——这是长篇后期最常见的 OOC 类型。
- ### 写前组装协议
- 9 步固定流程决定每章写作前载入哪些文件,包括:活跃伏笔、到期承诺、失踪副线提醒、关键词反查相关章节。
- ### 写后双 agent 校验
- 前置字数门(机械检查目标字数 ± 容差)+ 8 项语义校验(正典冲突 / POV 知识边界 / 硬约束 / 进阶合法性 / 命名一致性 / 桥段重复 / 伏笔对齐 / 场景打分)+ 固定落盘顺序。字数偏短自动扩写、偏长自动缩写、严重偏离重写。支持独立 subagent 执行校验,避免写作 agent 自我合理化。
- ### 命名一致性
- `naming.md` 标准名称表记录每个实体的规范写法和禁用变体,写后校验自动检测。
- ### 副线与配角追踪
- `subplots.md` 追踪所有副线的最后推进章节。超过 20 章未推进的副线会在写前自动提示。
- ### 记忆快照与分叉写作
- 每 50 章或每卷收尾快照记忆层(不含正文,正文走 git)。出问题可回滚,想探索"如果当时选了另一条路"可以从快照建分支独立续写。
- ### 体裁模式(网文 / 严肃文学)
- `metadata.md` 的 `体裁模式` 字段控制提示词的写作约束分支:
- - **网文模式**:爽点密度、打脸循环、章末钩子、具体数值、金手指节奏
- - **严肃文学模式**:潜台词冲突、心理深度、隐喻系统、认知颠覆
- ### 网文专用提示词
- 5 个专为网络小说设计的提示词:
- - 章末钩子(10 种模式交替)
- - 打脸三段式
- - 开篇三章黄金结构
- - 境界突破章四段式
- - 金手指设计与升级路线
- ## 使用方法
- 安装后直接给 agent 发送指令:
- ```text
- "我想写一本小说"
- "我想写一本300万字的穿越修真逆袭小说"
- ```
- agent 会引导完成:创意扩展 → 世界观/角色设定 → 分卷架构 → 逐章生成 → 记忆更新。
- ## 安装
- **OpenClaw / 支持 OpenClaw Skills 的 agent:**
- ```text
- Install this skill: https://github.com/jiaw-Zh/long-novel-writer
- ```
- **Claude Code:**
- ```text
- Install this Agent Skill from GitHub as a personal Claude Code skill: https://github.com/jiaw-Zh/long-novel-writer
- ```
- **Codex:**
- ```text
- Use $skill-installer to install this skill from GitHub: https://github.com/jiaw-Zh/long-novel-writer
- ```
- ## 分支说明
- | 分支 | 说明 |
- |---|---|
- | `dev` | 主开发分支,记忆系统 + 提示词,无 CLI 工具依赖。任何 OS / shell 环境都能跑 |
- | `dev-tools` | 在 dev 基础上叠加 `tools/lnw` CLI(bash + jq)。Linux / macOS / Git Bash / WSL 均可;PowerShell / cmd 不可,需切回 dev |
- | `main` | 稳定版(待 dev 验证后合入)|
- ## 项目结构
- ```
- SKILL.md # Agent 工作流主文件
- references/
- memory-protocol.md # 记忆协议(分层摘要、正典账本、写前/写后流程)
- file-contract.md # 作品文件目录契约
- long-serial-method.md # 百万字长篇机制
- prompt-workflow.md # 提示词选择与使用流程
- prompt-index.md # 提示词索引
- prompts/
- prompt-templates.md # 完整写作链路提示词模板
- dev-prompt_default.yaml # 从创意生成小说基础信息
- consistency-check-prompt.md # 写后一致性校验提示词
- ```
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.