awesome-novel

和 AI 一起写小说。本 skill 负责项目状态检测、新项目初始化、旧版项目自动迁移，完成后将控制权交给 novel-agent。

` 检测项目状态 ├─ story.yaml 存在 → 旧版 2.x → 执行自动迁移（见下文） ├─ story.md 不存在 → 询问作者是否初始化 → 是则执行 init.py │ └─ python tools/init.py [project-path] [--genre <编号>] → 完成后 @novel-agent └─ story.md 存在 → 已有项目 ├─ 检查同步新鲜度 │ ├─ python tools/sync-project.py . --check → exit 0 → 已最新，略过 │ ├─ python tools/sync-project.py . --check → exit 1 → 有更新 │ │ └─ 展示变更文件，询问作者是否同步 │ │ ├─ 确认 → 运行 python tools/sync-project.py . │ │ └─ 跳过 → 继续 │ └─ .agent/.sync-fingerprint 不存在（首次） │ └─ 静默运行 python tools/sync-project.py . → 写入指纹 └─ → @novel-agent 继续写作 ` 强制规则： • story.md 不存在时，先询问作者是否要在此目录创建小说项目，确认后再运行 init.py • 禁止未经确认直接执行 init.py • 确认后必须运行 init.py，禁止手动创建目录结构替代 • 禁止在 skill 安装目录（含 skills/awesome-novel 路径）内运行 init.py — 此目录是技能仓库，不是小说项目 • 如果当前目录是 skill 安装目录，应提示作者切换到目标目录后再执行 • init.py 执行完毕后，确认 .agent/status.md 和 .claude/agents/ 已生成，方可进入 @novel-agent • 如果 init.py 报错，必须先修复问题重新执行，不允许绕过

全新项目先询问作者是否初始化，确认后运行 init.py（项目路径可选，默认当前目录）： ` python tools/init.py [project-path] [--genre <编号>] ` 禁止以任何理由跳过 init.py： 手动创建目录、复制模板、直接调用 agent 都属于违规行为。init.py 是初始化入口，必须执行且完整运行。 init.py 会： • 选题材 • 创建项目骨架（settings/、volumes/、chapters/、prompts/、archives/） • 部署 agent 定义到 .claude/agents/ • 按题材继承反 AI 规则和文风偏好到 .claude/knowledge/ • 按题材继承格式规范、题材案例到 .claude/knowledge/ • 创建空白的写作记忆文件（.claude/memory/*.md） • 创建永久记忆占位文件（.claude/knowledge/permanent-memory.md） • 生成 CLAUDE.md • 初始化状态文件 .agent/status.md 以上 9 步全部由 init.py 自动完成，AI 无需也不应手动干预。 检查： 运行后确认 .agent/status.md 存在且内容正确，方可进入 @novel-agent。

init.py 完成后进入 @novel-agent，此时 phase=setup，按以下流程： • novel-agent 检测到 setup 阶段，与作者逐项讨论设定（世界观/角色/风格/题材）。如果作者需要帮忙取书名，参考 knowledge/title-craft/index.md 的方法论给出建议 • 讨论完毕后，novel-agent 写 order 文件 .agent/task/setting-update-order.md • novel-agent 通过 Agent 工具调用 updater • updater 读取 order，写入 settings/world-setting.md、settings/genre-setting.md、settings/character-setting/*.md 等设定文件 • updater 清理 order 文件并结束 • novel-agent 确认 order 已清理，推进 phase → outline，进入卷纲规划 权限规则： novel-agent 不得直接写 settings/ 下的文件，设定写入必须通过 updater 的 setting-update 模式完成。