# Novelist Init

> novelist-init — 初始化小说目录环境

- Skill: `lazygophers/novelist-init` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add lazygophers/novelist-init`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lazygophers/novelist-init/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: lazygophers (https://skillmd.com/u/lazygophers)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lazygophers/novelist-init

---


# novelist-init — 初始化小说目录环境

为一部小说搭建细粒度的中文目录骨架, 让后续设定、编写、检查各有归属、互不冲突。

## 工作流(按序执行)

1. **取参数** — 从用户输入取「小说名」(必需) 与「类型」(可选, 如 玄幻/科幻/悬疑)。缺小说名 → 硬停, 用 `AskUserQuestion` 问, 禁自行编名。
2. **定父目录** — 默认当前工作目录。若用户指定路径则用之。
3. **审批门 — 确认创建参数** — 执行脚本前向用户汇报: 小说名 / 父目录绝对路径 / 类型(若有)。用 `AskUserQuestion` 确认「确认创建 / 取消」。用户取消 → 退出, 不建目录。
4. **跑脚手架** — 执行:
   ```bash
   # 有类型
   python3 ${CLAUDE_PLUGIN_ROOT}/skills/novelist-init/scripts/init_novel.py "<小说名>" --path <父目录> --genre "<类型>"
   # 无类型(省略 --genre)
   python3 ${CLAUDE_PLUGIN_ROOT}/skills/novelist-init/scripts/init_novel.py "<小说名>" --path <父目录>
   ```
   脚本创建: `人物/ 世界观/ 设定/ 大纲/ 情节/ 章节/ 元数据/` + 各层模板与索引文件。硬停: 脚本退出码 2(目标已存在且非空) → **禁直接加 `--force` 覆盖**, 先用 `AskUserQuestion` 问用户「换名 / 追加 / 取消」, 用户选追加才补 `--force`。
5. **回报结构** — 向用户列出生成的目录树, 说明每个目录归属哪个 skill(见 `总览.md` 的目录约定表)。
6. **导向下一步** — 提示: 用 `novelist-design` 做核心设计(主要剧情 + 主要人物)。

## 目录归属(防冲突的根基)

完整目录树与归属总表见 `references/directory-schema.md`(整套插件的唯一结构事实源)。速览:

| 目录 | 归属 skill | 内容 |
|---|---|---|
| 人物/<人物名>/ | novelist-character | 简介.md / 经历.md / 关系.md |
| 世界观/ + 设定/ | novelist-worldview | 地理/势力/规则/历史 + 其他设定 |
| 大纲/ + 情节/ | novelist-outline | 总纲/分卷 + 主线/支线/伏笔 |
| 章节/ | novelist-write / novelist-rewrite | 正文 + 章节索引 |
| 元数据/ | novelist-check / novelist-proofread | 进度 + 检查/校对报告 |

## 失败模式(触发 → 一线修复 → 仍失败兜底)

| 触发 | 一线修复 | 仍失败兜底 |
|---|---|---|
| 缺小说名 | `AskUserQuestion` 问用户 | 用户不给 → 退出, 不建目录 |
| 用户在 审批门 选「取消」 | 退出, 不建目录, 告知用户可重新调用 | — |
| 目标目录已存在且非空(脚本退出码 2) | 报告用户, 问是「换名 / 追加(--force) / 取消」 | 用户选追加 → 加 `--force` 重跑(不覆盖已有文件) |
| `python3` 不可用 | 提示用户安装 python3 | 仍无 → 退出并说明手动建目录方式 |

## 反例黑名单(命中=错, 重来)

| # | 禁做 | 改为 |
|---|---|---|
| 1 | 自行编一个小说名就建目录 | 缺名先 `AskUserQuestion` |
| 2 | 不跑脚本, 手动一个个 mkdir | 一律走 `init_novel.py`, 保证结构一致 |
| 3 | 无 --force 时强行覆盖已存在目录 | 先问用户, 尊重退出码 2 |
| 4 | 初始化时顺手写正文/设定内容 | 本 skill 只搭骨架, 内容交 design/character/worldview |

> 本 skill 是 novelist 插件的入口。完成后所有写作动作都在此目录环境内进行。