让 AI agent成为你的小说创作搭档。从世界观搭建到角色塑造,从章节规划到正文写作,一步步陪你完成整部小说。
$ npx -y skills add modoojunko/awesome-novel-agent --agent claude-code
Repo: modoojunko/awesome-novel-agent
What's inside
个人使用免费 — 本 Skill 对个人用户完全免费。 商业使用 — 请联系作者获取授权。
让 AI 成为你的小说创作搭档,从世界观搭建到角色塑造,从章节规划到正文写作,一步步陪你完成整部小说。
遇到问题、交流写作心得、催更或提建议,欢迎进群,作者常在。
QQ 交流群 2群:
1006050538进群后可直接提问,或和大伙儿分享你写的小说。
如果这个项目对你有帮助,可以请我喝杯咖啡 ☕
一杯咖啡,不是合同。不影响 issue 优先级和功能方向。
pip install pyyaml;系统 Python 权限受限时用 pip install --user pyyaml)不用复制粘贴命令。 打开你正在使用的 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/ |
| Grok Build | ~/.grok/skills/awesome-novel/ |
看到 "安装完成" 就可以了。想手动安装时,克隆仓库后运行 ./install.sh <平台>(平台:claude-code / opencode / codex / zcode / dsh / grok);Windows 用 PowerShell 时运行 install.ps1 <平台>。install.sh / install.ps1 同时兼容 deepseek-tui / hermes / openclaw(非主推平台)。安装脚本会先检查 Python 版本(需要 3.9+)和 pyyaml 依赖(仅 opencode / codex / zcode / dsh / grok),不满足会直接中止并给出升级 / 安装提示,不会等到 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
Grok Build:
Grok Build 的 skill 约定(目录 + SKILL.md)与 Claude Code 同源,天然兼容;自定义 agent 走项目 .grok/agents/*.md(Grok 原生发现路径)。skill 本体走 install.sh 用户级安装,项目内容由 init.py --platform grok 项目级部署到 .grok/:
./install.sh grok
python ~/.grok/skills/awesome-novel/tools/init.py <小说项目路径> --platform grok
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 集成 说明。
Grok Build 用户注意: skill 安装到
~/.grok/skills/awesome-novel/,初始化后 9 个自定义 agent 以 Markdown 形式部署在项目.grok/agents/下(Grok 原生发现),独立工具部署为.grok/skills/。novel-agent 必须在主会话运行。详情见下方 Grok Build 集成 说明。
看到这个项目觉得有用? 顺手点个 Star,这样它会出现在你的 GitHub 首页,让更多人发现。 {: .prompt-info }
安装好本体后,在你想放小说项目的目录下启动 Claude Code / OpenCode / Codex / ZCode / DeepSeek Harness / Grok Build,输入:
/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 自动路由)。Grok Build 用户输入 /awesome-novel 或说 "帮我写本小说"。
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 会在当前目录下创建你的小说项目,结构如下:
{你的小说文件夹}/
├── 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/ # 写作动态记忆
└── .grok/ # Grok Build 用(七选一)
├── agents/ # 9 个自定义 agent(Markdown,初始化时部署)
├── skills/ # 独立交互工具(memory-recording、roleplay-sandbox)
├── knowledge/ # 格式规范、反 AI 规则、文风偏好、永久记忆
└── memory/ # 写作动态记忆
这些全是纯文本 Markdown 文件,你可以直接用编辑器打开看或手动改。实际项目只生成一套平台目录(由 init.py --platform 决定),.claude/ / .opencode/ / .reasonix/ / .codex/ / .zcode/ / .dsh/ / .grok/ 不会同时存在。
设定聊完后,Agent 帮你规划整体故事结构。规划分四个维度同时推进:
不知道结局? 告诉 Agent"我只知道开头",它照样帮你规划第一卷。
多 Agent 协作自动推进,novel-agent(总指挥)按进度调度子 agent,你只需审阅和决策:
| 步骤 | 负责 Agent | 做什么 |
|---|
FAQ
modoojunko-awesome-novel-agent is a Claude Code plugin with 1 hand-picked skill for content work, indexed on Flowy. Install it with the command on its page. It includes awesome-novel-agent. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
Is this plugin yours?
Claim it with GitHubSubmit a pluginPromote it