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 插件的入口。完成后所有写作动作都在此目录环境内进行。