OH Story — 网文写作全流程 Skill 包
覆盖扫榜、拆文、写作、去AI味、封面全流程的网文创作 Skill 包,适配多款 AI 编码工具。
证据显示:项目采用最小权限原则,hooks 仅做检查不阻断(除大纲守卫),dashboard 仅监听 127.0.0.1,数据不上传;用户确认:安装需用户主动执行,部署需用户运行 /story-setup,hooks 需用户信任;数据流透明:README 明确说明数据流向,dashboard 本地服务;敏感数据处理:小说内容不上传,但未明确说明如何处理用户 API 密钥等;依赖安全:依赖较少,devDependencies 仅 Playwright,但未提供依赖审计;外部影响:hooks 会修改项目文件,但需用户部署;回滚:提供 UPGRADING.md 迁移指南,但未提供自动回滚;来源归属:README 致谢第三方工具,但未明确说明所有第三方代码来源。扣分:敏感数据处理和依赖安全证据不足,回滚仅文档。
证据显示:项目内部一致性较好,README 与 skills 描述一致;依赖可用性:依赖较少,但未提供依赖锁定;失败消息:README 提到 Windows 安装报错提示,但未提供全面的错误处理文档。扣分:依赖锁定和错误处理文档不足。
证据显示:明确目标用户(网文作者),场景覆盖长篇/短篇全流程;能力边界:README 说明各 skill 功能,但未明确限制;触发精度:提供多种触发方式,但未说明冲突处理;环境适配:支持多种 CLI 和平台,提供适配说明。扣分:能力边界和触发冲突处理不足。
证据显示:信息架构清晰,README 有完整目录;安装说明详细,提供多种安装方式;命名稳定:skill 命名一致,但未说明命名规范;示例和 FAQ:提供 demo 和常见问题;已知限制:README 提到部分平台限制,但未全面列出;许可证:MIT 许可证明确;版本和变更日志:有 CHANGELOG.md 和版本说明;维护责任:未明确维护者。扣分:命名规范、已知限制、维护责任不足。
证据显示:输出可用性高,提供结构化输出和 demo;边际价值:提供完整写作流程,价值明显;成本效益:免费开源,但需要用户配置环境。扣分:成本效益未量化。
证据显示:声明可追溯,README 提供 demo 和文档;交叉验证:提供外部工具参考,但未提供独立验证;事实与推断分离:README 区分了事实和推断。扣分:交叉验证不足。
- 未验证发布者身份,安装前请自行审查代码。
- hooks 会修改项目文件,部署前请备份。
- 依赖未锁定,存在供应链风险。
- 敏感数据处理细节不明确,请勿在项目中存放密钥。
这个 Agent 能做什么,适合哪些场景?
oh-story-claudecode 是一套面向中文网络小说的写作 Skill 包,内置 13 个 skill,覆盖长篇与短篇的扫榜、拆文、写作、去AI味、封面生成等环节,并支持导入已有小说逆向重建写作工程。它通过 7 个专业 Agent(如 story-architect、narrative-writer、consistency-checker)协同工作,并部署 8 个自动化 hooks 用于会话管理、大纲守卫和正文检查。项目采用文件系统管理设定、大纲、正文与追踪状态,支持 Claude Code、OpenCode、ZCode、OpenClaw、Codex CLI、Reasonix 等平台,对无法使用自定义 Agent 的环境提供 solo fallback。核心思路是将写作套路拆解为“扫榜、拆文、商业化写作”,强调情绪满足与模块化重组。
执行扫榜(story-long-scan/story-short-scan)分析起点、番茄、知乎等平台趋势;拆文(story-long-analyze/story-short-analyze)产出结构化拆文报告(含故事情节节点、情绪模块、写作手法等);写作(story-long-write/story-short-write)根据大纲与对标书籍生成正文,利用追踪状态保证连续性;去AI味(story-deslop)检测并清除 AI 写作痕迹;导入已有小说(story-import)逆向重建大纲、设定与追踪;生成封面(story-cover)使用 GPT-Image-2;审查(story-review)调用多 Agent 多视角评分。所有 skill 通过自然语言或斜杠命令触发,配置文件写入项目 .claude/agents/、.codex/agents/ 等,并利用 hooks 在写作前强制搭建大纲。
- 长篇网文作者:使用 story-setup 部署环境,story-long-scan 扫榜,story-long-analyze 拆解对标书籍,story-long-write 按日更或章节续写。
- 短篇创作者:利用 story-short-scan 发现热点,story-short-analyze 拆解爆款短篇,story-short-write 生成新短篇。
- 已有连载作品的作者:使用 story-import 将已发布章节逆向导入为工程,便于后续无缝续写。
- 希望去除 AI 味的写手:使用 story-deslop 对稿件进行 lint 与外部检测,提升人工读感。
- 需要封面设计的作者:使用 story-cover 分析题材并生成配图。
- 使用 Codex/OpenCode 等非 Claude Code 环境的用户:通过 $story-setup 部署到对应平台,按需使用。
这个 Agent 有哪些优点和局限?
- 全流程覆盖,从扫榜、拆文到写作、去AI味、封面生成,集成度高。
- 模块化拆文与对标学习,可复用优质写作套路。
- 支持多平台(Claude Code、Codex、OpenClaw 等),提供自然语言触发与斜杠命令。
- 文件系统管理项目状态,便于审计与版本控制。
- 内置 7 个专业 Agent 分工协作,提升写作效率。
- 部署依赖多平台配置,不同 CLI 的支持程度不一(如 ZCode 3.3.4 不支持 custom agents,功能降级)。
- 需要新开会话或重跑 /story-setup 才能应用更新,升级流程稍显繁琐。
- 部分功能(如 browser-cdp)需要网络与外部服务,可能涉及爬取限制。
- 文档与示例以中文为主,不熟悉中文环境的用户可能上手困难。
如何安装或部署这个 Agent?
方式一:在 AI 编码工具中直接说“安装这个 skill https://github.com/worldwonderer/oh-story-claudecode”。方式二:命令行执行 npx skills add worldwonderer/oh-story-claudecode -y -g(全局安装)或去掉 -g 仅安装到当前目录。升级时重复同一条命令。Windows 若出现 ENOENT 报错,重跑命令即可修复。
如何使用这个 Agent?
安装后,在写作项目根目录运行 /story-setup(或 $story-setup)部署 hooks、agents 与 AGENTS.md,然后新开会话。使用 /story-long-write、/story-short-write 等斜杠命令或自然语言(如“帮我开书”)触发对应 skill。对于已有小说,先运行 /story-import 导入。小说内容仅在本地处理,Dashboard 服务监听 127.0.0.1。
这个 Agent 与同类方案有什么区别?
未在源中找到确切的替代品比较,但可视为通用写作辅助工具,与专门的网文写作软件或纯提示词方案相比,它提供了结构化的拆文与工程化管理。