oh-story-claudecode 是适配 Claude Code 生态的开源内容创作技能，依托多 Agent 分工机制，一站式完成大纲撰写、正文生成、排版出书与配套素材产出。

一、核心功能

oh-story-claudecode 是专为小说、专栏、纪实文稿打造的 Claude Code 专用 Skill 插件，依托 MCP 协议接入 AI 编程环境，把零散的文案创作流程标准化、自动化，整套能力围绕故事全生命周期搭建，从选题策划到最终成册导出形成闭环，共五大核心能力模块。

第一，分层式故事大纲智能拆解引擎。内置短篇、长篇小说、专栏连载、纪实文稿四类标准化目录模板，用户仅输入故事主题、受众定位、篇幅要求，系统自动拆分世界观设定、人物档案、分卷目录、单章节小节四级结构；多 Agent 分工分别负责世界观搭建、角色塑造、情节排布，避免逻辑断层，同时生成人物关系图谱、时间线 Markdown 文档，后续写作全程参考约束，杜绝人设崩塌、剧情前后矛盾问题。内置大纲自检脚本，自动筛查剧情漏洞、设定冲突，一键标注不合理段落并给出优化方案。

第二，分章节批量正文自动化撰写。支持按卷 / 按章分批生成文稿，可自由切换网文通俗风、文学写实风、纪实严谨风三类行文范式；Agent 拆分主笔、校对两个角色，主笔负责正文内容创作，校对实时核对人设、前文伏笔、设定规则，生成内容自动对齐前期大纲，无需人工反复提醒历史设定；支持长文断点续写，保存写作进度，中断会话重启后自动读取历史记忆继续创作，告别重复复述故事背景。

第三，文稿智能排版与多格式成册。自动完成分段、标点修正、段落缩进、章节标题层级优化，一键导出 EPUB 电子书、Markdown 原稿、TXT 连载文稿、PDF 定稿四种格式；EPUB 自动嵌入目录、封面、章节跳转锚点，符合主流电子书阅读器规范；针对网文平台适配分段规则，自动拆分连载分卷，直接适配起点、公众号等多平台发布排版要求。

第四，配套素材一体化生成联动。联动 AI 绘图接口，根据章节场景、人物描述自动生成小说封面、章节插图、人设立绘；同步产出故事简介、宣传短文案、平台引流文案，实现正文 + 配图 + 宣传物料一站式落地；内置配图提示词优化模板，提升画面和故事内容匹配度，减少人工改图成本。

第五，写作辅助与版本管控。自带文稿查重、敏感词筛查、语句润色三项实用子能力，批量优化生硬语句；所有修改自动生成版本快照，支持回退任意历史版本；依托 Claude 本地存储，全文稿保存在本机目录，不上传云端，搭配项目专属 CLAUDE.md 沉淀写作规范，后续同系列创作自动复用文风。

二、技术栈

项目遵循 Claude Code 官方 Skill 开发规范，基于 MCP 通信协议开发，整体轻量化无重型依赖，目录严格遵循.claude/skills标准化结构，核心开发语言以 Markdown+Shell 脚本 + 少量 TS 辅助脚本构成，分层清晰易二次修改。

1. Skill 规范层

以 SKILL.md 作为项目核心配置文件，定义触发关键词、任务调度规则、多 Agent 分工逻辑，Claude Code 加载时自动读取规则，识别用户故事创作需求并启用对应工作流；配套 CLAUDE.md 内置全品类写作规范、文风约束、自检规则，作为 AI 创作永久参考文档。

2. 任务调度与脚本层

使用 Node.js+TypeScript 开发轻量化调度脚本，负责多 Agent 任务分发、版本快照存储、格式转换；Shell 脚本承担批量导出、文件目录自动化整理、配图素材归类等运维工作，适配 Windows、macOS、Linux 全系统终端指令。

3. 文档与格式处理层

接入开源 EPUB 打包引擎、Markdown 解析库，无需额外安装第三方软件即可完成多格式互转；PDF 生成依托无头浏览器内核，本地渲染排版，全程离线处理文档，不调用在线转换接口。

4. 多模态联动层

预留通用 AI 绘图 API 对接接口，兼容 OpenAI、国产多模态大模型等各类绘图服务，通过内置提示词模板自动组装画面需求，实现文案→配图自动化链路，用户仅需在配置文件填入 API 密钥即可启用配图能力。

5. 存储与生态层

全项目文稿、配置、素材默认落地本地项目目录，采用普通文件 + 简易 JSON 存档管理写作版本，无需数据库；原生兼容 Cursor、Codex 等多款支持 MCP 协议的 AI 编程工具，可跨软件迁移使用，项目采用 MIT 开源协议，允许个人商用、自定义修改模板与写作规则。

三、解决什么痛点

oh-story-claudecode 精准直击个人作者、自媒体撰稿人、网文创作者在全流程写作中的六大行业痛点，从策划、写稿、排版到物料全链条降本增效。

第一，长篇创作大纲混乱、人设频繁崩坏。人工撰写长篇故事容易出现前后设定矛盾、人物行为割裂，传统 AI 单次生成大纲零散不成体系；项目分层拆解世界观与人设，AI 受固定规则约束写作，实时对标档案，从源头规避剧情 BUG。

第二，重复复述历史设定浪费 Token。常规 AI 每次续写都需要用户重新介绍前文、人物、世界观，长篇连载写作反复描述背景，造成大量算力与费用损耗；项目本地留存全量故事档案，续写自动读取记忆，无需重复输入，大幅降低按量计费时代的使用成本。

第三，文稿排版成册繁琐耗时。写完正文后还要手动分段、整理目录、制作电子书，多格式导出需要多款软件来回转换；工具一键多格式打包，EPUB、PDF 自动生成规范目录，省去后期排版全流程工作量。

第四，配图与宣传文案单独制作成本高。作者写完文稿还要找设计师做封面、插图、宣传文案，外包费用高昂；项目联动 AI 一键生成全套配图与引流文案，零成本搞定配套素材。

第五，AI 生成文风飘忽不定。普通大模型每次生成内容风格随机，同一本书前后文风割裂；项目内置多套固定文风模板，写入 CLAUDE.md 永久约束 AI 输出，全本书行文风格统一。

第六，文稿数据云端泄露风险。在线写作平台强制上传全文，未发布小说存在被盗稿隐患；该 Skill 全流程本地运算，所有稿件保存在用户本机，不上传第三方服务器，保障原创内容隐私安全。

四、应用场景

依托全链路创作能力，覆盖网文作者、自媒体博主、兼职撰稿、学生文创、出版社撰稿五大类用户全场景创作需求。

1. 网络文学创作者

长篇网文、短篇合集、系列连载创作，快速生成分卷大纲、每日连载正文，自动拆分平台章节格式，配套小说封面与人设插图，批量导出 TXT 用于平台上传，大幅提升日更效率。

2. 自媒体与专栏作者

公众号连载专栏、知乎盐选故事、小红书短篇文案，一键生成正文 + 配图 + 封面海报，文案适配平台阅读排版，产出内容直接发布，一人完成撰稿配图全流程。

3. 兼职撰稿与文案写手

承接短篇约稿、纪实文稿、小故事合集，依托标准化模板快速完成选题→大纲→正文→定稿全链路，批量交付 PDF 原稿，提升接单产出速度。

4. 学生与文创爱好者

课程文学创作、同人小说、短篇作品集，低成本完成从构思到成册，自动生成 EPUB 电子稿，用于作业提交、个人收藏，零基础也能完成完整故事创作。

5. 小型工作室与出版预备撰稿

出版社初稿撰写、短篇合集策划，统一文风规范，批量完成多本稿件创作，自动整理目录与校对文档，降低团队初稿撰写人力成本，方便后续编辑二次修改。

6. 纪实与传记创作者

人物传记、纪实随笔撰写，依托时间线大纲功能梳理人物生平，分章节纪实创作，自动标注关键时间节点，导出规范 PDF 书稿，适配纪实类文稿严谨排版需求。

五、普通人应该怎么用

项目提供Git 手动克隆、插件指令一键安装两种部署方式，零基础创作者无需编程基础，安装后自然语言对话即可完成全流程创作。

方式一：一键指令安装（新手首选）

1. 提前本地部署 Claude Code/Cursor 任意一款 AI 编程终端，终端输入克隆指令：

bash

运行

git clone https://github.com/worldwonderer/oh-story-claudecode ~/.claude/skills/oh-story-claudecode

2. 安装完成后 AI 自动加载 Skill，在对话框输入需求：「创作 30 章都市短篇，面向公众号读者，生成大纲 + 正文 + 封面配图，导出 EPUB」。
3. AI 自动拆分多角色 Agent 分步完成策划、写稿、配图，生成文件统一保存在项目 output 文件夹，直接取用成品。

方式二：自定义模板部署（进阶用户）

进入~/.claude/skills/oh-story-claudecode目录，修改 CLAUDE.md 补充个人专属写作风格、排版规则，后续所有创作自动套用自定义规范；如需开启配图，在配置文件填入 AI 绘图 API 密钥即可。

实用使用小技巧

1. 长篇创作优先让 AI 生成完整大纲确认后再写正文，降低剧情返工概率；
2. 网文连载选用 TXT 格式导出，出书定稿优先 PDF/EPUB；
3. 续写内容直接发送「接续第 X 章继续创作」，工具自动读取前文记忆，无需重复介绍设定；
4. 旧版更新直接让 AI 执行项目更新指令，自动拉取仓库最新规则与模板。

六、未来发展方向

依托 Claude Code 生态持续迭代，项目后续围绕风格扩容、格式拓展、多媒介联动、团队协作四大方向迭代升级。

第一，扩充垂直创作模板库，新增科幻、悬疑、历史、校园、职场十余个细分题材专属大纲模板，针对各品类优化人设、剧情生成规则，适配垂直领域精细化创作需求。

第二，拓展衍生内容生成能力，在文稿、配图基础上新增有声书文案拆分、短视频改编脚本功能，实现小说→图文→短视频文案全链路转化。

第三，完善团队协同机制，新增项目配置云端同步（用户自选私有云），多人共享写作规范与故事档案，适配小型创作团队协同撰稿场景。

第四，优化本地轻量化模型适配，逐步脱离第三方 API 依赖，支持接入本地开源大模型实现全离线创作，进一步降低创作成本。

第五，扩充导出格式，新增 AZW3 等 Kindle 专用电子书格式，完善批注修订功能，对标出版级稿件排版规范。

第六，开放自定义 Skill 子模块，允许用户自建专属文风模板并导入项目，丰富社区共创生态。

七、总结

oh-story-claudecode 作为深耕故事创作赛道的 Claude Code 开源技能，凭借多 Agent 分工创作 + 全链路自动成册 + 本地隐私存储三大核心优势，打通从选题构思到素材成册全创作链路，精准解决传统写作耗时长、排版繁琐、配套物料难做、AI 文风混乱等普遍痛点。

它跳出普通文案工具只生成正文的局限，以标准化 SOP 约束 AI 创作行为，用固定档案规避长篇创作剧情 BUG，兼顾个人业余创作与商业撰稿双重需求，开源免费无功能限制、数据本地留存的特性，大幅降低原创作者的工具成本与被盗稿风险。

在 AI 内容创作持续普及的行业趋势下，规范化、全链路、隐私优先的创作工具已成刚需，该项目依托 Claude 生态持续迭代，后续不断丰富题材与衍生能力，有望成为网文、专栏创作者的标配辅助工具，持续降低内容创作门槛。

生成示例图：

源代码：https://github.com/worldwonderer/oh-story-claudecode