Name: awesome-novel-agent
Author: modoojunko

awesome-novel
和 AI 一起写小说 —— 支持 Claude Code / OpenCode / Reasonix / Codex / ZCode / DeepSeek Harness

个人使用免费 — 本 Skill 对个人用户完全免费。
商业使用 — 请联系作者获取授权。

让 AI 成为你的小说创作搭档,从世界观搭建到角色塑造，从章节规划到正文写作，一步步陪你完成整部小说。

加入交流群

遇到问题、交流写作心得、催更或提建议，欢迎进群，作者常在。

QQ 交流群 2群：1006050538 进群后可直接提问，或和大伙儿分享你写的小说。

他放下草药，站起来，朝着王虎离开的方向追了几步。王虎听到脚步声回头，还没来得及说话，叶秋的拳头已经到了——一拳结结实实砸在他脸上。

王虎整个人往后退了两步，捂着脸，嘴边的笑僵在半道上。

"你——"

叶秋没让他把话说完。第二拳挥出去的时候，旁边那两个跟班已经反应过来了。一左一右扑上来抱住他的胳膊，把他往后拖。王虎趁机一脚踹在他肚子上，叶秋弓着腰往后退了两步，膝盖一软跪在地上。

—— 摘自《我靠炼丹逆天改命》第一卷第一章 · 由 awesome-novel 生成

如果这个项目对你有帮助，可以请我喝杯咖啡 ☕
一杯咖啡，不是合同。不影响 issue 优先级和功能方向。

你需要什么

安装了 Claude Code、OpenCode、Reasonix、Codex、ZCode 或 DeepSeek Harness（dsh） 的电脑
Python 3.9+（macOS 系统自带 3.9 即可用；推荐 3.11+）
OpenCode / Codex / ZCode / dsh 平台还需 pyyaml（pip install pyyaml；系统 Python 权限受限时用 pip install --user pyyaml）
大概 1 分钟完成安装

安装

不用复制粘贴命令。 打开你正在使用的 AI 工具（Claude Code / OpenCode / Codex / ZCode / DeepSeek Harness），对它说：

帮我安装 awesome-novel-agent

AI 会自动从仓库 https://github.com/modoojunko/awesome-novel-agent 下载（若它说找不到，就把这个仓库地址发给它），并运行准备好的安装脚本 ./install.sh <平台>，把 skill 本体装到你机器上：

平台	安装位置
Claude Code	`~/.claude/skills/awesome-novel/`
OpenCode	`~/.config/opencode/skills/awesome-novel/`
Codex	`~/.codex/skills/awesome-novel/`
ZCode	`~/.zcode/skills/awesome-novel/`
DeepSeek Harness	`~/.dsh/skills/awesome-novel/`

看到 "安装完成" 就可以了。想手动安装时，克隆仓库后运行 ./install.sh <平台>（平台：claude-code / opencode / codex / zcode / dsh）；Windows 用 PowerShell 时运行 install.ps1 <平台>。install.sh / install.ps1 同时兼容 deepseek-tui / hermes / openclaw（非主推平台）。安装脚本会先检查 Python 版本（需要 3.9+）和 pyyaml 依赖（仅 opencode / codex / zcode / dsh），不满足会直接中止并给出升级 / 安装提示，不会等到 init.py / sync-project.py 执行时才报错。

Reasonix：

Reasonix 的 skill 是项目级部署（装在每个小说项目的 .reasonix/skills/），不走 install.sh。对 Reasonix 说 "帮我安装 awesome-novel-agent"，它会克隆仓库并用 init.py 在你的目标目录直接初始化小说项目：

git clone https://github.com/modoojunko/awesome-novel-agent.git && cd awesome-novel-agent
python tools/init.py <小说项目路径> --platform reasonix
cd <小说项目路径> && reasonix code

用 --genre <编号> 指定预置题材，不传则交互式选题材。

ZCode：

ZCode 的 skill 约定与 Claude Code 同源（目录 + SKILL.md），但无项目级 agents 目录——项目内的 9 个 agent 以 skill 形式部署（agents 即 skills）。skill 本体走 install.sh 用户级安装，项目内容由 init.py --platform zcode 项目级部署到 .zcode/：

./install.sh zcode
python ~/.zcode/skills/awesome-novel/tools/init.py <小说项目路径> --platform zcode

DeepSeek Harness（dsh）：

dsh 的 skill 约定与 Claude Code 同源（目录 + SKILL.md），但无项目级 agents 目录——项目内的 9 个 agent 以 skill 形式部署（agents 即 skills），<项目根>/.dsh/skills/ 是 dsh 的项目级 skill 根（自动发现，优先级最高）。skill 本体走 install.sh 用户级安装，项目内容由 init.py --platform dsh 项目级部署到 .dsh/：

./install.sh dsh
python ~/.dsh/skills/awesome-novel/tools/init.py <小说项目路径> --platform dsh

OpenCode 用户注意： 安装路径为 ~/.config/opencode/skills/awesome-novel/，初始化后 agent 定义部署在项目 .opencode/agents/ 下，OpenCode 自动发现。详情见下方 OpenCode 集成说明。

Codex 用户注意： skill 安装到 ~/.codex/skills/awesome-novel/，初始化后 9 个自定义 agent 以 TOML 形式部署在项目 .codex/agents/ 下，Codex 自动发现。详情见下方 Codex 集成说明。

ZCode 用户注意： skill 安装到 ~/.zcode/skills/awesome-novel/，初始化后 9 个 agent 以 SKILL.md 形式部署在项目 .zcode/skills/ 下（ZCode 无项目级 agents 目录，agents 即 skills），ZCode 自动发现。详情见下方 ZCode 集成说明。

DeepSeek Harness 用户注意： skill 安装到 ~/.dsh/skills/awesome-novel/，初始化后 9 个 agent 以 SKILL.md 形式部署在项目 .dsh/skills/ 下（dsh 无项目级 agents 目录，agents 即 skills），dsh 自动发现。详情见下方 dsh 集成说明。

看到这个项目觉得有用？ 顺手点个 Star，这样它会出现在你的 GitHub 首页，让更多人发现。 {: .prompt-info }

开始写小说

安装好本体后，在你想放小说项目的目录下启动 Claude Code / OpenCode / Codex / ZCode / DeepSeek Harness，输入：

/awesome-novel

（Codex 输入 /use awesome-novel，或者直接说 "帮我写本小说"。）

skill 会自动检测目录状态：新目录会先和你确认，然后运行 init.py 在本地初始化小说工作空间（项目骨架、agent 定义、知识库、记忆文件），完成后进入写作流程。后续再进入该项目时，说 @novel-agent 或 "帮我继续写" 就能从中断处恢复。

Reasonix 用户在项目目录运行 reasonix code 后，输入 @novel-agent 进入写作流程。ZCode 用户在项目目录说 "帮我写本小说" 或 "帮我继续写" 即可（ZCode 无 @ 语法，agents 即 skills，novel-agent 由 ZCode 自动发现）。DeepSeek Harness 用户同样直接说 "帮我写本小说" 或 "帮我继续写" 即可（dsh 的 skill 由模型按 name/description 自动路由）。

Agent 会引导你完成后续步骤。系统由 9 个 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）

上图是用户视角主线；完整调度表（含文风重蒸馏、归档后重写、记忆兜底等）见 skills/novel-dispatch.md。

novel-agent 只负责调度和验证，不直接写内容。子 agent 各司其职，完成后把 order 标记为 status: DONE 通知完成。

一次性设定

第一次写小说时，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       # 每角色一个文件
│   ├── style-profiles/   # 分场景风格卡（蒸馏产出：dialogue/fight/group-scene/…）
│   │   └── genre-baselines/  # 题材风格基线（base/benchmark/delta）
│   └── .style-versions/  # 蒸馏版本快照（style-distiller 蒸馏时生成）
├── volumes/              # 卷纲（情绪走向/冲突阶梯/信息差/场景卡）
├── chapters/             # 章纲
├── prompts/              # 提示词
├── sandbox/              # 剧情推演记录（可选，作者卡剧情时调用）
├── novel-samples/        # 文风蒸馏样本（把想学文风的文章放这里，style-distiller 专用）
├── archives/             # 正文（定稿）
├── .agent/               # Agent 进度 + 任务通信
│   ├── status.md         # 进度标记（phase/volume/chapter）
│   └── task/             # 子 agent 间 order 文件
├── .opencode/            # OpenCode 用（六选一，由 init.py --platform 决定）
│   ├── agents/           # 9 个 Agent 定义（初始化时部署）
│   ├── knowledge/        # 格式规范、反 AI 规则、文风偏好、永久记忆
│   └── memory/           # 写作动态记忆
├── .claude/              # Claude Code 用（六选一）
│   ├── agents/           # 9 个 Agent 定义（初始化时部署）
│   ├── knowledge/        # 格式规范、反 AI 规则、文风偏好、永久记忆
│   └── memory/           # 写作动态记忆（各环节作者反馈）
│       ├── volume-memory.md
│       ├── chapter-memory.md
│       ├── prompt-memory.md
│       └── writing-memory.md
├── .reasonix/            # Reasonix 用（六选一）
    ├── skills/           # 11 个 SKILL.md（agents 即 skills）
    ├── knowledge/        # 格式规范、反 AI 规则、文风偏好、永久记忆
    └── memory/           # 写作动态记忆
├── .codex/               # Codex 用（六选一）
    ├── agents/           # 9 个自定义 agent（TOML，初始化时部署）
    ├── skills/           # 独立交互工具（memory-recording、roleplay-sandbox）
    ├── knowledge/        # 格式规范、反 AI 规则、文风偏好、永久记忆
    └── memory/           # 写作动态记忆
├── .zcode/               # ZCode 用（六选一）
    ├── skills/           # 11 个 SKILL.md（agents 即 skills，初始化时部署）
    ├── knowledge/        # 格式规范、反 AI 规则、文风偏好、永久记忆
    └── memory/           # 写作动态记忆
└── .dsh/                 # DeepSeek Harness 用（六选一）
    ├── skills/           # 11 个 SKILL.md（agents 即 skills，初始化时部署）
    ├── knowledge/        # 格式规范、反 AI 规则、文风偏好、永久记忆
    └── memory/           # 写作动态记忆

这些全是纯文本 Markdown 文件，你可以直接用编辑器打开看或手动改。实际项目只生成一套平台目录（由 init.py --platform 决定），.claude/ / .opencode/ / .reasonix/ / .codex/ / .zcode/ / .dsh/ 不会同时存在。

规划故事骨架

设定聊完后，Agent 帮你规划整体故事结构。规划分四个维度同时推进：

情绪走向 — 读者读这卷从头到尾情绪怎么变化？爽卷就是"压抑→压抑→提升→打脸→装逼"，悬疑卷就是"紧张→逼近→震惊→舒缓"
冲突阶梯 — 核心冲突拆成 2-4 层逐级升高的障碍，每层比前一层更难，层间有关键转折点
信息差 — 明确"谁知道什么、谁不知道什么"。卷定义起点→终点，每章演绎信息差的动态变化（设→用→揭→新）
场景卡 — 每章拆成 2-5 个场景卡，每卡三要素：主角想干啥、有什么拦着他、有什么悬念让读者想看下去

不知道结局？ 告诉 Agent"我只知道开头"，它照样帮你规划第一卷。

逐章写作循环（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 完成后把 order 覆盖为 status: DONE（不删除文件），novel-agent 检测到后自动推进下一阶段。

第一章写完后，Agent 会问"下一章继续吗？"

自动做的事（Agent 维护）

蒸馏文风（style-distiller）：导入参考样本或利用已归档章节，自动提炼量化文风参数（句长/对话占比/形容词密度等），写入风格主卡与场景卡并按场景稀疏注入提示词；归档后增量校准，越写越贴合你的风格
去 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 做什么
"/awesome-novel" 或 "帮我写本小说"	加载技能 + 在当前目录初始化小说工作空间 + 设定讨论
"@novel-agent" 或 "帮我继续写"	进入 / 恢复写作循环
"写下一章"	开始写最新一章
"跑一下推演" 或 "剧情推演"	角色推演沙盘——卡剧情时让角色演一遍
"改一下第 X 段"	修改指定段落
"这章写完了" 或 "归档"	确认本章完成
"看看进度"	查看当前写了多少
"导入这本小说"	导入已有草稿继续写
"迁移项目"	从旧版自动迁移到 4.0 格式
"solo" 或 "你全权写"	进入全自动模式，不打断你确认

两种协作模式

模式	触发词	行为
步步确认（默认）	—	每做一步都等你点头才继续
全部授权	"你全权决定"	流程节点还在，Agent 代按确认，不经你手

随时可以切换，跟 Agent 说一声就行。

更高阶的玩法

预置题材画像

不想从头设定写作风格？Agent 在一次性设定阶段就会问你用不用预置风格。项目内置 24 套题材档案，每套包含角色人设倾向、叙事语气和章节提示词模板。涵盖仙侠、都市、悬疑、历史、科幻末世、西方奇幻等主流类型。

常见问题

Q: 我不会编程，能装吗？

能。打开你的 AI 工具，对它说"帮我安装 awesome-novel-agent，仓库在 https://github.com/modoojunko/awesome-novel-agent"，AI 会自己运行安装脚本，全程不用复制粘贴命令。唯一的前提是你的电脑上已经装好了 Claude Code、OpenCode、Reasonix、Codex 或 ZCode。

Q: 我升级了技能，之前写的小说项目怎么迁移到新格式？

升级后首次在当前项目目录启动时，Agent 会自动检测旧版格式，引导你完成迁移。核心逻辑：旧文件整体挪到 old/ 目录保留备份，在原地初始化新项目骨架，再逐字段将旧版设定转换到新版格式。已归档的正文直接拷贝，正在写的不迁移。确认迁移无误后可手动删除 old/ 目录。

Q: 写到一半可以改设定吗？

可以。随时跟 Agent 说"改一下世界观里的 XXX"或"这个角色的性格我想调整"，它会帮你更新。

Q: 生成的文字有 AI 味怎么办？

默认配置就是"低 AI 味"——禁止了常见机器腔句式、写完后自动检测。动态记忆系统会记录你如何修改 AI 原文，提炼为你的专属规则，后续自动规避。

Q: 可以用自己的写作风格吗？

可以。项目创建后有专门的写作风格文件，你可以把自己的偏好写进去，后面所有章节都会按这个风格来。

Star History

致谢

本项目部分设计受到 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-agent/
├── agents/              # 多 Agent 协作
│   ├── novel-agent.md   # 总指挥
│   ├── volume-planner.md# 叙事架构师
│   ├── chapter-planner.md# 场景设计师
│   ├── prompt-crafter.md# 提示词工程师
│   ├── writer.md        # 写手
│   ├── anti-ai.md       # 反 AI 编辑
│   ├── reader.md        # 测试读者
│   ├── updater.md       # 档案管理员
│   └── style-distiller.md# 风格蒸馏师
├── skills/               # Agent 技能 SOP + 交互式工具
├── knowledge/            # 知识库（→ 项目 .claude/knowledge/）
│   ├── format-specs/    # 格式规范
│   ├── scene-craft/     # 场景写作方法论（四步转化后注入输出·写作规范）
│   ├── plot-craft/      # 剧情设计（与作者讨论）
│   ├── character-craft/ # 角色设定（与作者讨论）
│   ├── title-craft/     # 取书名（与作者讨论）
│   ├── style-distill/   # 风格蒸馏（prompt-templates：渲染/验收/特征提取）
│   ├── genre-example/   # 题材案例
│   └── anti-ai/         # 反AI写作库（通用规则 + 题材正反例）
└── tools/                # 工具脚本

开发规范：

代码遵循 PEP 8（Python）或项目既有风格
所有子技能修改需更新对应 SKILL.md
新增功能需更新 README 和 CONTRIBUTING.md

提交方式：

Fork 项目，创建功能分支
提交 PR，标题格式：类型: 简短描述（feat/fix/refactor/docs/test）
PR 描述包含：改了什么、为什么改、测试方式

OpenCode 集成

本 skill 也支持 OpenCode（第三方开源的 AI 编码 CLI 工具）。

安装

在 OpenCode 里输入 "帮我安装 awesome-novel-agent"，它会自动运行 ./install.sh opencode，安装到 ~/.config/opencode/skills/awesome-novel/。

初始化项目

在目标目录输入 /awesome-novel，skill 会自动调用 init.py 初始化；也可手动运行：

python ~/.config/opencode/skills/awesome-novel/tools/init.py . --genre <编号>

开始写作

初始化完成后，在 OpenCode 中通过 /awesome-novel 或 @novel-agent 进入写作循环。

项目结构差异

OpenCode 项目与 Claude Code 项目结构一致，唯一区别是 agent 定义部署在 .opencode/agents/ 而非 .claude/agents/。各平台共享同一套写作流程和知识库。

Agent 技能贡献

本 Skill 由多个子技能模块组成，每个模块可独立改进：

模块	路径	贡献方向
Agent/Skill	`agents/` + `skills/`	改进 agent 定义、新增 skill SOP
角色推演沙盘	`skills/roleplay-sandbox.md`	改进推演交互协议、触发条件
格式规范	`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 讨论再实现

Reasonix 集成

本 skill 也支持 Reasonix（DeepSeek 专属终端 AI agent，借助字节稳定前缀缓存优化推理成本）。

与 Claude Code / OpenCode 不同，Reasonix 的 skill 是项目级部署——每个小说项目初始化时生成 .reasonix/skills/（11 个 SKILL.md，agents 即 skills），不装到全局。

安装框架源码

对 Reasonix 说 "帮我安装 awesome-novel-agent"，它会克隆仓库到本地（项目级部署，不装到全局）。

初始化项目

在项目目录（或指定路径）运行 init.py，指定 Reasonix 平台：

python tools/init.py <小说项目路径> --genre <编号> --platform reasonix

开始写作

初始化完成后，进入项目目录启动 Reasonix：

cd <小说项目路径> && reasonix code

然后输入 @novel-agent 进入写作循环。Reasonix 环境里 novel-agent 用 run_skill 调度子 agent，调度协议与其余平台一致。

项目结构差异

Reasonix 项目把 agent 定义以 skill 形式部署在 .reasonix/skills/，不产生 .claude/：

.reasonix/
├── skills/               # 11 个 SKILL.md（agents 即 skills）
│   ├── novel-agent/SKILL.md
│   ├── writer/SKILL.md
│   ├── volume-planner/SKILL.md
│   └── ...
├── knowledge/            # 反 AI 规则、文风偏好、永久记忆、格式规范
└── memory/               # 写作动态记忆

升级时用 python tools/sync-project.py <小说项目路径> --platform reasonix 同步最新框架。

Codex 集成

本 skill 也支持 Codex（OpenAI 的 AI 编码 agent）。skill 本体用户级安装，小说项目内的 agents/skills/knowledge/memory 全部项目级部署在 .codex/。

安装

在 Codex 里输入 "帮我安装 awesome-novel-agent"，它会自动运行 ./install.sh codex，安装到 ~/.codex/skills/awesome-novel/。

初始化项目

在 Codex 中打开目标目录，输入 /use awesome-novel（或说"帮我写本小说"），skill 会自动初始化；也可手动运行：

python ~/.codex/skills/awesome-novel/tools/init.py <小说项目路径> --genre <编号> --platform codex

初始化后 9 个自定义 agent 以 Codex 官方 TOML 格式部署到项目 .codex/agents/*.toml（name / description / developer_instructions），独立交互工具（memory-recording、roleplay-sandbox）部署为 .codex/skills/<name>/SKILL.md，反 AI 规则、文风偏好、格式规范与写作记忆分别落在 .codex/knowledge/、.codex/memory/。

开始写作

初始化完成后，在 Codex 中调用 /awesome-novel 或 @novel-agent 进入写作循环。Codex 环境里 novel-agent 用 spawn_agent 调度子 agent（agent 名 = .codex/agents/*.toml 的 name），order 文件协议与其余平台一致。

项目结构差异

.codex/
├── agents/               # 9 个自定义 agent（TOML）
│   ├── novel-agent.toml
│   ├── writer.toml
│   ├── volume-planner.toml
│   └── ...
├── skills/               # 独立交互工具（memory-recording、roleplay-sandbox）
├── knowledge/            # 反 AI 规则、文风偏好、永久记忆、格式规范
└── memory/               # 写作动态记忆

升级时用 python tools/sync-project.py <小说项目路径> --platform codex 同步最新框架。

ZCode 集成

本 skill 也支持 ZCode（开源的 AI 编码 agent 终端）。ZCode 的 skill 约定（目录 + SKILL.md）与 Claude Code 同源，天然兼容；但 ZCode 无项目级 agents 目录，项目内 9 个 agent 以 skill 形式部署（agents 即 skills）。skill 本体用户级安装，小说项目内的 agents/skills/knowledge/memory 全部项目级部署在 .zcode/。

安装

在 ZCode 里输入 "帮我安装 awesome-novel-agent"，它会自动运行 ./install.sh zcode，安装到 ~/.zcode/skills/awesome-novel/。

初始化项目

在 ZCode 中打开目标目录，说"帮我写本小说"，skill 会自动初始化；也可手动运行：

python ~/.zcode/skills/awesome-novel/tools/init.py <小说项目路径> --genre <编号> --platform zcode

初始化后 9 个 agent 以 SKILL.md 形式部署到项目 .zcode/skills/<name>/SKILL.md（与 Reasonix 同构，含 11 个 skill：9 个 agent + memory-recording、roleplay-sandbox 独立工具），反 AI 规则、文风偏好、格式规范与写作记忆分别落在 .zcode/knowledge/、.zcode/memory/。

开始写作

初始化完成后，在 ZCode 中打开项目目录，说 "帮我写本小说" 或 "帮我继续写" 进入写作循环（ZCode 无 @ 语法，novel-agent 由 ZCode 按 skill 自动发现）。ZCode 环境里 novel-agent 用 Agent 工具调度子 agent（子 agent 名 = .zcode/skills/ 下的 skill 名），order 文件协议与其余平台一致。

项目结构差异

.zcode/
├── skills/               # 11 个 SKILL.md（agents 即 skills）
│   ├── novel-agent/      # 总指挥（入口调度者）
│   ├── writer/           # 正文写手（subagent）
│   ├── volume-planner/   # 卷纲规划（subagent）
│   ├── ...
│   ├── memory-recording/ # 独立交互工具
│   └── roleplay-sandbox/ # 独立交互工具
├── knowledge/            # 反 AI 规则、文风偏好、永久记忆、格式规范
└── memory/               # 写作动态记忆

升级时用 python tools/sync-project.py <小说项目路径> --platform zcode 同步最新框架。

dsh 集成

本 skill 也支持 DeepSeek Harness（dsh，DeepSeek 官方的开源 agent harness）。dsh 的 skill 约定（目录 + SKILL.md，frontmatter 认 name/description）与 Claude Code 同源，天然兼容；但 dsh 无项目级 agents 目录（subagent 是运行时能力），项目内 9 个 agent 以 skill 形式部署（agents 即 skills）。skill 本体用户级安装，小说项目内的 agents/skills/knowledge/memory 全部项目级部署在 .dsh/（<项目根>/.dsh/skills/ 是 dsh 的项目级 skill 根，自动发现且优先级最高）。

安装

在 dsh 里输入 "帮我安装 awesome-novel-agent"，它会自动运行 ./install.sh dsh，安装到 ~/.dsh/skills/awesome-novel/。

初始化项目

在 dsh 中打开目标目录，说"帮我写本小说"，skill 会自动初始化；也可手动运行：

python ~/.dsh/skills/awesome-novel/tools/init.py <小说项目路径> --genre <编号> --platform dsh

初始化后 9 个 agent 以 SKILL.md 形式部署到项目 .dsh/skills/<name>/SKILL.md（与 Reasonix/ZCode 同构，含 11 个 skill：9 个 agent + memory-recording、roleplay-sandbox 独立工具），frontmatter 只保留 dsh 识别的 name/description；反 AI 规则、文风偏好、格式规范与写作记忆分别落在 .dsh/knowledge/、.dsh/memory/。

开始写作

初始化完成后，在 dsh 中打开项目目录，说 "帮我写本小说" 或 "帮我继续写" 进入写作循环（dsh 的 skill 由模型按 name/description 自动路由）。dsh 环境里 novel-agent 用 subagent 工具调度子 agent（prompt 中要求子 agent 先 skill(name="<子agent名>") 加载自身指令，子 agent 名 = .dsh/skills/ 下的 skill 名），order 文件协议与其余平台一致。

项目结构差异

.dsh/
├── skills/               # 11 个 SKILL.md（agents 即 skills）
│   ├── novel-agent/      # 总指挥（入口调度者）
│   ├── writer/           # 正文写手（subagent）
│   ├── volume-planner/   # 卷纲规划（subagent）
│   ├── ...
│   ├── memory-recording/ # 独立交互工具
│   └── roleplay-sandbox/ # 独立交互工具
├── knowledge/            # 反 AI 规则、文风偏好、永久记忆、格式规范
└── memory/               # 写作动态记忆

升级时用 python tools/sync-project.py <小说项目路径> --platform dsh 同步最新框架。

awesome-novel-agent

安装

快速入门

安全报告

README.md

加入交流群

你需要什么

安装

开始写小说

一次性设定

项目结构

规划故事骨架

逐章写作循环（Agent 协作）

自动做的事（Agent 维护）

常用指令

两种协作模式

更高阶的玩法

预置题材画像

常见问题

Star History

致谢

贡献

写作风格贡献（作家）

代码贡献（程序员）

OpenCode 集成

安装

初始化项目

开始写作

项目结构差异

Agent 技能贡献

Reasonix 集成

安装框架源码

初始化项目

开始写作

项目结构差异

Codex 集成

安装

初始化项目

开始写作

项目结构差异

ZCode 集成

安装

初始化项目

开始写作

项目结构差异

dsh 集成

安装

初始化项目

开始写作

项目结构差异

常见问题

评论 (0)

相关 Skills

开发者还喜欢