Oh Story Claudecode

Oh Story

网文写作 skill 包：扫榜、拆文、写作、去AI味、封面图一套流程，装进你正在用的编程 Agent。

项目主页  ·  安装  ·  常见问题  ·  English

这是什么

Oh Story 覆盖长篇与短篇网络小说的全流程：扫榜选材 → 拆解爆款 → 搭大纲写正文 → 去AI味 → 生成封面图。 它以 13 个 skill 的形式装进你已经在用的编程 Agent，写作用的模型就是该 Agent 的模型，不需要 GPU，也不需要另外配模型。

• 用文件系统当记忆 — 设定、大纲、正文、追踪各自独立维护。几百章的长篇不靠对话记忆硬撑，压缩上下文也不会丢伏笔。
• 确定性检查与门禁 — 写正文前没有细纲会被拦下；写完自动扫截断、工程词和常见 AI 句式。7 个专业 Agent、8 个自动化 hook、100+ 份写作方法论按需加载。
• 装进 8 款编程 Agent — Claude Code · Codex CLI · Google Antigravity · OpenCode · ZCode · OpenClaw · Reasonix，以及能读取项目文件的通用 Web AI / Agent 环境。
• 面向的平台 — 起点、番茄、晋江、七猫、知乎盐言等长短篇平台。

套路 = 确定性的情绪满足

专业作者的方法论三步走：扫榜（洞察题材、人设、切入点）→ 拆文（拆解节奏与剧情素材，建立个人模块库）→ 商业化写作（运用钩子、爽感、期待感）。 围绕四条线展开：爆款逆向 · 剧情模块化重组 · 上下文状态分层管理 · 人机协同。

安装

ClawHub

ClawHub 分发由仓库中的 显式发布清单 管理，并通过 ClawHub 提供发现入口。具体 skill 链接只有在发布者、版本和匿名访问均验证后才会写入本文档，避免把尚不存在的条目当成已上架。

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

-g 全局安装，所有目录可用；去掉 -g 则只装到当前目录。更新时重新执行同一条命令即可。

也可以直接对 Agent 说一句话（支持导入 GitHub 仓库 / skill 的平台都适用）：

安装这个 skill https://github.com/zenstory-ai/oh-story-claudecode

装好后，在写作项目根运行 /story-setup（Codex 用 $story-setup）部署 hooks / agents / references，然后新开会话。升级后同样重跑一次 /story-setup。

各 Agent 的部署差异、已知限制与安装排查（Windows ENOENT、Antigravity agy -p、目录残留等）见 各编程 Agent 的部署与安装排查。 最新版本 v0.8.1（2026-09-26）；变更见 CHANGELOG.md 与 Releases。

看看它的输出

下面每一份都是 skill 跑出来的文件，完整样例在 demo/。

续写状态卡：为什么几百章不会崩

下面这本是项目作者自己的长篇，用 /story-import 把已发布的前 20 章反向重建成可续写工程。 下面是写第 21 章之前的状态卡。/story-long-write 不靠对话记忆，它把连续性写进 追踪/上下文.md，下一章只读这一份——固定 7 栏、硬上限 12KB，不进正文 prompt：

## 当前位置
- 当前章：第20章   卷：第一卷·军宣整顿   故事时间：《如愿》点击破亿后的第二天

## 长期约束
- 军宣爽点必须通过作品效果、传播数据和围观反应链兑现，不能只靠系统播报。
- 钟嘉嘉未公开的军方培养安排属于作者真相，正文揭示前不能当成读者已知。

## 活跃伏笔
- F016｜钟嘉嘉并非普通军报实习生，她的军方家庭背景仍未完全公开｜埋第7章｜回收章未定｜高
- F049｜吴伟收到寻衅滋事公诉通知，最终法律结果尚未落地｜埋第18章｜回收章未定｜高
- F054｜一位老兵邀请江晨上门听当年的故事，为后续创作提供入口｜埋第20章｜回收章未定｜高

## 下一章承诺
- 先补第21章细纲，再承接老兵邀请、新歌伴奏和钢琴能力。

「作者真相」和「读者已知」是分开记的——这是角色提前知道答案、伏笔写飞的主要来源。 完整文件：demo/长篇/.../追踪/上下文.md

续写第 21 章：从门禁到回写，一条链走完

上面的视频录的就是这一段。/story-long-write 写第21章 在一次真实会话里的产出与每一道检查：

细纲       细纲_第021章.md              追踪里写着「第21章尚无细纲」，skill 先补纲：单元 L1-03、目标情绪、本章标价、闭环状态、10 个情节点四列表格（外加可选的分辨率列）
章级检查   storyctl.py chapter check   ready · 字数 2068 / 目标 2300
             ├ check-ai-patterns.js     0 命中
             ├ check-degeneration.js    0 命中
             └ normalize-punctuation    0 命中
追踪提交   storyctl.py chapter commit  tracking_committed=true · state_revision 0 → 1
派生视图   tracking_commit.py check    上下文.md / 伏笔.md / 角色状态/ / 时间线/ / 逐章记录/ 全部由 state 重生成，逐字一致

写正文前 guard-outline-before-prose.sh 会拦住缺细纲的章节；细纲过结构验收后，才由 narrative-writer 分两批写正文， 再由 consistency-checker 查事实与伏笔、去味审查改读感，最后跑确定性收尾脚本与 chapter check。

提交之后，追踪状态是工具从 _tracking-state.json 整份重新渲染的，手改派生文件会被 check 拒绝。 对照上面的状态卡，回写实际改了什么（节选，省略了同批滚动的近三章速记与角色状态）：