awesome-novel
和 AI 一起写小说 —— Claude Code 原生支持
个人使用免费 — 本 Skill 对个人用户完全免费。
商业使用 — 请联系作者获取授权。
让 AI 成为你的小说创作搭档,从世界观搭建到角色塑造，从章节规划到正文写作，一步步陪你完成整部小说。
|
|
- 安装了 Claude Code 的电脑
- 大概 1 分钟完成安装
复制下面这行命令，在终端里粘贴执行：
git clone https://github.com/modoojunko/awesome-novel-skill.git && cd awesome-novel-skill && ./install.sh claude-code如果上面那行不行，手动来：
git clone https://github.com/modoojunko/awesome-novel-skill.git
cd awesome-novel-skill
mkdir -p ~/.claude/skills/awesome-novel
cp -r agents ~/.claude/skills/awesome-novel/
cp -r skills ~/.claude/skills/awesome-novel/
cp -r templates ~/.claude/skills/awesome-novel/
cp -r knowledge ~/.claude/skills/awesome-novel/
cp -r memory ~/.claude/skills/awesome-novel/
cp -r tools ~/.claude/skills/awesome-novel/
cp SKILL.md ~/.claude/skills/awesome-novel/
echo "安装完成!"看到 "安装完成" 就可以了。
看到这个项目觉得有用？ 顺手点个 Star，这样它会出现在你的 GitHub 首页，让更多人发现。 {: .prompt-info }
安装后，打开终端，在你想放小说项目的目录下启动你的 AI 工具，然后说一句：
帮我写本小说
系统会自动加载写作流程。后续再进入该项目时，说 @novel-agent 或 "帮我继续写" 就能从中断处恢复。
Agent 会引导你完成后续步骤。系统由 8 个 AI Agent 协作驱动，自动检测进度、调度任务，你只需确认方向和审阅内容。
novel-agent（总指挥 — 顶层入口，由 @novel-agent 加载）
├─ setup 阶段 → 调度 updater（设定写入）
├─ outline 阶段 → 调度 volume-planner（卷纲）→ chapter-planner（章纲）
├─ draft 阶段 → 调度 prompt-crafter（提示词）→ writer（正文）
├─ anti-ai 阶段 → 调度 anti-ai（去 AI 味）
├─ review 阶段 → 调度 reader（深度评审，可选）
└─ archive 阶段 → 调度 updater（归档 + lore-keeping）
novel-agent 只负责调度和验证，不直接写内容。子 agent 各司其职，完成后清理任务标记。
第一次写小说时，Agent 会和你聊这几个方面。不用一次性想好全部，想不到的跳过，后面随时补：
- 题材选择 — 仙侠、都市、悬疑、历史……说你脑子里想的那个就行。Agent 会按题材类型自动配置写作风格和节奏模板。也可以直接从 24 套预置题材画像里选一个，省去手动调风格的步骤
- 世界观 — 故事发生在什么世界？有什么特殊规则？（比如"修仙世界，灵根决定天赋"）
- 主要角色 — 主角是谁？TA 是什么样的人？Agent 会逐个角色和你讨论性格、能力、成长经历
- 写作风格 — 偏好更偏描写还是更偏对话、更古风还是更现代？也可以导入你喜欢的小说来提取文风
设定聊完后，Agent 会在当前目录下创建你的小说项目，结构如下：
{你的小说文件夹}/
├── story.md # 项目总索引（元信息/主线/卷规划）
├── CLAUDE.md # 项目级 CLAUDE.md（tools 白名单）
├── settings/ # 设定文件
│ ├── world-setting.md # 世界观
│ ├── writing-style.md # 写作风格
│ ├── genre-setting.md # 题材设定
│ ├── timeline.md # 时间线
│ └── character-setting/ # 角色档案
│ └── <id>.md # 每角色一个文件
├── volumes/ # 卷纲（情绪走向/冲突阶梯/信息差/场景卡）
├── chapters/ # 章纲
├── prompts/ # 提示词
├── archives/ # 正文（定稿）
├── .agent/ # Agent 进度 + 任务通信
│ ├── status.md # 进度标记（phase/volume/chapter）
│ └── task/ # 子 agent 间 order 文件
└── .claude/ # Agent 定义 + 知识库 + 写作记忆
├── agents/ # 8 个 Agent 定义（初始化时部署）
├── knowledge/ # 格式规范、反 AI 规则、文风偏好、永久记忆
└── memory/ # 写作动态记忆（各环节作者反馈）
├── volume-memory.md
├── chapter-memory.md
├── prompt-memory.md
└── writing-memory.md
这些全是纯文本 Markdown 文件，你可以直接用编辑器打开看或手动改。
设定聊完后，Agent 帮你规划整体故事结构。规划分四个维度同时推进：
- 情绪走向 — 读者读这卷从头到尾情绪怎么变化？爽卷就是"压抑→压抑→提升→打脸→装逼"，悬疑卷就是"紧张→逼近→震惊→舒缓"
- 冲突阶梯 — 核心冲突拆成 2-4 层逐级升高的障碍，每层比前一层更难，层间有关键转折点
- 信息差 — 明确"谁知道什么、谁不知道什么"。卷定义起点→终点，每章演绎信息差的动态变化（设→用→揭→新）
- 场景卡 — 每章拆成 2-5 个场景卡，每卡三要素：主角想干啥、有什么拦着他、有什么悬念让读者想看下去
不知道结局？ 告诉 Agent"我只知道开头"，它照样帮你规划第一卷。
多 Agent 协作自动推进，novel-agent（总指挥）按进度调度子 agent，你只需审阅和决策：
| 步骤 | 负责 Agent | 做什么 |
|---|---|---|
| ① 章纲 | chapter-planner | （由 novel-agent 调度）继承卷的情绪走向/冲突阶梯/信息差位置，设计章内微弧线、小冲突阶梯和信息差动态变化，拆成场景卡。你看完后说"可以"或"改一下" |
| ② 提示词 | prompt-crafter | （由 novel-agent 调度）根据章纲、反 AI 规则和文风偏好，组装 6 元素纯净提示词 |
| ③ 写正文 | writer | （由 novel-agent 调度）按提示词写完整一章 |
| ④ 去 AI 味 | anti-ai | （由 novel-agent 调度）Gate A-F 管线检测清除 AI 痕迹，量化评分定级 |
| ⑤ 审阅 | reader（可选） | （由 novel-agent 调度）10 维 60+ 细项深度评审，对照章纲/设定/前文逐条诊断 |
| ⑥ 归档 | updater | （由 novel-agent 调度）你确认后归档定稿，自动更新角色状态、追加情绪弧线、合并文风偏好、检测钩子健康和卷边界 |
调度规则： @novel-agent 是顶层入口，由主 AI 加载后扮演总指挥角色。novel-agent 通过 Agent 工具调度子 agent，不直接代劳写作任务。子 agent 完成后清理任务标记，novel-agent 检测到后自动推进下一阶段。
第一章写完后，Agent 会问"下一章继续吗？"
- 去 AI 味（prompt-crafter + writer + anti-ai）：提示词组装时注入反 AI 规则，正文生成时自查，独立 anti-ai agent 做 Gate A-F 管线检测和量化评分定级
- 动态记忆（多 agent + updater）：各 agent 在对话中实时记录你的写作偏好和反馈（正反案例），归档时 updater 兜底清理、去重压缩。高频使用的规则自动晋升为永久记忆（
.claude/knowledge/permanent-memory.md），越写越懂你 - 记伏笔（updater）：归档时自动扫描未兑现/新埋的钩子，检测陈旧度和集中收束风险
- 管角色状态（updater）：每章归档后自动追加角色状态历史、情绪弧线和人际关系变化。下一章写作时 Agent 知道最新状态
- 节奏检查（updater）：连续高压超过 3 章或连续平淡超过 2 章，提醒你调整
- 卷边界检测（updater）：整卷完成后自动输出报告，询问下一卷方向
| 你说 | AI 做什么 |
|---|---|
| "帮我写本小说" | 首次加载技能 + 创建项目 + 设定讨论 |
| "@novel-agent" 或 "帮我继续写" | 进入 / 恢复写作循环 |
| "写下一章" | 开始写最新一章 |
| "改一下第 X 段" | 修改指定段落 |
| "这章写完了" 或 "归档" | 确认本章完成 |
| "看看进度" | 查看当前写了多少 |
| "导入这本小说" | 导入已有草稿继续写 |
| "迁移项目" | 从旧版自动迁移到 4.0 格式 |
| "solo" 或 "你全权写" | 进入全自动模式，不打断你确认 |
| 模式 | 触发词 | 行为 |
|---|---|---|
| 步步确认（默认） | — | 每做一步都等你点头才继续 |
| 全部授权 | "你全权决定" | 流程节点还在，Agent 代按确认，不经你手 |
随时可以切换，跟 Agent 说一声就行。
不想从头设定写作风格？Agent 在一次性设定阶段就会问你用不用预置风格。项目内置 24 套题材档案，每套包含角色人设倾向、叙事语气和章节提示词模板。涵盖仙侠、都市、悬疑、历史、科幻末世、西方奇幻等主流类型。
Q: 我不会编程，能装吗？
能。上面那几行命令复制粘贴到终端，回车就行。唯一的前提是你的电脑上已经装好了 Claude Code。
Q: 我升级了技能，之前写的小说项目怎么迁移到新格式？
升级后首次在当前项目目录启动时，Agent 会自动检测旧版格式，引导你完成迁移。核心逻辑：旧文件整体挪到 old/ 目录保留备份，在原地初始化新项目骨架，再逐字段将旧版设定转换到新版格式。已归档的正文直接拷贝，正在写的不迁移。确认迁移无误后可手动删除 old/ 目录。
Q: 写到一半可以改设定吗？
可以。随时跟 Agent 说"改一下世界观里的 XXX"或"这个角色的性格我想调整"，它会帮你更新。
Q: 生成的文字有 AI 味怎么办？
默认配置就是"低 AI 味"——禁止了常见机器腔句式、写完后自动检测。动态记忆系统会记录你如何修改 AI 原文，提炼为你的专属规则，后续自动规避。
Q: 可以用自己的写作风格吗？
可以。项目创建后有专门的写作风格文件，你可以把自己的偏好写进去，后面所有章节都会按这个风格来。
本项目部分设计受到 InkOS 的启发——包括 AI 味检测体系、伏笔/钩子追踪、题材配置和分层技法模型。感谢 @Narcooo 的优秀工作。
欢迎参与贡献！详情请查看 CONTRIBUTING.md。
| 方式 | 说明 |
|---|---|
| Bug 反馈 | 报告功能异常、安装问题 |
| 功能建议 | 提出新功能或改进想法 |
| 素材扩充 | 补充题材档案、文风特征库 |
| 提交 PR | 修复 bug、优化代码或文档 |
如果你是有创作经验的作家，欢迎为反AI写作库贡献题材正反例：
贡献内容： knowledge/anti-ai/{genre}.md — 你所在题材的高频AI病句正反例
贡献格式：
# {题材名}反AI规则
> 适用题材：{genre-id}
## 高频AI病句正反例
### 1. {问题类型}
❌ "AI味的写法"
✅ "真人感的写法"
## 写作要点
1. **{要点}** — 说明正反例原则：
- ❌ 要具体：给真实的AI味句子，不是抽象描述
- ✅ 要可执行：给可复制的真人感写法，不是"要自然"
- 每类问题包含一对对照，同一场景、同一情绪，转化清晰
提交方式：
- Fork 项目
- 在
knowledge/anti-ai/下新建或编辑题材文件 - 提交 PR，标题格式：
反AI: 添加{题材名}正反例
见 knowledge/anti-ai/README.md。
项目结构：
awesome-novel-skill/
├── agents/ # 多 Agent 协作
│ ├── novel-agent.md # 总指挥
│ ├── volume-planner.md# 叙事架构师
│ ├── chapter-planner.md# 场景设计师
│ ├── prompt-crafter.md# 提示词工程师
│ ├── writer.md # 写手
│ ├── anti-ai.md # 反 AI 编辑
│ ├── reader.md # 测试读者
│ └── updater.md # 档案管理员
├── skills/ # Agent 技能 SOP
├── knowledge/ # 知识库（→ 项目 .claude/knowledge/）
│ ├── format-specs/ # 格式规范
│ ├── scene-craft/ # 场景写作方法论（四步转化后注入输出·写作规范）
│ ├── plot-craft/ # 剧情设计（与作者讨论）
│ ├── character-craft/ # 角色设定（与作者讨论）
│ ├── title-craft/ # 取书名（与作者讨论）
│ ├── genre-example/ # 题材案例
│ └── anti-ai/ # 反AI写作库（通用规则 + 题材正反例）
├── memory/ # 动态记忆（→ 项目 .claude/memory/）
│ └── writer-style
└── tools/ # 工具脚本
开发规范：
- 代码遵循 PEP 8（Python）或项目既有风格
- 所有子技能修改需更新对应 SKILL.md
- 新增功能需更新 README 和 CONTRIBUTING.md
提交方式：
- Fork 项目，创建功能分支
- 提交 PR，标题格式：
类型: 简短描述（feat/fix/refactor/docs/test） - PR 描述包含：改了什么、为什么改、测试方式
本 Skill 由多个子技能模块组成，每个模块可独立改进：
| 模块 | 路径 | 贡献方向 |
|---|---|---|
| Agent/Skill | agents/ + skills/ |
改进 agent 定义、新增 skill SOP |
| 格式规范 | knowledge/format-specs/ |
改进各环节规范文档 |
| 场景写法 | knowledge/scene-craft/ |
新增/改进场景写作方法论（四步转化后注入输出·写作规范） |
| 剧情设计 | knowledge/plot-craft/ |
新增/改进剧情设计方法论（与作者讨论） |
| 角色设定 | knowledge/character-craft/ |
新增/改进角色设定方法论 |
| 反AI写作库 | knowledge/anti-ai/ |
新增题材正反例、丰富通用规则及方法论 |
| 题材画像 | knowledge/genre-example/ |
新增题材档案、丰富配置内容 |
贡献流程：
- 阅读目标模块的 SKILL.md 了解当前逻辑
- 在测试项目（如有）中验证改动效果
- 提交 PR，附上改动说明和验证结果
Skill 贡献原则：
- 改动需有明确的问题驱动（"因为XX问题，所以改XX"）
- 新增功能需向后兼容，不破坏现有项目
- 复杂改动先提 Issue 讨论再实现