💡 项目说明：本工具集的灵感来源于两套开源网文创作工具： webnovel-writer 和 oh-story-claudecode。 两个skill我都是用了，在我看来两者各有优势——一个强在工程化管理，一个强在情绪驱动方法论—— 于是用 AI（Codex / Claude）将它们的设计精髓融合成了这套 fiction-* 工具集。 在此对原项目作者表示感谢。
我不懂编程，这个 skill 是用 Codex 接入 DeepSeek 4 写的。
然后DeepSeek大概写出问题来了，又用GLM 5.2修的。
用 AI 帮你写网文的工具包，从构思到完本一条龙。 面向番茄小说等免费阅读平台。核心思路：先想好每章要让读者有什么感受，再动笔写。
- 先定情绪，再定故事：动笔前先想好这一章要让读者感受到什么——爽？虐？甜？ suspense？
- 不用记流程：该写大纲的时候系统会提醒你，该写正文的时候也知道
- 系统自动判断：自动识别这章适合普通模式还是深度写作模式
- 改一处，自动检测最近 10 章受影响范围：修改了一章内容，系统会自动看看有没有影响后面的剧情和设定
| 技能 | 它能干什么 | 直接对 AI 说这句话就行 | 阶段 |
|---|---|---|---|
| fiction | 主入口，自动帮你找到对应的功能 | 「我想写小说」「帮我写书」「写网文」「开新书」 | 全局 |
| fiction-conceive | 和 AI 一起琢磨故事点子、设计角色、确定文风 | 「聊聊构思」「帮我设计角色」「我想写个什么样的故事」 | 准备 |
| fiction-setup | 自动建好写小说需要的文件夹结构 | 「建项目」「准备写书」「搭环境」「从零开始」 | 准备 |
| fiction-start | 正式开写前检查准备是否充分，锁定故事设定 | 「开书」「可以动笔了」「准备好了，开始吧」 | 锁定 |
| fiction-scan | 看看平台上现在什么类型最火 | 「扫榜」「最近流行什么」「什么火」「市场怎么样」 | 参考 |
| fiction-analyze | 分析热门小说是怎么写的，学人家的结构和技巧 | 「拆文」「分析这本书」「帮我拆一下」「学学这本书」 | 参考 |
| fiction-plan | 规划每一卷的节奏、时间线和每章的大纲 | 「规划」「做大纲」「后面怎么写」「帮我规划一下」 | 写作前 |
| fiction-write | 写正文 + 章节修改（写作 Normal/Deep 双模式 + 修改 Re-craft/Rewrite 两种内建模式） | 「写第X章」「续写」「接着写」「修改第X章」「重写」「回炉」 | 核心 |
| fiction-review | 帮你看写得怎么样（可以看一章、多章或整卷） | 「审查」「帮我看下写得怎么样」「审一下」 | 质量 |
| fiction-polish | 让文字更自然，去掉 AI 味 | 「润色」「去AI味」「这篇太AI了」「帮我顺一下文字」 | 质量 |
| fiction-query | 问系统角色叫什么、设定是什么、前面埋了什么伏笔 | 「查角色」「查设定」「什么状态」「那个角色叫啥来着」 | 全局 |
| fiction-learn | 把写得好的写法存下来，以后继续用 | 「记住这个写法」「这招存起来」「以后都这么写」 | 全局 |
| fiction-doctor | 检查项目有没有文件缺失、设定是否完整 | 「体检」「帮我看看项目有没有问题」「检查一下」 | 管理 |
| fiction-export | 写完后导出全文，归档保存 | 「导出」「完本」「导出txt」「我要完本了」 | 收尾 |
| fiction-import | 把以前写的小说导入到这套工具里 | 「导入」「我有现成的稿子」「把我的书导进来」 | 辅助 |
把 skills/ 文件夹安装到 Codex，推荐让 AI 帮你做：
把这个项目下载到电脑上，然后对 Codex 说：
「请把我项目里 skills/ 目录下的技能安装到 Codex」
AI 会自动完成安装。
本工具需要同时安装 skills/ 和 scripts/ 两个目录。 推荐用方法一（让 AI 帮你装），AI 会自动处理依赖关系。
手动安装命令（需要整个仓库目录）：
# macOS / Linux
cp -r skills/* ~/.codex/skills/
cp -r scripts/* ~/.codex/scripts/
# Windows (PowerShell)
Copy-Item -Path "skills/*" -Destination "$env:USERPROFILE\.codex\skills\" -Recurse -Force
Copy-Item -Path "scripts/*" -Destination "$env:USERPROFILE\.codex\scripts\" -Recurse -Force- Python 3.8+（可选，部分辅助功能用到 scripts/ 下的脚本）
- 扫榜功能需要安装
browser-cdp（可选）
SKILL.md 中的脚本使用 bash 语法（export、$(...)、${VAR:-default}），Windows 用户需要以下任一环境：
- Git Bash（推荐，安装 Git for Windows 时自带）
- WSL（Windows Subsystem for Linux）
- MSYS2 或 Cygwin
PowerShell 和 CMD 无法直接运行这些脚本。建议安装 Git for Windows 后使用自带的 Git Bash。
本工具同时兼容 Codex 和 Claude Code 两种环境。SKILL.md 中的脚本会按以下优先级查找环境变量：
- 项目根目录：先查
CODEX_PROJECT_DIR，没有则查CLAUDE_PROJECT_DIR，都没有则用$PWD - 插件根目录：先查
CODEX_PLUGIN_ROOT，没有则查CLAUDE_PLUGIN_ROOT
无论用哪种环境都能正常工作，无需额外配置。
不需要记命令，直接跟 AI 聊天就行：
直接说「帮我建个项目」 → 自动创建项目文件夹
直接说「聊聊构思」 → 和 AI 聊你的小说点子
直接说「开书」 → 正式开写前的准备工作
直接说「规划一下」 → 规划第 1 卷怎么安排
直接说「写第一章」 → 开始写第一章（系统自动选深度模式）
直接说「修改第5章」 → 进入修改模式（自动判断大改/重写）
构思阶段：题材/主角/冲突/文风
↓ （可以穿插扫榜看什么火、拆文学写法）
conceive → 和 AI 一起打磨构思
↓
start → 检查准备 → 锁定设定 → 建好故事底稿
↓
plan → 卷的节奏安排 → 时间线 → 每章大纲
↓
write → 开始写作（系统自动推荐模式、提醒你该做什么）
↓
write（修改模式） → 改了一处，系统自动检查后续 10 章有没有受影响
↓
review → 质量检查（可单章/多章/整卷）
polish → 润色，去掉 AI 味
↓
export → 写完导出全文
写每章时系统自动判断用哪种方式：
| 什么时候用 | 用哪种模式 | 什么意思 |
|---|---|---|
| 第一章 / 每卷开头结尾 / 高潮情节 / 重要节点 | 深度模式 | 六步完整写作流程，写完自动更新故事设定 |
| 普通推进剧情的章节 | 普通模式 | 四步标准流程，轻快高效 |
写完第 1/5/10 章、每卷最后一章时，系统会主动弹出建议，不用自己记。
| 修改方式 | 改剧情？ | 自动检查后续影响？ | 调用方式 | 适用场景 |
|---|---|---|---|---|
| 小修（润色） | ❌ | ❌ | fiction-polish |
只调文字、润色 |
| 大改（Re-craft） | ✅ | ✅ 自动传播 | fiction-write（内建） |
改剧情，系统自动看后面有没有矛盾 |
| 重写（Rewrite） | ✅ 全部 | ✅ 全链路刷新 | fiction-write（内建） |
推翻重来，全链路刷新 |
项目/
├─ .novel/ # 系统文件（不用管）
│ ├─ state.json # 记录写到哪了、当前模式
│ ├─ project_memory.json # 存着你觉得好的写法
│ └─ tmp/ # 临时文件
├─ .story-system/ # 故事核心设定（世界观、主线等）
├─ 设定集/ # 世界观、角色、能力体系
├─ 大纲/ # 总纲、各卷节奏、章节大纲
├─ 正文/ # 你写的每一章
├─ 追踪/ # 伏笔、时间线、故事线索
└─ 审查报告/ # 系统审查后给你的建议
MIT License — 自由使用、修改、分享。
本工具由 AI（Codex / Claude）辅助生成。
设计参考了以下开源项目：
- 仓库: lingfengQAQ/webnovel-writer
- 贡献: 项目管理的工程化思路（统一状态管理、故事设定体系、审查流程等）
- 仓库: worldwonderer/oh-story-claudecode
- 贡献: 情绪驱动写作方法论（先定情绪再定故事）、丰富的写作参考库、扫榜拆文流程、去 AI 味技巧
本项目融合了两者的设计精髓：以情绪驱动的方法论为核心，以工程化的数据模型为骨架。