网文/小说写作 skill 包,覆盖长篇与短篇网络小说的扫榜、拆文、写作、去AI味、封面图全流程
# Add to your Claude Code skills
git clone https://github.com/worldwonderer/oh-story-claudecodeGuides for using ai agents skills like oh-story-claudecode.
Last scanned: 5/6/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-06T06:30:40.499Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": true
}oh-story-claudecode is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by worldwonderer. 网文/小说写作 skill 包,覆盖长篇与短篇网络小说的扫榜、拆文、写作、去AI味、封面图全流程. It has 4,144 GitHub stars.
Yes. oh-story-claudecode passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/worldwonderer/oh-story-claudecode" and add it to your Claude Code skills directory (see the Installation section above).
oh-story-claudecode is primarily written in JavaScript. It is open-source under worldwonderer on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh oh-story-claudecode against similar tools.
No comments yet. Be the first to share your thoughts!
English | 中文
网文写作 skill 包,覆盖长篇与短篇网络小说的扫榜、拆文、写作、去AI味、封面图全流程。内置适配 Claude Code、OpenCode、ZCode、OpenClaw、Codex CLI、Reasonix、workbuddy;能读取项目文件的 Web AI / Agent 环境也可按通用 skills 路径使用。
套路 = 确定性的情绪满足
专业作者的方法论三步走:
围绕四条线展开:爆款逆向 · 剧情模块化重组 · 上下文状态分层管理 · 人机协同。
v0.6.23 起:新增 ZCode 3.3.4 原生适配——仓库可作为 marketplace/plugin 安装,暴露 13 个 Skills、13 个 Commands 与严格 JSON Hooks;
story-setup支持target_cli=zcode,安全合并.zcode/config.json与根AGENTS.md。ZCode 当前不执行项目/plugin custom agents,涉及专业 Agent 的流程会明确降级为 solo/direct。v0.6.22 起:长篇正文接入「题材正文提示卡」——32 个番茄题材的腔调卡在写作时按题材召回进写手(卡内容绝不入正文),并配套大纲边界与逐章写法公式防越界注水;短篇新增投稿层
submission-craft(知乎盐选/小程序/番茄三路平台基调、导语门面打磨、付费点断点设计);全套件 skill 文档去重瘦身约 33KB;story-setup 支持 generic Web AI 部署。已部署项目需重新运行/story-setup并新开会话。v0.6.21 起:短篇写作参考栈瘦身——
story-short-write删除长篇继承残留 references,改由short-format/short-craft/short-deslop+ 四个题材包(追妻火葬场、复仇打脸、总裁豪门、宅斗宫斗)承接短篇格式、情绪直给、节奏密度和去 AI 味;已部署项目建议重新运行/story-setup并新开会话,获取新版 narrative-writer 短篇例外。更早版本变更见 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,或其他支持导入 GitHub 仓库/skill 的 Web AI / Agent 平台:
安装这个 skill https://github.com/worldwonderer/oh-story-claudecode
方式二 命令行:
npx skills add worldwonderer/oh-story-claudecode -y -g
-g 全局安装,所有目录可用;去掉 -g 则只装到当前目录。更新时重新执行同一条命令即可。
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/配置层并在/hooksreview/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与单行 JSONmetadata.openclaw。story-setup选择target_cli=openclaw时会把 skills 复制到项目skills/并写入 OpenClaw 版AGENTS.md;agents/hooks 暂不部署,写正文前大纲守卫在 OpenClaw 下是 skill 内软约束。部署后如未显示新 skills,请新开 OpenClaw session 或等待 watcher 刷新。Reasonix 用户: 当前支持 skills + 原生 plugin manifest(Phase 1):Reasonix 原生扫描
.agents/skills(指向skills/的 symlink)发现 13 个 skill,用reasonix doctor capabilities校验;也可用根reasonix-plugin.json走reasonix plugin install。项目级story-setup部署与 hooks 是后续阶段。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 执行。升级后如果项目里已经跑过
/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 与 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 或继续串行导入。
| Skill | 触发 | 说明 |
|---|---|---|
story-setup |
/story-setup $story-setup /准备写书 |
环境部署 · Claude/OpenCode/Codex/ZCode/OpenClaw + generic(已有配置安全合并) |
story |
/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-deslop的本地检查是写作 lint:blocking 只限确定性句式/标点问题,其他提示按读感判断;朱雀等外部检测只作自测参考,不替代人工读感。
自然语言同样触发:
story-long-writestory-deslopstory-importstory-explorer agent
使用 /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 # 盘龙戒指 + 德林柯沃特
└── 势力/
└── 巴鲁克家族.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
├── 追踪/ 伏笔.md · 时间线.md · 角色状态.md · 上下文.md
└── 参考资料/ 作品信息.md
逐章提取(事件 / 角色 / 设定 / 伏笔 / 时间线)反推为续写 bible,作者从第 21 章无缝接着写。
写作 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+ 份方法论文件),不预占上下文。
/story-setup 部署后自动生效的 7 个 hook:
| Hook | 触发时机 | 功能 |
|---|---|---|
| session-start.sh | 会话开始 | 显示分支、 |