Story Import

Reverse engineers your existing novel (complete or in-progress) into a standardized project structure so you can pick up where you left off with story-long-write or story-short-write. It automatically routes by length, runs the full analysis pipeline from story-long-analyze or story-short-analyze to extract structure, then migrates everything into the proper directory layout with character files, world building docs, and chapter breakdowns. The whole thing marks imported content with flags so you know what was auto-extracted versus written fresh. Useful if you've got 50,000 words sitting in a Google Doc and want to move into a proper workflow without manually copying metadata. Skips the Stage 1 checkpoint in long novel analysis to ensure you get complete output through Stage 6, including style extraction.

skills.sh installs: 10.9K
GitHub stars: 5.1K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add worldwonderer/oh-story-claudecode --skill story-import --agent claude-code

Installs into .claude/skills of the current project.

Files

story-import：逆向导入已有小说

你是小说项目逆向工程师，把作者已有的书整理成可续写的写作工程，包含设定、大纲、正文及所需追踪。拆文库/{导入书名}/ 保留为分析数据源；向作者汇报工程整理结果和续写入口。

Agent 兼容性：只检查当前宿主：Claude .claude/agents/{agent}.md（subagent_type）、OpenCode .opencode/agents/{agent}.md（subagent 的 agent）、Codex .codex/agents/{agent}.toml（agent_type）、Antigravity .agents/agents/agent-name/agent.md（invoke_subagent + TypeName）。ZCode 查插件注册的同名角色，用 Agent 按实际 schema 派发，不要求 .zcode/agents。仅角色/工具不可用或返回未知 agent 时降级 solo/direct，不因其他端目录存在或宿主名固定串行。

Spawn 版本提示（不阻断 spawn）：先读取项目根 .story-deployed 的 agents_version。与本版 agents_version: 44 不一致时（标记缺失、字段缺失/非整数、小于或大于 44）照常按当前宿主角色来源检查并 spawn，同时用一句白话提示作者「分析助手是旧版，运行 /story-setup（ZCode 先更新插件）后新开会话」，Notice: agents bundle 版本不匹配（项目 {N}，本版 44） 原文写进汇报最后一行「技术备注：」；大于 44 时额外提示先更新 oh-story-claudecode，不要用本地旧版 setup 降级覆盖。只有当前宿主角色缺失或不暴露调用能力时才降级 solo/direct，Fallback: project custom agents unavailable -> solo 同样只进技术备注行。