awesome-novel-agent

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 本体装到你机器上：

看到 "安装完成" 就可以了。想手动安装时，克隆仓库后运行 ./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 首页，让更多人发现。

开始写小说

安装好本体后，在你想放小说项目的目录下启动 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 会和你聊这几个方面。不用一次性想好全部，想不到的跳过，后面随时补：

1. 题材选择 — 仙侠、都市、悬疑、历史……说你脑子里想的那个就行。Agent 会按题材类型自动配置写作风格和节奏模板。也可以直接从 24 套预置题材画像里选一个，省去手动调风格的步骤
2. 世界观 — 故事发生在什么世界？有什么特殊规则？（比如"修仙世界，灵根决定天赋"）
3. 主要角色 — 主角是谁？TA 是什么样的人？Agent 会逐个角色和你讨论性格、能力、成长经历
4. 写作风格 — 偏好更偏描写还是更偏对话、更古风还是更现代？也可以导入你喜欢的小说来提取文风

项目结构

设定聊完后，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 帮你规划整体故事结构。规划分四个维度同时推进：

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

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

逐章写作循环（Agent 协作）

多 Agent 协作自动推进，novel-agent（总指挥）按进度调度子 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）：整卷完成后自动输出报告，询问下一卷方向

常用指令

两种协作模式

随时可以切换，跟 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。

写作风格贡献（作家）

如果你是有创作经验的作家，欢迎为反AI写作库贡献题材正反例：

贡献内容： knowledge/anti-ai/{genre}.md — 你所在题材的高频AI病句正反例

贡献格式：

# {题材名}反AI规则

> 适用题材：{genre-id}

## 高频AI病句正反例

### 1. {问题类型}

❌ "AI味的写法"
✅ "真人感的写法"

## 写作要点

1. **{要点}** — 说明

正反例原则： - ❌ 要具体：给真实的AI味句子，不是抽象描述 - ✅ 要可执行：给可复制的真人感写法，不是"要自然" - 每类问题包含一对对照，同一场景、同一情绪，转化清晰

提交方式： 1. Fork 项目 2. 在 knowledge/anti-ai/ 下新建或编辑题材文件 3. 提交 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

提交方式： 1. Fork 项目，创建功能分支 2. 提交 PR，标题格式：类型: 简短描述（feat/fix/refactor/docs/test） 3. 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 由多个子技能模块组成，每个模块可独立改进：

贡献流程： 1. 阅读目标模块的 SKILL.md 了解当前逻辑 2. 在测试项目（如有）中验证改动效果 3. 提交 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 同步最新框架。