zenstory-ai/oh-story-claudecode

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

Oh Story – AI 辅助网络小说写作技能包

这是什么 – 一套包含 13 个“技能”的集合，能将编程代理（Claude Code、Codex CLI、Google Antigravity、OpenCode、ZCode、OpenClaw、Reasonix 等）变成全栈小说写作助手。此包处理中国网络小说的完整流程：

扫榜 – 抓取市场排名以挑选有盈利潜力的主题。
拆文 – 将畅销作品拆解为可重复使用的情节模块。
写作 – 生成大纲、详细章节计划以及散文本身。
去 AI 味 – 检查输出以移除刻板的 AI 用语。
封面 – 通过内置图像模型生成封面图片。

所有这些都在你的代理已使用的模型上运行——不需要 GPU 或额外的模型部署。唯一额外的计算是一组本地 Node/Python 脚本，用于执行确定性检查并管理项目文件。

快速开始 / 安装

# 全局安装（可在任何文件夹中使用）
npx skills add zenstory-ai/oh-story-claudecode -y -g
# 或安装到当前项目
npx skills add zenstory-ai/oh-story-claudecode -y

技能添加后，在写作项目的根目录运行引导命令：

/story-setup   # 或 Codex 使用 $story-setup

这会创建所需的目录结构（设定/、大纲/、正文/、追踪/ …）并注册七个专业代理与八个自动化钩子。

核心工作流程（简化 mermaid 图）

flowchart LR
  A[Setup] --> B[扫榜]
  B --> C[拆文]
  C --> D[写作]
  D --> E[去 AI 味]
  E --> F[封面]

长篇小说遵循 扫榜 → 拆文 → 长篇写作 路径；短篇作品使用类似的短篇步骤。

主要命令（技能）

技能	触发	功能
`story-setup`	`/story-setup` 或 `$story-setup`	为当前项目部署代理、钩子与文件结构
`story-long-write`	`/story-long-write`	为长篇小说生成大纲、角色设定与章节散文
`story-short-write`	`/story-short-write`	同上，但用于短篇故事项目
`story-deslop`	`/story-deslop`	检查并移除已知的 AI 风格句子模式、标点问题与陈词滥调
`story-cover`	`/story-cover`	调用 GPT-Image-2 模型（或备用 API）根据书名/类型创建封面图片
`story-long-analyze` / `story-short-analyze`	`/story-long-analyze` / `/story-short-analyze`	将参考作品拆解为情节模块，评分节奏、钩子等
`story-import`	`/story-import`	将现有手稿转换为标准项目结构以利续写
`story-dashboard`	`/story dashboard`	启动本地网页界面（127.0.0.1）以浏览文件树、查看演示、编辑 Markdown 并运行命令

如何保持长篇一致性

文件系统记忆 – 所有设置、大纲、章节草稿与 JSON“追踪状态”都存储在磁盘上。代理只读取当前章节所需的小片段，避免上下文溢出。
守卫钩子 – guard-outline-before-prose.sh 会阻止散文生成，直到该章节的详细大纲存在。
一致性检查器 – 散文写完后，consistency-checker 代理会验证伏笔情节点、角色状态与“作者真相 vs. 读者所知”时间线是否相符。
确定性钩子 – 7 个代理（架构师、作家、一致性、角色设计师、研究员、探索者、提取者）与 8 个钩子在不产生随机惊喜的情况下确保质量。

示例输出（摘录）

## 当前章节
- 第 21 章 – 场景：火箭军文工团办公室

## 活跃伏笔
- F054｜谭守义已给邻市地址，江晨定次日上门听故事｜埋第20章｜第22章｜高
- F057｜谭守义有个讲了五十年没人听全过的故事，内容未揭示｜埋第21章｜第22章｜高

演示文件夹包含完整长篇小说文件、经典《盘龙》的拆解报告，以及生成的封面图片。

使用时机

你已经在使用 Claude Code 或类似的编程代理，并想在不启动独立 LLM 服务器的情况下添加小说写作能力。
你需要针对长篇连载网络小说（数万字）的确定性、可重复输出，而上下文大小是瓶颈。
你希望在发布前自动执行“AI 味移除”步骤，让散文感觉更人性化。

限制 / 注意事项

封面生成器依赖 GPT-Image-2 模型；如果你的代理无法访问，你需要外部 API 密钥。
所有检查都是本地脚本；它们不保证外部 AI 检测器（例如朱雀）会将文本标记为人类撰写，但它们能大幅减少刻板的 AI 用语。
此技能集与 ClawHub 分发机制绑定——你必须通过 npx skills … 或发出自然语言安装命令来安装。

社区与支持

Telegram 群组： https://t.me/ohstoryclaudecode
GitHub Discussions 与 Issues 用于故障排除、功能请求与分享输出示例。
通过常见的 pull request 流程贡献新技能、市场数据更新或额外的知识库条目。

TL;DR

Oh Story 将编程代理变成一个现成的中国网络小说作者：它抓取市场趋势、拆解畅销书、建立大纲、撰写章节、清除 AI 风格散文，甚至创建封面——全部无需额外 GPU。使用 npx skills add … 安装，运行 /story-setup，然后开始发出 /story-long-write 或 /story-short-write 命令。