English | 中文

oh-story-claudecode

网文写作 skill 包，覆盖长篇与短篇网络小说的扫榜、拆文、写作、去AI味、封面图全流程。内置适配 Claude Code、OpenCode、ZCode、OpenClaw、Codex CLI、Reasonix；能读取项目文件的 Web AI / Agent 环境也可按通用 skills 路径使用。

核心思路

套路 = 确定性的情绪满足

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

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

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

v0.7.6 起：重点在正文那一段。写正文的 narrative-writer 有三条规则一直在空转——「写完必须立即统计字数」给的是一条 Bash 命令，可它的工具白名单里没有 Bash，同一句话又禁掉了模型估算，于是「字数达标是硬性要求」背后没有任何可执行判据；「返回前报出句长分布」同样只能编，而主会话正拿它做质量校验；「正文逐项展开细纲」是最高优先级的明令，放宽的那半边却只写在主 skill 里、从不进 spawn 提示词，子代理只看见限制，就按一个情节点一段平推成流水账。三条都已修好，实跑首次落盘即进验收区间（对照组不到下限的 73%）。新增细纲照搬检测：细纲把情节点写成成品散文句时正文只剩誊抄，配套的「复沓锚句」字段让必须逐字进正文的原话（誓言、系统面板、案卷原话）不被误判。另外 Claude Code 上用 Bash 重定向写正文也会被大纲/追踪守卫拦下，以及每次会话固定加载的文本再降两成（开书 −30%、回炉 −41%）。本版 agents_version 为 25，已部署项目需重新运行 /story-setup 并新开会话。

v0.7.5 起：稳定版。补上 Claude Code 写正文守卫缺的追踪检查点门——另三端从 v0.7.3 起就有，主力端此前会静默写出若干章没有追踪的正文；长篇 story-long-write 每次触发都整份进上下文的 SKILL.md 从 82 KB 降到 54 KB（开书三阶段抽成按需读的 workflow-setup.md，日更不再为用不上的建纲步骤付费）；清掉一批过度累加的限制指令，其中一条把正文里普通的「他说」判成了违规。本版 agents_version 为 24，已部署项目需重新运行 /story-setup 并新开会话。

v0.7.4 起：全是修复。story-import 不再把用户自己的书登记成对标（此前会出现「对标目录内容跟自己设定完全相同」）；story-setup 重部署不再把 Reasonix / generic 项目误判成 OpenClaw，多端部署也不再每次开会话误报参考包缺失；Stage 6 文风统计在 Windows 上不再必挂。spawn 的 agents_version 硬门禁改成提示——版本不匹配照常并行，只有 agent 文件缺失才降级 solo。本版 agents_version 为 23，已部署项目需重新运行 /story-setup 并新开会话。

更早版本变更见 CHANGELOG.md。

流程总览

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

安装

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

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

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

方式二 命令行：

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

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

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

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 中把本仓库加入 marketplace，安装 oh-story 后可用 $story、$story-setup 或 / 面板调用 13 个 Skills/Commands。$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 恢复上下文。

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。Claude Code / Codex 都在会话启动时更稳定地注册 custom agent；ZCode 3.3.4、OpenClaw Phase 1、Reasonix Phase 1 与 generic 路径默认走 skills + solo fallback。判断是否生效：新会话里跑 /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 或继续串行导入。

Skills

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

自然语言同样触发：

• 「帮我开书」→ story-long-write
• 「这篇太 AI 了」→ story-deslop
• 「把我的书导进来」→ story-import
• 「打开工作台」→ story dashboard（本机浏览拆文库与写作项目，可轻量编辑）
• 「沈栀现在什么状态」→ 自动 spawn story-explorer agent

Story Dashboard

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

使用 /story-long-analyze 深度模式分析《盘龙》前23章的完整输出：

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  # 龙血血脉家族档案

长篇拆文会额外生成 文风.md，并在 剧情/ 下产出 节奏.md（节奏/关键信息递进/情绪触发爆发节律）和 情绪模块.md（读者需求/情绪引擎/可复用写作模块）；日更写作会通过 对标/{书名}/剧情/ 读取这些素材，避免文风、节奏和情绪模块偏离对标书。

使用 /story-short-analyze 拆解短篇《曾将爱意私藏》（约 8500 字，追妻火葬场 · 死遁）的完整输出：

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

短篇拆文产出 拆文报告 / 情节节点 / 写作手法，下游 /story-short-write 据此写同题材新短篇。

推荐先 /story-setup 部署写作项目，再使用 /story-import 把作者已发布的前 20 章（约 3.7 万字）逆向重建为可续写的写作工程，最后接 /story-long-write 日更 或 /story-long-write 写第21章 续写：

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

逐章提取（事件 / 角色 / 设定 / 伏笔 / 时间线）反推为续写 bible，作者从第 21 章无缝接着写。

Agent 体系

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

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

自动化 Hooks

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

项目文件结构

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

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

长篇：

{书名}/
├── 设定/
│   ├── 世界观/          # 背景、力量体系等，按主题拆文件
│   ├── 角色/            # 每个人物一个文件（江晨.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:，希望也能帮到有需要的朋友。

贡献

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

交流

• Telegram 群：https://t.me/ohstoryclaudecode —— 日常交流、踩坑、新功能讨论。
• GitHub Discussions：提问 / 求助 / 分享用法，方便检索。

致谢

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