awesome-novel — скилл

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

# 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）

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

## dsh 集成说明

本 skill 也支持 DeepSeek Harness（dsh，DeepSeek 官方的开源 agent harness）。dsh 的 skill 约定（目录 + `SKILL.md`，frontmatter 只认 `name`/`description`）与 Claude Code 同源，天然兼容；但 dsh 无项目级 agents 目录（subagent 是运行时能力），agents 即 skills。skill 本体**用户级安装**到 `~/.dsh/skills/awesome-novel/`；`init.py --platform dsh` 初始化小说项目时，把 9 个 agent 部署为项目级 `.dsh/skills/<name>/SKILL.md`（与 ZCode 同构，另含 memory-recording、roleplay-sandbox 独立工具，共 11 个 skill；`<项目根>/.dsh/skills/` 是 dsh 的项目级 skill 根，自动发现且优先级最高）：
- novel-agent — 总指挥（入口调度者，由 dsh 按 name/description 自动路由，无 `@` 语法）
- writer、volume-planner、chapter-planner 等 — 子 agent（subagent skill，由 novel-agent 用 `subagent` 工具调度）

**调度机制：** novel-agent 写 order 文件到 `.agent/task/`（`status: pending`）→ 用 `subagent` 工具调度子 agent（prompt 中要求子 agent 先调用 `skill(name="<子agent名>")` 加载自身指令；子 agent 名 = `.dsh/skills/` 下的 skill 名）→ 子 agent 读取 order 执行 → 完成后将 order 覆盖为 `status: DONE` 后退回。order 文件协议与其余平台完全一致。