story-import

English | 中文

oh-story-claudecode

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

核心思路

套路 = 确定性的情绪满足

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

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

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

v0.7.0 起：多端适配再扩两家——ZCode 3.3.4 原生适配（仓库作 marketplace/plugin 安装，story-setup target_cli=zcode）与 Reasonix Phase 1（skills + 原生 plugin manifest）；hook 核统一到共享 node 核并加六端 parity 锁；长篇把「剧情条/循环卡/…」五个叫法统一为「剧情单元」并把拆书产物接入卷纲/细纲；去 AI 味闸口机器化——写后正文网自动扫描确定性毒句式，写下一章前新增「毒句式欠账门」（无状态、node 缺失放行、可用 <!-- 去味:跳过 --> 显式豁免）。已部署项目需重新运行 /story-setup 并新开会话。

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/ 配置层并在 /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（Phase 1）：Reasonix 原生扫描 .agents/skills（指向 skills/ 的 symlink）发现 13 个 skill，用 reasonix doctor capabilities 校验；也可用根 reasonix-plugin.json 走 reasonix plugin install。项目级 story-setup 部署与 hooks 是后续阶段。Windows 未启用 symlink 时改走原生 plugin。