fiction-setup

name	fiction-setup
description	网络小说项目初始化。创建标准项目目录结构、初始配置文件(state.json)、 设定集骨架。在进入构思(fiction-conceive)前运行。 触发方式：/fiction-setup、「建项目」「初始化」「准备写书」「搭环境」「帮我建个项目」「从零开始」。

fiction-setup：项目初始化

创建标准项目骨架。只建目录和初始配置文件，不做深度构思。 构思由 fiction-conceive 完成。

执行流程

Phase 1：确认项目目录

export PROJECT_ROOT="${CODEX_PROJECT_DIR:-${CLAUDE_PROJECT_DIR:-$PWD}}"

• 检查是否已存在 .novel/state.json
• 存在则提示"该项目已初始化，可直接 fiction-start 或 fiction-conceive"
• 不存在则继续
• 询问用户书名，生成安全化目录名

Phase 2：创建标准目录结构

{项目根}/
├─ .novel/
│   ├─ state.json            # 由后续步骤填充
│   ├─ idea_bank.json        # 由 fiction-conceive 填充
│   └─ tmp/                  # 运行时临时文件
│
├─ 设定集/                    # 世界观、角色、力量体系等
├─ 大纲/                      # 总纲、卷纲、章纲
├─ 正文/                      # 各章正文
├─ 追踪/                      # 上下文、伏笔、时间线、角色状态
├─ 审查报告/                   # review-pipeline 产出
└─ 拆文库/                    # fiction-analyze 的分析产出

Phase 3：初始化 state.json

{
  "project": {
    "book_name": "",
    "genre": "",
    "target_words": 0,
    "target_platform": "fanqie",
    "author": ""
  },
  "progress": {
    "current_chapter": 0,
    "current_volume": 1,
    "total_chapters": 0,
    "total_volumes": 0,
    "writing_started": false
  },
  "versions": {
    "baseline_version": 0,
    "last_review_chapter": 0
  }
}

Phase 4：创建 .novel/active-book

写入当前书目录名，作为多书切换指针。

Phase 5：输出完成信息

• 列出创建的文件和目录
• 建议下一步：fiction-conceive（构思）或 fiction-start（如果已有想法）

参考

详细目录结构约定见 references/（暂无，按上述硬编码）。 nove-cover 在需要时单独调用，不在此处生成。 扫榜工具 fiction-scan 需要浏览器操作，详见该 skill。 拆文工具 fiction-analyze 需要提供小说文本，详见该 skill。

致谢

本 skill 的开发参考了以下开源项目的思路与实现：

• lingfengQAQ/webnovel-writer
• worldwonderer/oh-story-claudecode

感谢原作者的开源贡献。