[opensourcedex]

oh-story-claudecode is a free, open source ai development platforms project written in JavaScript and released under MIT. It has 6,946 GitHub stars, 988 forks and 12 open issues, and was last pushed 3 hours ago. On this registry it ranks #73 of 116 tracked projects in AI Development Platforms, with 5 head-to-head comparisons available.

What is oh-story-claudecode?

oh-story-claudecode is an MIT-licensed package of 13 agent skills that gives Claude Code, Codex, OpenCode, ZCode, Google Antigravity, OpenClaw, and Reasonix a full pipeline for writing Chinese web novels (网文) — scanning platform rankings, deconstructing hits, drafting prose, stripping AI-sounding prose, and generating cover images — for authors and teams publishing on 起点, 番茄, 晋江, 七猫, and 知乎盐言.

What it is

oh-story-claudecode is a skill pack, not a standalone application. Its 13 skills install into an agent CLI you already use, and the writing is done by that agent's own model. Supported hosts are Claude Code, Google Antigravity, OpenCode, ZCode, OpenClaw, Codex CLI, and Reasonix; Web AI and agent environments that can read project files can also use it through the generic skills path. The project is written in JavaScript, licensed MIT, sits at version v0.7.10 (released 2026-09-09) with the repository last pushed 2026-09-18, and has 6,946 stars, 988 forks, and 12 open issues.

The concrete problem it solves is continuity in long fiction. A serialized web novel runs to hundreds of chapters, and conversation memory cannot hold 设定, 大纲, 正文, and 追踪 across that span. The bundle replaces that with the file system as memory: settings, outline, prose, and tracking are maintained as separate files, backed by layered context and state management. Before any prose is drafted an outline gate must pass, and deterministic check scripts verify the work rather than relying on the model's judgement. The bundle also ships 7 professional agents, 8 automation hooks, and more than 100 writing methodology documents.

Key capabilities

  • 13 skills spanning 扫榜 (ranking analysis), 拆文 (deconstruction of hit books), 写作 (drafting), 去AI味 (removing AI-sounding prose), and 封面图 (cover image generation).
  • Deterministic check scripts built into the skills, plus an outline gate that must clear before prose writing begins.
  • File-system-as-memory design: 设定, 大纲, 正文, and 追踪 are each maintained independently so long serials do not lean on conversation memory.
  • 7 professional agents and 8 automation hooks included with the bundle.
  • Over 100 methodology documents covering hooks (钩子), 爽感, and 期待感, plus three working steps: 扫榜, 拆文, and 商业化写作.
  • /story-setup deploys hooks, agents, and references into a writing project; a check argument audits the writing environment without modifying the project.
  • Per-CLI deployers write known targets only, such as .agents/skills/ and .agents/hooks.json for Antigravity, .codex/agents/*.toml for Codex, and .zcode/skills/ plus .zcode/hooks/story_zcode_hook.js for ZCode.

Who uses it and how

  • Serialized web-novel authors writing long and short fiction for 起点, 番茄, 晋江, 七猫, and 知乎盐言, where chapter counts run into the hundreds.
  • Claude Code users who add the oh-story-skills marketplace, install the oh-story bundle, and then call /oh-story:story-setup or /oh-story:story dashboard.
  • Antigravity users who run story-setup with target_cli=antigravity, deploying into the current writing project only; other user skills, agents, rules, hooks, and hook groups are preserved, and the deployer never writes to ~/.gemini/.
  • Codex users who invoke $story or $story-setup; Codex discovers the 13 skills through $REPO_ROOT/.agents/skills, which is a symlink to skills/.
  • ZCode users who add the repository in Plugin Management and install oh-story; on ZCode 3.3.4, which has no project or plugin custom agents and no PreCompact or SessionEnd, related flows degrade explicitly to solo/direct and SessionStart restores context after compaction.

Getting started

Install with npx skills add zenstory-ai/oh-story-claudecode -y -g, dropping -g to install into the current directory only. Then run /story-setup (or $story-setup on Codex) in the writing project root to deploy hooks, agents, and references, and open a new session afterwards.

How it compares

No comparable or competing tool is named anywhere in the facts provided, and the topic list identifies only host agents such as Claude Code, Codex, and Antigravity rather than alternatives to this pack. On the available evidence it stands alone in this registry.

When to use it — and when not to

Hooks depend on node being on PATH, and upgrades require rerunning the install command, rerunning /story-setup, and opening a new session. Antigravity headless use is out of scope for now: agy 1.1.22 -p is not supported, because each headless process may scan the workspace before silent authentication completes and then fail to reload custom agents and hooks, producing skills fallback, subagent not found, or stray output in ~/.gemini/antigravity-cli/scratch/; command-line writing should start interactive agy from the project directory instead. Anyone who does not use one of the named agent CLIs, or who wants a hosted writing product rather than a skills bundle operated inside a coding agent, should not pick this up.

project readme (upstream, from github) — read inline

Oh Story

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

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

Stars Release Skills 13 License MIT

Telegram 交流群 GitHub Discussions

OH STORY 本地写作工作台

这是什么

oh-story-claudecode 覆盖长篇与短篇网络小说的全流程：扫榜选材、拆解爆款、搭大纲写正文、去AI味、生成封面图。它以 13 个 skill 的形式安装到 Claude Code、Google Antigravity、OpenCode、ZCode、OpenClaw、Codex CLI、Reasonix 中，写作用的模型就是该 Agent 的模型；能读取项目文件的 Web AI / Agent 环境也可按通用 skills 路径使用。

  • 检查与门禁：skill 自带确定性检查脚本、写正文前的大纲门禁、分层的上下文与状态管理，以及 7 个专业 Agent、8 个自动化 hook 和 100+ 份写作方法论。
  • 用文件系统当记忆：设定、大纲、正文、追踪各自独立维护，几百章的长篇也不靠对话记忆硬撑。
  • 面向的平台：起点、番茄、晋江、七猫、知乎盐言等长短篇平台。

套路 = 确定性的情绪满足

专业作者的方法论三步走：

  1. 扫榜：分析热门榜单，洞察题材、人设、切入点。
  2. 拆文：拆解大纲节奏与剧情素材，建立个人模块库。
  3. 商业化写作：学习并运用钩子、爽感、期待感等核心技巧。

围绕四条线展开：爆款逆向 · 剧情模块化重组 · 上下文状态分层管理 · 人机协同。

最新版本 v0.7.10（2026-09-09）。完整变更见 CHANGELOG.md 与 Releases；升级后请重跑 /story-setup 并新开会话。Antigravity 部署方式见下文「使用说明」。

安装

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

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

也可以直接告诉 Claude Code / Antigravity / OpenCode / ZCode / OpenClaw / Codex / Reasonix，或其他支持导入 GitHub 仓库/skill 的 Web AI / Agent 平台：

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

升级时再说一次同一句话即可。

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

安装排查：Windows 报错、环境检查、marketplace 路径

Windows 上偶尔会看到 ENOENT ... mkdir 报错但末尾仍显示 Done!，这是有技能没装全。story-setup 的参考资料目录整个缺了一块时，跑 /story-setup 会提示参考资料包不完整；其它形式的残缺不一定有提示。无论有没有报错，重跑同一条安装命令即可修复。

排查已安装环境时，向 Agent 说「用 story-setup 检查写作环境」，或给 story-setup 传入 check 参数。它按目标 CLI 的部署清单检查并给出处理建议；仅检查不会改动项目，需要修复时仍走原来的 setup 流程。

这条 npx skills 独立安装路径不经过 Claude Code 或 ZCode marketplace，不受下方插件打包身份调整影响。

Claude Code / Antigravity / Codex / ZCode / OpenCode / OpenClaw / Reasonix / Web AI 使用说明

Claude Code 用户： marketplace 名保持 oh-story-skills，其中现在只有一个 oh-story bundle，由 Claude Code 从仓库根自动发现全部 13 个 Skills：

claude plugin marketplace add https://github.com/zenstory-ai/oh-story-claudecode
claude plugin install oh-story@oh-story-skills

安装后使用 /oh-story:story-setup、/oh-story:story dashboard 等命令。旧插件用户按升级指南迁移；该身份迁移始于 v0.7.9 的同版本修复；仍使用旧插件身份的用户需主动刷新市场并重装。命令详见 Claude Code 插件参考。

Antigravity 用户： 先用 /skills 或自然语言运行 story-setup，选择 target_cli=antigravity。它只在当前写作项目创建/更新 13 个 .agents/skills/ 已知目录、7 个 .agents/agents/agent-name/agent.md 已知定义（agent-name 替换为实际名称）、.agents/rules/oh-story.md、两个 .agents/hooks/ runtime 文件与 .agents/hooks.json 的 oh-story 管理组；其他用户 Skills、Agents、Rules、Hooks 和 hook groups 都保留，部署器本身不会写 ~/.gemini/。项目内 Skills 使用真实目录；若 .agents/skills 已是 symlink，会先解释 git diff 并征求明确迁移同意，未同意绝不沿链接写入。Hook 依赖 PATH 中的 node；部署后新开 conversation，再分别在 IDE 与交互式 agy 中 smoke test。agy 1.1.22 -p 暂不在支持面内：每次 headless 进程都可能在静默鉴权完成前扫描 workspace，鉴权后又不重载 custom agents/hooks，导致 skill 回退、subagent not found，甚至把普通模型输出写到 ~/.gemini/antigravity-cli/scratch/。命令行写作请从项目目录启动交互式 agy，确认 /skills、/agents、/hooks 已发现 oh-story 后再发任务；测试后检查 scratch 没有意外小说产物。

Codex 用户： repo 内直接使用：Codex 会扫描 $REPO_ROOT/.agents/skills（指向 skills/ 的 symlink）发现 13 个 skill；用 $story、$story-setup 或 /skills 调用。Windows 上 git 需开 core.symlinks=true，否则 symlink 失效，改走下方 $story-setup 部署。

跑 $story-setup 部署到写作项目后，会写入 .codex/agents/*.toml、.codex/hooks.json、.codex/hooks/{story_codex_hook.py,run-story-hook.sh,run-story-hook.cmd} 和 .codex/skills/story-setup/references/agent-references/；请信任项目 .codex/ 配置层并在 /hooks review/trust hooks、新开 Codex 会话，让 custom agents 生效。

ZCode 用户： 在 Plugin Management 中添加本仓库，安装 oh-story，即可调用全部 13 个 Skills/Commands。市场名可能显示 oh-story-zcode（根 catalog）或 oh-story-skills（Claude catalog）；选择其中一个即可，内容相同。旧版多条目安装按升级指南迁移。$story-setup 选择 target_cli=zcode 会部署 .zcode/skills/、.zcode/commands/、.zcode/hooks/story_zcode_hook.js，安全合并 .zcode/config.json 与根 AGENTS.md；Hook 依赖 PATH 中的 node。ZCode 3.3.4 不执行项目/plugin custom agents，也没有 PreCompact / SessionEnd，相关流程会明确降级 solo/direct，compact 后由 SessionStart 恢复上下文。插件格式见 ZCode 官方文档。

OpenCode 用户： 全局安装后 opencode 自动从 ~/.claude/skills/ 发现 skills；首次用自然语言触发 story-setup（如「用 story-setup 部署网文写作环境」），部署后退出重进 opencode -c 才能用 slash command。部分 hook 行为与 Claude Code 有差异（session-start / session-end / compact 等），详见 CONTRIBUTING.md 的 OpenCode 章节。

OpenClaw 用户： 当前支持 skills-only：OpenClaw 可从 workspace skills/、.agents/skills、~/.agents/skills、~/.openclaw/skills 等 skill root 发现本项目 13 个 skill；SKILL.md 已按 OpenClaw 要求使用单行 name / description 与单行 JSON metadata.openclaw。story-setup 选择 target_cli=openclaw 时会把 skills 复制到项目 skills/ 并写入 OpenClaw 版 AGENTS.md；agents/hooks 暂不部署，写正文前大纲守卫在 OpenClaw 下是 skill 内软约束。部署后如未显示新 skills，请新开 OpenClaw session 或等待 watcher 刷新。

Reasonix 用户： 当前支持 skills + 原生 plugin manifest：Reasonix 原生扫描项目 skill root（.agents/skills 等，指向 skills/ 的 symlink）发现 13 个 skill，用 reasonix doctor capabilities 校验；也可用根 reasonix-plugin.json 走 reasonix plugin install。story-setup 选择 target_cli=reasonix 时会把 skills 复制到项目 skills/ 并写入 Reasonix 版 AGENTS.md；hooks/custom agents 暂不部署，涉及专业 Agent 的 skill 走 solo/direct fallback。Windows 未启用 symlink 时改走原生 plugin。

Web AI / 通用 Agent 用户： 平台能读取 GitHub 仓库或项目文件时，可让 Agent 读取 skills/*/SKILL.md 与对应 references/；需要本地副本时，story-setup 可选 target_cli=generic，只写通用 AGENTS.md 和 skills/。无本项目 hooks/custom agents 的环境按 skill 内软约束或 solo/direct fallback 执行。

OpenClaw / Reasonix / 通用路径的目录残留要手动清： 这三条路径的 skill 副本在项目 skills/ 里，重跑 /story-setup 执行的就是项目里那份，自动清理到不了。项目里若出现 skills/story-setup/references/agent-references/agent-references/（可能嵌了多层）或 skills/story-setup/skills/，手动删掉。要让项目里的 skill 文本本身更新，还需要重新安装本项目后，用新包覆盖项目 skills/ 下这 13 个目录。

升级后如果项目里已经跑过 /story-setup，建议在项目根重跑一次 /story-setup，同步 hooks / agents / references。每版变更见 CHANGELOG.md 与 Releases。

多 agent 协作要先部署再新开会话： 7 个专业 agent（story-architect、narrative-writer、consistency-checker 等）由 /story-setup 写入项目 .claude/agents/，由 $story-setup 写入 .codex/agents/*.toml，或由 Antigravity story-setup 生成 .agents/agents/agent-name/agent.md（agent-name 替换为实际名称）。Antigravity 使用 invoke_subagent + 同名 TypeName；运行时未暴露 custom subagent 时按 skill 明确降级 solo/direct。判断是否生效：新会话里跑 /story-review，报告头是 Effective Mode: full/lean 即注册成功，是 Fallback: ... -> solo 说明当前运行时未暴露该 agent。

导入续写顺序： 推荐先在写作项目根运行 /story-setup（部署 hooks/agents/AGENTS），新开/刷新会话后运行 /story-import 导入已有小说，再用 /story-long-write 日更 或 /story-long-write 写第N章 续写。也可以直接运行 /story-import；它会先检测是否已 setup，未部署时让你选择先去 setup 或继续串行导入。

作者习惯会跨会话延续： 对 /story 说“记住我的写作习惯”，稳定偏好会进入工作区 .story/作者记忆/；看到 Author Memory Receipt 才算写入成功。普通写作只查询本次相关的已确认条目，输出硬上限 2KB，不把完整画像、候选和历史塞进正文 prompt。它与每本书的剧情追踪分开，当前要求、本书设定和硬性门禁始终优先。

安装后的第一条请求

复制、改一改就能用：按当前任务选一条，把〈占位内容〉换成自己的信息。

  1. 开一本新书

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

  2. 导入已有书稿

    请把这份书稿整理成可续写项目。第 1–〈N〉章完整，〈文件名〉是第〈N+1〉章残稿；保留原文，不覆盖完整章节，不把残稿算作完整章，推断出的设定单列待确认。先交付识别范围、重建事实、冲突/歧义和待我确认的决定，供我审阅；暂不续写。

  3. 修一段不满意的正文

    这段读起来〈空泛/重复/过度解释〉。先指出具体读感问题，保留故事事实、角色已知和未揭示边界；只交付这一段的修订建议、前

readme truncated — read the full docs on github

Frequently asked questions

Is oh-story-claudecode free to use?

oh-story-claudecode is open source under the MIT licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does oh-story-claudecode do?

Claude Code / Codex / OpenCode agent skills for writing Chinese web novels (网文): 扫榜、拆文、写作、去AI味、封面全流程，长篇短篇都支持 | 13 skills for novel writing and long-form fiction

What is oh-story-claudecode written in?

oh-story-claudecode is primarily written in JavaScript. Its source is publicly available at https://github.com/zenstory-ai/oh-story-claudecode, and it has 6,946 GitHub stars.