story
Newç½ç»å°è¯´å·¥å ·ç®±ä¸»å ¥å£ãæ ¹æ®ä½ çéæ±èªå¨è·¯ç±å°é¿ç¯/çç¯çæ«æ¦ãæææåä½å·¥å ·ã
Overview
oh-story-claudecode
网文写作 skill 包,覆盖长篇与短篇网络小说的扫榜、拆文、写作、去AI味、封面图全流程。适配 Claude Code、OpenClaw。
核心思路
套路 = 确定性的情绪满足
专业作者的方法论三步走:
- 扫榜:分析热门榜单,洞察题材、人设、切入点。
- 拆文:拆解大纲节奏与剧情素材,建立个人模块库。
- 商业化写作:学习并运用钩子、爽感、期待感等核心技巧。
围绕四条线展开:爆款逆向 · 剧情模块化重组 · 上下文状态分层管理 · 人机协同。
流程总览
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
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 -.->|逆向导入| write_l
write_l --> deslop
write_s --> deslop安装
方式一 直接告诉 Claude Code / OpenClaw:
安装这个 skill https://github.com/worldwonderer/oh-story-claudecode方式二 命令行:
npx skills add worldwonderer/oh-story-claudecode -y -g-g 全局安装,所有目录可用;去掉 -g 则只装到当前目录。更新时重新执行同一条命令即可。
升级后如果项目里已经跑过
/story-setup,建议在项目根重跑一次/story-setup,同步 hooks / agents / references。每版变更见 CHANGELOG.md 与 Releases。
Skills
| Skill | 触发 | 说明 |
|---|---|---|
story-setup | /story-setup /准备写书 | 环境部署 · hooks/rules/agents/CLAUDE.md 一键部署(已有配置安全合并) |
story | /story /网文 | 工具箱路由 · 模糊意图自动分发到对应 skill |
story-long-write | /story-long-write /写长篇 | 长篇写作 · 大纲搭建、人物设定、正文输出 |
story-long-analyze | /story-long-analyze | 长篇拆文 · 黄金三章、爽点设计、节奏分析 |
story-long-scan | /story-long-scan | 长篇扫榜 · 起点/番茄/晋江市场趋势 |
story-short-write | /story-short-write | 短篇写作 · 情绪设计、反转构思、精修出稿 |
story-short-analyze | /story-short-analyze | 短篇拆文 · 故事核、结构分析、情感线、反转设计、写作手法、共鸣分析 |
story-short-scan | /story-short-scan | 短篇扫榜 · 知乎盐言/番茄短篇风口数据 |
story-deslop | /story-deslop /去AI味 | 去AI味 · 检测并清除 AI 写作痕迹 |
story-import | /story-import /导入小说 | 逆向导入 · 将已有小说反向解析为标准项目结构 |
story-review | /story-review /审查 | 多视角审查 · 4 Agent 多视角审稿 + 番茄/起点/知乎评分标准 |
story-cover | /story-cover /封面 | 封面生成 · 书名题材分析 + GPT-Image-2 出图 |
browser-cdp | /browser-cdp | 浏览器操控 · CDP 协议复用登录态抓取数据 |
自然语言同样触发:
- •「帮我开书」→
story-long-write - •「这篇太 AI 了」→
story-deslop - •「把我的书导进来」→
story-import - •「沈栀现在什么状态」→ 自动 spawn
story-exploreragent
<details> <summary>封面生成示例</summary>
</details>
<details> <summary>拆文 demo — 盘龙</summary>
使用 /story-long-analyze 深度模式分析《盘龙》前23章的完整输出:
demo/拆文库-盘龙/
├── 概要.md # 全书概要 + 章节索引
├── 拆文报告.md # 五维评分 + 爽点密度 + 可借鉴套路
├── 文风.md # 句长/标点/对话潜台词/情绪节奏 + 原文锚点
├── 章节/
│ ├── 第1章_深度拆解.md # 黄金三章深度分析
│ └── 第1-23章_摘要.md # 每章摘要 + 情节点 + 角色提及
├── 角色/
│ ├── 林雷.md # 主角完整档案
│ ├── 霍格.md # 核心配角
│ ├── 希尔曼.md # 核心配角
│ ├── 德林柯沃特.md # 核心配角
│ ├── 沃顿.md # 功能角色
│ └── 角色关系.md # 关系网络
├── 剧情/
│ └── 故事线.md # 框架识别 + 4剧情 + 2故事线
└── 设定/
├── 世界观/
│ ├── 背景设定.md # 核心规则 + 特殊设定
│ ├── 力量体系.md # 战气 + 魔法 + 等级
│ ├── 地理.md # 安达卢西亚 + 玉兰大陆
│ └── 金手指.md # 盘龙戒指 + 德林柯沃特
└── 势力/
└── 巴鲁克家族.md # 龙血血脉家族档案长篇拆文会额外生成 文风.md;日更写作会读取它,避免对话、标点和情绪节奏偏离对标书。
</details>
<details> <summary>拆文 demo — 曾将爱意私藏(短篇)</summary>
使用 /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 据此写同题材新短篇。
</details>
<details> <summary>导入 demo — 让你管账号,你高燃混剪炸全网(长篇续写工程)</summary>
使用 /story-import 把作者已发布的前 20 章(约 3.7 万字)逆向重建为可续写的写作工程,接 /story-long-write 日更续写第 21 章:
demo/让你管账号,你高燃混剪炸全网/
├── 正文/ 第001–020章(已发布原文)
├── 大纲/ 大纲.md · 卷纲_第1卷.md · 细纲_第001–020章.md(1 章 1 文件)
├── 设定/ 角色/{江晨·钟嘉嘉·周薄森·张耀祖·吴伟·李林}
│ 世界观/{背景设定·金手指} · 关系.md · 题材定位.md · 文风.md
├── 追踪/ 伏笔.md · 时间线.md · 角色状态.md · 上下文.md
└── 参考资料/ 作品信息.md逐章提取(事件 / 角色 / 设定 / 伏笔 / 时间线)反推为续写 bible,作者从第 21 章无缝接着写。
</details>
Agent 体系
写作 skill 内部通过 7 个专业 Agent 协作,各司其职:
| Agent | 模型 | 职责 |
|---|---|---|
| story-architect | Opus | 故事架构 · 题材定位、大纲结构、钩子/反转设计、情绪弧线 |
| character-designer | Sonnet | 角色设计 · 角色档案、语言风格、动机链、对话创作 |
| narrative-writer | Sonnet | 叙事写手 · 正文写作、去AI味、格式合规 |
| consistency-checker | Haiku | 一致性检查 · 事实冲突扫描、伏笔追踪、S1-S4 分级报告 |
| story-researcher | Sonnet | 资料研究 · CDP 搜索+正文提取、多源交叉验证、结构化参考文件输出 |
| story-explorer | Haiku | 故事查询 · 角色/伏笔/设定/进度只读查询,日更上下文快速加载 |
| chapter-extractor | Haiku | 章节提取 · 摘要+情节点+角色提及,并行拆文核心单元 |
Agent 按需加载 references/ 中的写作理论(角色设计、对话技法、反转工具箱等 100+ 份方法论文件),不预占上下文。
自动化 Hooks
/story-setup 部署后自动生效的 6 个 hook:
| Hook | 触发时机 | 功能 |
|---|---|---|
| session-start.sh | 会话开始 | 显示分支、进度快照、拆文状态 |
| session-end.sh | 会话结束 | 记录会话日志到 追踪/session-log.txt |
| detect-story-gaps.sh | 会话开始 | 检测设定缺口、大纲缺失、伏笔断线 |
| pre-compact.sh | 上下文压缩前 | 保存进度快照路径和行数摘要 |
| post-compact.sh | 上下文压缩后 | 提示读取进度快照恢复上下文 |
| validate-story-commit.sh | git commit 时 | 检查硬编码属性、设定必填字段(仅警告,不阻断) |
项目文件结构
一部长篇动辄几十万字、几百章。设定冲突、伏笔断线、时间线对不上——写到最后全靠记忆硬撑,迟早翻车。
用文件系统把设定、大纲、正文、追踪拆开,每个维度独立维护。对话只负责创作,不负责记忆。
长篇:
{书名}/
├── 设定/
│ ├── 世界观/ # 背景、力量体系等,按主题拆文件
│ ├── 角色/ # 每个人物一个文件(沈栀.md、陆衍止.md)
│ ├── 势力/ # 每个势力/组织一个文件(天机阁.md)
│ ├── 关系.md # 角色关系映射
│ └── 题材定位.md # 题材核心梗+对标分析
├── 大纲/
│ ├── 大纲.md # 全书卷级结构
│ ├── 卷纲_第一卷.md # 每卷一个:爽点节奏+情绪弧线+人物弧线+伏笔+反转
│ ├── 细纲_第001章.md # 每章一个:事件+钩子+爽点+悬念
│ └── ...
├── 正文/
│ ├── 第001章_章名.md
│ └── ...
├── 对标/ # 对标参考(结构化子目录从拆文库同步)
│ └── {对标书名}/
│ ├── 原文/ # 对标书原文章节
│ ├── 角色/ # 结构化角色卡(从 analyze 输出同步)
│ ├── 剧情/ # 结构化剧情线(从 analyze 输出同步)
│ ├── 设定/ # 结构化设定(从 analyze 输出同步)
│ ├── 文风.md # 日更前读取,用来贴近对标书文风
│ └── 拆文报告.md # analyze skill 输出的拆文报告
├── 追踪/ # 连续性管理(分层追踪)
│ ├── 上下文.md # 写作上下文(compact 恢复用)
│ ├── 伏笔.md # 伏笔埋设/回收状态表(跨卷级)
│ ├── 时间线.md # 故事内时间线(全书级)
│ └── 角色状态.md # 角色当前状态快照(章节级)
├── 参考资料/ # story-researcher 输出的研究资料
│ └── {topic}.md # 按研究主题拆分短篇:
短篇/{标题}/
├── 正文.md # 完成稿
├── 小节大纲.md # 8 节结构 + 情绪曲线
└── 拆文库/ # 如有参考小说(analyze 输出)
└── {书名}/
├── 拆文报告.md
├── 情节节点.md
└── 写作手法.md拆文库: 拆文 skill 默认输出到项目根目录 拆文库/{书名}/,产出结构化目录(角色/剧情/设定/章节),是 analyze 的源数据(source of truth)。写作 skill 通过 对标/ 子目录消费这些资产(项目级引用视图),或自动回退读取 拆文库/。
`.active-book`: 项目根目录的文本文件,内容是当前活跃书目的相对路径(如 长篇/我的小说),hook 和写作 skill 据此定位当前项目。
知识体系
各 skill 自带 references/ 知识库,按需加载,不占上下文。
<details> <summary>展开各 skill 知识库主题清单</summary>
| 主题 | 内容 | 所在 skill |
|---|---|---|
| 大纲排布 | 五步大纲法 · 故事结构分级 · 节点设计法 · 升级感设计 | long-write |
| 开头设计 | 开篇模式 · 前 500 字设计 · 黄金三章开头策略 | long-write / short-write |
| 人物设计 | 角色设定 · 人物提取 · 关系映射 · 动机链 · 群像 | long-write / short-write / short-analyze |
| 钩子技法 | 章尾钩子 13 式 · 章首钩子 7 式 · 段落级钩子 · 悬念编排 | long-write / short-write / short-analyze |
| 情绪设计 | 6 种弧形模板 · 期待感管理 · 题材赛道策略 | long-write / short-write |
| 题材框架 | 长篇八节点 · 短篇压缩三幕 · 8 大题材开头模板 | long-write / short-write / short-analyze |
| 对话技法 | 节奏 · 潜台词 · 信息控制 · 对话模式数据库 | long-write / short-write |
| 反转工具箱 | 类型 · 时机 · 误导底层路径 | long-write / short-write |
| 风格模块 | 对话 · 打斗 · 智斗 · 镜头式写作 · 装逼打脸 · 白描 | long-write |
| 高级技法 | 小纲四步法 · 高潮逆推 · 双线结构 · AB 交织法 | long-write |
| 去AI味 | 预防 · 三遍去AI法 · 改写范例库 · 禁用词表 | deslop / long-write / short-write |
| 质量检查 | 通用 · 长篇专项 · 短篇专项 · 毒点排查 | long-write / short-write / short-analyze |
| 写作公式 | 21 大题材写作公式 · 三翻四震 · 感情线四阶段 | short-write / short-analyze |
| 女频写作 | 女读者偏好 · 情感描写 · 感情线模式 · 对标拆书 | short-write |
| 拆文方法 | 黄金三章 · 情绪曲线 · 结构拆解 · 知乎风格分析 | long-analyze / short-analyze |
| 短篇方法论 | 故事核 · 情节节点 · 爆点分析 · 写作手法 · 节奏分析 · 共鸣分析 · 人物分类 · 平台适配 | short-analyze |
| 拆文实例 | 完整案例拆解 · 模板化输出 | short-analyze |
| 读者画像 | 9 维画像 · 目标读者分析 | long-scan |
| 市场数据 | 题材趋势 · 平台特性 · 采集格式 · 投稿指南 | long-scan / short-scan |
| 封面风格 | 10 大题材视觉风格 · 色彩构图 · 提示词模板 | story-cover |
| 多视角审稿 | 多视角审稿 · 评分标准 · 毒点排查 | story-review |
</details>
适用平台
长篇 起点中文网 · 番茄小说 · 晋江文学城 · 七猫小说 · 刺猬猫
短篇 知乎盐言故事 · 番茄短篇 · 七猫短篇
真实产出样例见 demo/:短篇拆文《曾将爱意私藏》· 长篇拆文《盘龙》· 长篇续写工程《让你管账号,你高燃混剪炸全网》· 封面《剑道独尊》示例图。
这套 skill 现在能让我度过找工作的过渡期 :joy:,希望也能帮到有需要的朋友。
Star History
<a href="https://www.star-history.com/?repos=worldwonderer%2Foh-story-claudecode&type=date&legend=top-left"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=worldwonderer/oh-story-claudecode&type=date&theme=dark&legend=top-left" /> <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=worldwonderer/oh-story-claudecode&type=date&legend=top-left" /> <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=worldwonderer/oh-story-claudecode&type=date&legend=top-left" /> </picture> </a>
贡献
欢迎贡献新 skill、补充知识库、更新市场数据。详见 CONTRIBUTING.md。
交流
- •Telegram 群:<https://t.me/ohstoryclaudecode> —— 日常交流、踩坑、新功能讨论。
- •GitHub Discussions:提问 / 求助 / 分享用法,方便检索。
致谢
- •LINUX DO - The New Ideal Community — 社区支持
- •FanqieRankTracker — 番茄小说字体反爬解码方案参考
Install & Usage
mkdir -p .claude/skillsmkdir -p .claude/skills && curl -o .claude/skills/story.md https://raw.githubusercontent.com/worldwonderer/oh-story-claudecode/main/SKILL.md/storyFrequently Asked Questions
What is story?
ç½ç»å°è¯´å·¥å ·ç®±ä¸»å ¥å£ãæ ¹æ®ä½ çéæ±èªå¨è·¯ç±å°é¿ç¯/çç¯çæ«æ¦ãæææåä½å·¥å ·ã
How to install story?
To install story, create the .claude/skills directory in your project, then run the curl command to download the skill file. Once installed, invoke it in Claude Code with /story.
What is story best for?
story is a community categorized under General. It is designed for: novel, web-novel, router, chinese, writing, ç½æ. Created by worldwonderer.