oh-story 把 Claude Code 变成中文网文写作工作室

长篇网文写作是编程 Agent 最容易崩的场景：几百章的体量、埋好的伏笔、每个会话都重置的对话上下文。oh-story（oh-story-claudecode）是 ZenStory AI 出品的一个 7k-star、MIT 协议的 skill 包，它把状态搬进项目的文件系统，让 Claude Code、Codex CLI、Google Antigravity、OpenCode、ZCode、OpenClaw 或 Reasonix 跑完整条流水线：扫榜、拆文、带大纲门禁的正文、去 AI 味、生成封面。

为什么这个 Skill 重要

这个包装了 13 个 skill，覆盖长篇与短篇两条线。长篇路线是扫榜 → 拆文 → 写作（/story-long-scan → /story-long-analyze → /story-long-write）；短篇路线与之对称；两条线共用 /story-setup、/story-deslop、/story-review 和 /story-cover。底层是 7 个专业 agent——story-architect、narrative-writer、consistency-checker、character-designer、story-researcher、story-explorer、chapter-extractor——外加 8 个自动化 hook 和 100+ 份按需加载的写作方法论。

两个机制承担主要工作。第一，记忆在文件里：设定、大纲、正文、追踪各自独立目录，追踪/_tracking-state.json 是唯一的结构化权威，上下文卡、伏笔视图和角色状态都从它重新生成——手改派生文件会被 check 拒绝。第二，质量门禁是确定性的：8 个 hook 里只有一个是阻断性的。guard-outline-before-prose.sh 会在某章没有细纲时阻止你创建正文；其余只提醒、不打断。

安装

全局安装，所有目录都能用：

npx skills add zenstory-ai/oh-story-claudecode -y -g

去掉 -g 则只装到当前目录。然后部署项目脚手架并新开会话：

/story-setup

7 个专业 agent 由 /story-setup 写进你的项目目录，必须新开会话才生效——README 反复强调这一点，升级后也一样。Windows 上如果安装日志出现 ENOENT ... mkdir 但结尾仍是 Done，重跑同一条命令即可；那说明有技能没装全。

实战：开着门禁开一本新书

1. 在写作项目根目录，发一个有边界的开书请求。README 自带三个可复制的第一条请求模板，开书那条是：

我想开一部〈类型/题材〉新书。先从我提供的材料中分开已确定事实与待决问题；只规划一个有边界的开篇，交付核心冲突、视角/信息释放限制、前三章变化和待决项。不要自动写正文；题材取舍、角色动机和长期方向留给我确认。

2. 确认它交回来的待决项——题材取舍、角色动机和长期方向按设计就留在你手里。
3. 每一章用 /story-long-write 写第N章，先过细纲门禁：该章没有细纲，就没有正文。细纲通过结构验收后，narrative-writer 起草正文，consistency-checker 对照追踪状态核查事实与伏笔，章级检查扫描 AI 句式、退化痕迹、标点和字数欠账。
4. 用 /story-deslop 精修——一个写作 lint，逐行匹配已知 AI 句式，报告行号、命中片段和改写方向。README 明确说它的目标是读感，不是绕过检测器；外部检测只作自测参考。
5. 可选：/story dashboard 在本机 127.0.0.1 打开工作台，浏览拆文库与项目文件树——小说内容不会离开本机。

技巧

• 追踪卡把「作者真相」和「读者已知」分开记——角色莫名提前知道答案、伏笔写飞，主要来源就在这里。
• 从 v0.7.7 起，字数只用一个机器统计口径：每份细纲必须写明合法的字数目标，欠字不会自动加戏，超字最多压缩一次。
• 两条线的目标平台不同：长篇覆盖起点、番茄、晋江、七猫、刺猬猫；短篇覆盖知乎盐言、番茄短篇、七猫短篇。
• /story-import 能把已发布的旧书反向重建为可续写工程——README 自己的演示就是先重建前 20 章再写第 21 章。
• /story-cover 封面生成是唯一调用图像模型（GPT-Image-2）的环节；其余全部跑在你已有的 agent 上，不需要 GPU。

何时不用这个 Skill

方法论、扫榜和平台惯例都是中文网文特有的——写英文小说时，工作流的形状可以迁移，知识库不能。如果你靠不列大纲的纯即兴探索来写作，那个阻断性门禁会跟你对着干。另外它需要一个编程 Agent 宿主，没有独立应用。

查看 排行榜 了解更多 skill。