# Awesome Novel

和 AI 协作写小说的工作流系统。9 个 agent 协作完成从设定到归档的完整写作流程。入口检测 → 初始化/迁移 → 交 novel-agent...

- Repository: https://github.com/modoojunko/awesome-novel-agent (852 stars)
- Category: AI and agents
- License: AGPL-3.0
- Last updated: 2026-09-25
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add modoojunko/awesome-novel-agent --skill awesome-novel -g -a claude-code -y`
Codex: `npx skills add modoojunko/awesome-novel-agent --skill awesome-novel -g -a codex -y`
Cursor: `npx skills add modoojunko/awesome-novel-agent --skill awesome-novel -g -a cursor -y`
Gemini CLI: `npx skills add modoojunko/awesome-novel-agent --skill awesome-novel -g -a gemini-cli -y`

## Description

和 AI 协作写小说的工作流系统。9 个 agent 协作完成从设定到归档的完整写作流程。入口检测 → 初始化/迁移 → 交 novel-agent 调度。适用场景：从零写新小说、导入已有小说。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Novel, 小说创作工作流

和 AI 一起写小说。本 skill 负责项目状态检测、新项目初始化、旧版项目自动迁移，完成后将控制权交给 novel-agent。

**唤起方式：** 用户在项目目录输入 `/awesome-novel`（Claude Code / OpenCode / Grok Build 直接输入；Codex 输入 `/use awesome-novel`；或说"帮我写本小说"）即进入下方检测流程。新目录会先询问作者，确认后运行 `init.py` 在本地初始化小说工作空间。

## OpenCode 集成说明

本 skill 也支持 OpenCode。安装在 `~/.config/opencode/skills/awesome-novel/` 后，项目初始化脚本会自动部署 agent 定义到 `.opencode/agents/`，OpenCode 即可自动发现：
- `@novel-agent`, 加载总指挥 agent
- `@volume-planner`、`@chapter-planner` 等, 加载子 agent
- **Task 工具**, novel-agent 通过 Task 工具调用子 agent

**调度机制：** novel-agent 写 order 文件到 `.agent/task/`（`status: pending`）→ Task 工具调用子 agent → 子 agent 读取 order 执行 → 完成后将 order 覆盖为 `status: DONE` 后退回。

## Codex 集成说明

本 skill 也支持 Codex。skill 本体**用户级安装**到 `~/.codex/skills/awesome-novel/`；`init.py --platform codex` 初始化小说项目时，把 9 个自定义 agent 部署为项目级 `.codex/agents/*.toml`（Codex 官方 TOML 格式，含 `name`/`description`/`developer_instructions`）：
- `@novel-agent`, 总指挥 agent（TOML 名 `novel-agent`）
- `@volume-planner`、`@chapter-planner` 等, 子 agent（TOML 名与源 agent 一致）
- **独立工具**, `memory-recording`、`roleplay-sandbox` 部署为 `.codex/skills/<name>/SKILL.md`

**调度机制：** novel-agent 写 order 文件到 `.agent/task/`（`status: pending`）→ 用 `spawn_agent` 调度子 agent（agent 名 = `.codex/agents/*.toml` 的 name）→ 子 agent 读取 order 执行 → 完成后将 order 覆盖为 `status: DONE` 后退回。order 文件协议与其余平台完全一致。

## ZCode 集成说明

本 skill 也支持 ZCode。ZCode 的 skill 约定（目录 + `SKILL.md`）与 Claude Code 同源，天然兼容；但 ZCode 无项目级 agents 目录，agents 即 skills。skill 本体**用户级安装**到 `~/.zcode/skills/awesome-novel/`；`init.py --platform zcode` 初始化小说项目时，把 9 个 agent 部署为项目级 `.zcode/skills/<name>/SKILL.md`（与 Reasonix 同构，另含 memory-recording、roleplay-sandbox 独立工具，共 11 个 skill）：
- novel-agent, 总指挥（入口调度者，由 ZCode 按描述自动发现，无 `@` 语法）
- writer、volume-planner、chapter-planner 等, 子 agent（subagent skill，由 novel-agent 用 Agent 工具按 skill 名 spawn）

The rest: https://github.com/modoojunko/awesome-novel-agent/blob/HEAD//SKILL.md