小说创作AI工作流

安装

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

帮我安装 awesome-novel-agent

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

看到 "安装完成" 就可以了。想手动安装时，克隆仓库后运行 ./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 }

安装

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

安装框架源码

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

安装

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

安装

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

安装

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

Grok Build 集成

本 skill 也支持 Grok Build（SpaceXAI 的编码 agent TUI）。skill 约定（目录 + SKILL.md）与 Claude Code 同源，天然兼容；自定义 agent 部署到项目 .grok/agents/*.md（Grok 原生发现路径）。skill 本体用户级安装，小说项目内的 agents/skills/knowledge/memory 全部项目级部署在 .grok/。

关键约束： novel-agent 必须在主会话运行。Grok 的子代理不能再派子代理（深度上限 1），把 novel-agent 当 subagent 会让调度链断裂。

安装

在 Grok Build 里输入 "帮我安装 awesome-novel-agent"，它会自动运行 ./install.sh grok（Windows 用 install.ps1 grok），安装到 ~/.grok/skills/awesome-novel/。

OpenCode 集成

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

Reasonix 集成

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

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

Codex 集成

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

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 根，自动发现且优先级最高）。

常见问题

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

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

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

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

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

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

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

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

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

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