Oh Story

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

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

这是什么

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，然后新开会话。

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

升级后如果项目里已经跑过 /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. 修一段不满意的正文

   这段读起来〈空泛/重复/过度解释〉。先指出具体读感问题，保留故事事实、角色已知和未揭示边界；只交付这一段的修订建议、前后对照与理由，不全书改写。哪些建议采用由我决定。

流程总览

flowchart LR
    classDef entry fill:#f0f0f0,color:#333,stroke:#999,stroke-width:1px
    classDef phase fill:#e8f4fd,color:#1a1a2e,stroke:#4a9be8,stroke-width:1px
    classDef final fill:#fce4ec,color:#333,stroke:#e57373,stroke-width:1px

    entry_l{{"长篇作者"}}:::entry
    entry_s{{"短篇作者"}}:::entry
    entry_r{{"已有方向"}}:::entry
    entry_i{{"已有小说"}}:::entry

    subgraph S0 ["  环境部署"]
        setup["/story-setup"]:::phase
    end

    subgraph S1 ["  扫榜选材"]
        direction TB
        scan_l["长篇扫榜"]:::phase
        scan_s["短篇扫榜"]:::phase
    end

    subgraph S2 ["  拆文学习"]
        direction TB
        analyze_l["长篇拆文"]:::phase
        analyze_s["短篇拆文"]:::phase
        import_l["已有小说导入"]:::phase
    end

    subgraph S3 ["  落笔创作"]
        direction TB
        write_l["长篇写作"]:::phase
        write_s["短篇写作"]:::phase
    end

    subgraph S4 ["  精修定稿"]
        deslop["去 AI 味"]:::final
    end

    entry_l --> setup
    entry_s --> setup
    setup --> scan_l
    setup --> scan_s
    scan_l --> analyze_l
    scan_s --> analyze_s
    analyze_l --> write_l
    analyze_s --> write_s
    entry_r -.->|跳过准备| write_l
    entry_r -.->|跳过准备| write_s
    entry_i -.->|推荐先部署| setup
    setup -.->|逆向导入| import_l
    import_l -.->|续写| write_l
    write_l --> deslop
    write_s --> deslop

Skills

story-deslop 的本地检查是写作 lint：blocking 只限确定性句式/标点问题，其他提示按读感判断；朱雀等外部检测只作自测参考，不替代人工读感。

自然语言同样触发：

• 「帮我开书」→ story-long-write
• 「这篇太 AI 了」→ story-deslop
• 「把我的书导进来」→ story-import
• 「打开工作台」→ story dashboard（本机浏览拆文库与写作项目，可轻量编辑）
• 「记住我的写作习惯」→ story 作者记忆（原话证据、待确认、冲突替代）
• 「沈栀现在什么状态」→ 自动 spawn story-explorer agent

Story Dashboard

运行 /story dashboard（Codex 用 $story dashboard）打开本地写作工作台，浏览拆文库与 长/短篇项目文件树，并完成搜索、Markdown 预览、文本编辑、冲突保护保存和确认删除。 服务仅监听 127.0.0.1，小说内容不会上传。

demo/拆文库/盘龙/
├── 概要.md              # 全书概要 + 章节索引
├── 拆文报告.md           # 五维评分 + 爽点密度 + 可借鉴套路
├── 文风.md              # 句长/标点/对话潜台词/情绪节奏 + 原文锚点
├── 章节/
│   ├── 第1章_深度拆解.md … 第3章_深度拆解.md  # 黄金三章逐章深度分析
│   └── 第1章_摘要.md … 第23章_摘要.md          # 每章一个摘要文件
├── 角色/
│   ├── 林雷.md           # 主角完整档案
│   ├── 霍格.md           # 核心配角
│   ├── 希尔曼.md         # 核心配角
│   ├── 希里.md           # 功能角色
│   ├── 德林柯沃特.md      # 核心配角
│   ├── 沃顿.md           # 功能角色
│   └── 角色关系.md        # 关系网络
├── 剧情/
│   ├── 故事线.md          # 框架识别 + 4剧情 + 2故事线
│   ├── 强者过境与魔法启蒙.md 等  # 五个分场景剧情单元
│   ├── 节奏.md            # 节奏/关键信息递进/情绪触发爆发节律
│   └── 情绪模块.md        # 读者需求/情绪引擎/可复用写作模块
└── 设定/
    ├── 世界观/
    │   ├── 背景设定.md    # 核心规则 + 特殊设定
    │   ├── 力量体系.md    # 战气 + 魔法 + 等级
    │   ├── 地理.md        # 安达卢西亚 + 玉兰大陆
    │   └── 金手指.md      # 盘龙戒指 + 德林柯沃特
    └── 势力/
        └── 巴鲁克家族.md  # 龙血血脉家族档案

demo/拆文库/曾将爱意私藏/
├── 原文/原文.txt        # 原文备份
├── 拆文报告.md          # 故事核 + 五维评分 + 爆点6维 + 认知反转 + 共鸣9层
├── 情节节点.md          # 54 个情节节点（原文引用 + 情绪标记 −9~+9）
├── 写作手法.md          # POV / 对话 / 信息差 / 物件钩子 等 11 项
└── _meta.json           # 结构计数 structure_counts（Phase 7 门控依据）

demo/长篇/让你管账号，你高燃混剪炸全网/
├── 正文/        第001–020章（已发布原文）
├── 大纲/        大纲.md · 卷纲_第1卷.md · 细纲_第001–020章.md（1 章 1 文件）
├── 设定/        角色/{江晨·钟嘉嘉·周薄森·张耀祖·吴伟·李林}
│                世界观/{背景设定·金手指} · 关系.md · 题材定位.md · 文风.md
└── 追踪/        _tracking-state.json · 上下文.md · 伏笔.md · 逐章记录/
                 角色状态/{角色名}.md · 时间线/{作者真相.md·读者已知.md}

Agent 体系

写作 skill 内部通过 7 个专业 Agent 协作，各司其职：

Agent 按需加载 references/ 中的写作理论（角色设计、对话技法、反转工具箱等 100+ 份方法论文件），不预占上下文。

自动化 Hooks

/story-setup 为 Claude Code 部署 8 个自动化 hook：

项目文件结构

一部长篇动辄几十万字、几百章。设定冲突、伏笔断线、时间线对不上——写到最后全靠记忆硬撑，迟早翻车。

用文件系统把设定、大纲、正文、追踪拆开，每个维度独立维护。对话只负责创作，不负责记忆。

工作区级作者记忆独立于单本小说：

.story/作者记忆/
├── _author-memory-state.json  # 唯一结构化权威
├── 作者画像.md               # 已确认、可用于创作的偏好
├── 待确认.md                 # 推断、重复修正和冲突候选
└── 变更记录.md               # 可审计的替代与撤回历史

长篇：

{书名}/
├── 设定/
│   ├── 世界观/          # 背景、力量体系等，按主题拆文件
│   ├── 角色/            # 每个人物一个文件（江晨.md、钟嘉嘉.md）
│   ├── 势力/            # 每个势力/组织一个文件（火箭军文工团.md）
│   ├── 关系.md          # 角色关系映射
│   └── 题材定位.md      # 题材核心梗+对标分析
├── 大纲/
│   ├── 大纲.md          # 全书卷级结构
│   ├── 卷纲_第一卷.md   # 每卷一个：爽点节奏+情绪弧线+人物弧线+伏笔+反转
│   ├── 细纲_第001章.md  # 每章一个：内容概括+多线情节+人物关系/出场顺序+钩子
│   └── ...
├── 正文/
│   ├── 第001章_章名.md
│   └── ...
├── 对标/                # 对标参考（结构化子目录从拆文库同步）
│   └── {对标书名}/
│       ├── 原文/            # 对标书原文章节
│       ├── 角色/            # 结构化角色卡（从 analyze 输出同步）
│       ├── 剧情/            # 结构化剧情线/节奏/情绪模块（从 analyze 输出同步）
│       ├── 设定/            # 结构化设定（从 analyze 输出同步）
│       ├── 文风.md          # 日更前读取，用来贴近对标书文风
│       └── 拆文报告.md      # analyze skill 输出的拆文报告
├── 追踪/                # 文件优先的连续性状态
│   ├── _tracking-state.json # 唯一结构化权威状态（不进正文 prompt）
│   ├── 上下文.md        # 派生续写状态卡（固定 7 栏，≤12KB）
│   ├── 逐章记录/        # 每章未来相关连续性记录/修订覆盖层（≤3072 bytes）
│   ├── 角色状态/        # 派生核心角色快照（江晨.md、钟嘉嘉.md）
│   ├── 伏笔.md          # 派生伏笔当前视图
│   └── 时间线/          # 派生作者真相.md + 读者已知.md
├── 参考资料/            # story-researcher 输出的研究资料
│   └── {topic}.md       # 按研究主题拆分

短篇：

短篇/{标题}/
├── 正文.md              # 完成稿
├── 小节大纲.md          # 8 节结构 + 情绪曲线
└── 拆文库/              # 如有参考小说（analyze 输出）
    └── {书名}/
        ├── 拆文报告.md
        ├── 情节节点.md
        └── 写作手法.md

拆文库： 拆文 skill 默认输出到项目根目录 拆文库/{书名}/，产出结构化目录（角色/剧情/设定/章节），其中长篇剧情目录包含 节奏.md 和 情绪模块.md，是 analyze 的源数据（source of truth）。写作 skill 通过 对标/{书名}/剧情/ 等子目录消费这些资产（项目级引用视图），或自动回退读取 拆文库/。

.active-book： 项目根目录的文本文件，内容是当前活跃书目的相对路径（如 长篇/我的小说），hook 和写作 skill 据此定位当前项目。

知识体系

各 skill 自带 references/ 知识库，按需加载，不占上下文。

适用平台

长篇 起点中文网 · 番茄小说 · 晋江文学城 · 七猫小说 · 刺猬猫

短篇 知乎盐言故事 · 番茄短篇 · 七猫短篇

真实产出样例见 demo/：短篇拆文《曾将爱意私藏》· 长篇拆文《盘龙》· 长篇续写工程《让你管账号，你高燃混剪炸全网》· 封面《剑道独尊》示例图。

这套 skill 现在能让我度过找工作的过渡期 :joy:，希望也能帮到有需要的朋友。

常见问题

能在 Codex、Google Antigravity、OpenCode 里用吗，还是只支持 Claude Code？

oh-story-claudecode 内置适配 Claude Code、Google Antigravity、OpenCode、ZCode、OpenClaw、Codex CLI 和 Reasonix。Codex 会直接扫描仓库内 .agents/skills 发现 13 个 skill，用 $story-setup 调用；Antigravity 用 /skills 或自然语言运行 story-setup 并选择 target_cli=antigravity；能读取项目文件的 Web AI / Agent 环境也可以按通用 skills 路径使用。

需要 GPU 或自己部署模型吗？

不需要。oh-story-claudecode 是一组 skill，运行在你已经在用的编程 Agent 里，写作用的模型就是该 Agent 的模型；本地只跑确定性的检查脚本（Node / Python）。唯一的例外是 story-cover 封面生成，它调用 GPT-Image-2（Codex 内置用量或 API 回退）。

每章字数不统一、字数对不上怎么办？

从 v0.7.7 起，长篇正文只用一个机器统计的字数口径：每份细纲必须写明合法的「字数目标」，缺少时会停止而不是回退到 3000；欠字不会自动加戏，超字最多压缩一次。写入后 check-prose-after-write.sh 会提醒字数欠账。升级旧项目后重跑 /story-setup 并新开会话即可生效。

去AI味之后，朱雀等 AI 检测还是判定为 AI 怎么办？

story-deslop（/去AI味）是写作 lint：它确定性地检测并清除已知的 AI 句式、标点和退化痕迹，目标是读感，不是绕过检测器。朱雀等外部检测只作自测参考，不替代人工读感。 可按这份具体改稿指南把空泛情绪、重复句式、拔高议论和过度解释分别处理，同时保留场景任务与作者设定；本仓库的实现细节见去AI味的具体做法。

已经写了一部分的小说，能导入后继续写吗？

可以。先在写作项目根运行 /story-setup，新开或刷新会话后运行 /story-import（/导入小说）把已有小说反向解析成标准项目结构，审阅反推结果，再用 /story-long-write 日更 或 /story-long-write 写第N章 续写。导入与续写指南说明了为什么书稿证据应优先于模型猜测。

长篇续写怎样减少忘伏笔或角色提前知道答案？

续写前分开故事客观事实、角色已知和读者已见，只带上本章相关的当前状态与未完承诺。长篇连续性指南给出三章示例，AI 写长篇小说怎么不崩人设：Oh Story 的做法说明本仓库的连续性机制。

章纲齐全，为什么写出来还是在复述设定？

把章纲当作“本章必须发生什么变化”的规格，再把目标、阻碍、证据、选择和代价转成视角人物可感知的行动与结果。章纲到章节指南给出编辑示例。

怎样保留我的文风，又不把另一本书的情节带进来？

把你自己写的或获准使用的短样本拆成表达维度，与当前书的事实分开讨论；样本推断不自动成为长期偏好。作者文风指南说明如何裁决当前要求、本书文风与作者偏好；样本只作表达参考，不复制原句。

Windows 上安装报 ENOENT ... mkdir，但末尾显示 Done，正常吗？

这是有技能没装全。无论有没有报错，重跑同一条安装命令即可修复；如果参考资料目录缺了一块，/story-setup 会提示参考资料包不完整。Codex 用户在 Windows 上还需要为 git 打开 core.symlinks。

升级到新版本后要做什么？

重跑 /story-setup 并新开会话。7 个专业 agent（story-architect、narrative-writer、consistency-checker 等）由 /story-setup 写入项目目录，必须先部署再新开会话，多 agent 协作才会生效。

短篇和长篇的入口有什么区别？

长篇：/story-long-scan（扫榜）→ /story-long-analyze（拆文）→ /story-long-write（写作，含大纲、卷纲、细纲、正文）。短篇：/story-short-scan → /story-short-analyze → /story-short-write。两条线共用 /story-setup、/story-deslop、/story-review 和 /story-cover。

延伸阅读

• 提示词、技能包、插件与 MCP 怎么分 — 先选写作任务，再选宿主与流程
• 导入 10–20 章后接着写 — 审阅反推结果，以书稿证据为准
• 分开角色已知、承诺与线索 — 别把未来计划当成已发生事实
• 把剧情规格写成可见变化 — 用行动、选择、代价和结果推进
• 用具体改稿减少“AI 味” — 改读感，不追求鉴定分数
• 分开文风选择与本书事实 — 用自有或获准样本，不复制原句
• AI 写长篇小说怎么不崩人设：Oh Story 的做法 — 仓库内文档
• 去AI味的具体做法 — 仓库内文档
• 扫榜和拆文的自动化做法 — 仓库内文档
• Claude Code skills for writers — 仓库内文档（英文）

贡献

欢迎贡献新 skill、补充知识库、更新市场数据。详见 CONTRIBUTING.md。

交流

• Telegram 群： —— 日常交流、踩坑、新功能讨论。
• GitHub Discussions：提问 / 求助 / 分享用法，方便检索。
• GitHub Issues：Bug、输出质量 Case、功能请求，请按结构化表单提供复现材料或具体输出证据。

致谢

• LINUX DO - The New Ideal Community — 社区支持
• FanqieRankTracker — 番茄小说字体反爬解码方案参考
• Zhuque AIGC Detector CLI — 去 AI 味实验中的外部复测工具参考

ZenStory AI 项目

Oh Story 是 ZenStory AI 的一部分——一组开源、面向 agent 的故事创作、改编与生产工具（GitHub 组织：zenstory-ai）。同组织项目：

本仓库从 worldwonderer/oh-story-claudecode 迁入，旧链接自动跳转。