lazygophers/plugins/tools/novelist/skills/novelist-init

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

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

工作流(按序执行)

1. 取参数 — 从用户输入取「小说名」(必需) 与「类型」(可选, 如 玄幻/科幻/悬疑)。缺小说名 → 硬停, 用 AskUserQuestion 问, 禁自行编名。
2. 定父目录 — 默认当前工作目录。若用户指定路径则用之。
3. 审批门 — 确认创建参数 — 执行脚本前向用户汇报: 小说名 / 父目录绝对路径 / 类型(若有)。用 AskUserQuestion 确认「确认创建 / 取消」。用户取消 → 退出, 不建目录。
4. 跑脚手架 — 执行:

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