一个人开工位是网文作者的常态:白天上班,晚上开稿,写着写着发现开局立不住,拆了三本对标书还是理不清爽点,好不容易憋出一章又被朋友说"这段写得不太好"。oh-story-claudecode 就是冲着这些坑去的,强烈建议各位作者去试试。
oh-story是什么
它是装在 Claude Code 里的一套网文创作 skill 包,把"扫榜→拆文→写作→去AI味→封面"这条完整生产链固化成可以直接调用的指令。 核心逻辑很直白:套路本质上是确定性的情绪满足,先看市场在追什么题材,再拆爆款是怎么埋钩子的,最后照着同样的手法写自己的稿子。
现在版本已经不止支持 Claude Code,OpenCode、ZCode、OpenClaw、Codex CLI、Reasonix 这些能读项目文件的 Agent 环境也都能用。 适合谁装
- 短篇(知乎盐言、番茄短篇)长篇(起点、番茄、晋江)都能用
只是偶尔润色一段文字,直接找Claude聊两句就够,没必要装这么一整套。 oh-story安装教程
方式一:让Claude Code自己装
对着 Claude Code 直接说一句:
它会自己克隆并部署好。升级的时候再说一遍同一句话就行。
方式二:命令行装
-g 是全局安装,所有项目都能调用,去掉就只装当前目录;-y 用来跳过确认弹窗。更新时重新执行同一条命令即可。
装完必须做的一步
别急着写,在你的小说工作目录里先跑一遍:
它会把hooks、agent、规则文件和CLAUDE.md都铺好。每次升级完skill包也得重跑这一步,不然hooks和agent会跟版本对不上,新会话也要重新开一次。
Windows用户偶尔会碰到ENOENT的mkdir报错,但末尾照样显示Done——这其实是技能没装全的信号。不管有没有报错,重跑一遍同样的安装命令就能修复。
项目目录长什么样
/story-setup 跑完,长篇项目会自动长出一套结构:
短篇轻很多,就是正文、小节大纲和拆文库三样。
根目录还留了个 .active-book 文件,记着你当前在写哪本书——切书只改这一个文件,不用每次跟Claude重新交代。
oh-story使用方法
长篇:从零开一本新书
走的是扫榜→拆文→开书→日更→审查→去AI味→封面这条线:
- /story-long-scan 先看起点现在什么题材在涨
- 挑一到三本对标作品,用 /story-long-analyze 加书名或路径跑黄金三章拆解——它会先出个预览报告,问你要不要继续跑逐章摘要和汇总,产物统一落到拆文库里
- /story-long-write 或直接说"帮我开书",Claude会结合扫榜趋势和拆文结果帮你定题材、世界观、人设和黄金三章
- 每天说"日更"或"写第X章",它会先看追踪目录下的上下文和伏笔再动笔
- 每写几章跑一次 /story-review,多个reviewer agent会从故事架构、人物、节奏、连贯性各个角度挑刺
- 上架前 /story-cover,给个书名作者名直接出封面图
短篇更简单
/story-short-scan → /story-short-analyze → /story-short-write 一条龙。拆文是单管道一次性出完整报告,写作时会同时读拆文报告、情节节点、写作手法、原文和meta信息五份材料。
已有稿子想接着写
手上已经有几万字稿子的话,/story-import 会按篇幅自动分流到长篇或短篇拆解管道,把稿子反向解析成角色、伏笔、大纲、追踪这些标准结构,之后直接接 /story-long-write 续写就行。推荐顺序是先跑 /story-setup 部署好环境,新开会话后再 /story-import,最后接日更。
提示词使用推荐:
oh-story背后的Agent和Hooks
背后跑着7个专门agent:
- story-architect:搭框架、埋钩子、安排反转
- character-designer:人物小传、对话风格
- consistency-checker:核对事实、追伏笔
- story-explorer:只读查询,比如"这个角色多少岁"
- chapter-extractor:抽章节摘要、情节节点
不用记名字,但知道它们存在,下指令会更准——比如直接说"让explorer查一下这个角色第一次出场是哪章",比泛泛地问效果好得多。
/story-setup 同时装了7个hooks,覆盖会话进度记录、设定缺漏检测、伏笔断裂提醒、上下文压缩管理、正文前强制要求先有细纲。这几样是长篇能一直写下去不崩设定的关键。
版本更新要注意什么
新版本里追踪机制改成了单一权威事务模型,追踪目录下一个json文件就是全部结构化状态,续写状态卡固定七栏且控制在12KB内,伏笔、时间线、角色快照都由脚本整份生成,日更每章要读的文件从五个收缩到三个。
旧版本项目得先走导入流程里的迁移选项才能继续用,不用重跑全书拆解。
本地工作台也升级了,一行命令能同时看拆文库和写作项目的文件树,支持搜索、Markdown预览和轻量编辑,只绑本机地址,不用担心数据外泄。
文字层面专门治理过"电报体",短句堆砌那种生硬感做了系统性清扫;细纲现在只规定要发生什么、不再规定正文该长什么样子,避免正文被细纲的骨架带偏。
oh-story实测技巧
拆文别只拆一本。起点、番茄、晋江同题材各挑一本对标着拆,能看出这个赛道的公共爽点和差异化打法——这跟做SEO对标分析同一套思路,单点数据没意义,横向比较才看得出趋势。
日更前先看追踪目录。尤其是角色状态和伏笔,这就跟写周报前先看上周的数据留痕一样,省得凭记忆编,容易前后矛盾。
去AI味别指望一遍到位。/story-deslop 能抓死的句式和标点问题,但读起来还是僵的话,大概率是大纲写得太满、对话太工整,回头让story-architect重新看看节奏比反复跑deslop管用。
新会话确认agent是否生效。跑一次 /story-review,报告开头如果显示Effective Mode是full或lean说明agent注册成功,显示Fallback到solo说明当前环境没能把custom agent跑起来。这个状态提前确认清楚,省得写到一半发现协作根本没生效。
oh-story这个skill装不装终究看你写什么题材的,短篇写着玩,直接找Claude聊就行了,真要连载几十万字那种,这套流水线省下来的时间,比学它的成本高得多。