MCPInstall

story-import

逆向导入已有小说。将已写好的小说(半成品或完本)反向解析为标准项目目录结构,兼容 story-long-write / story-short-write 后续写作流程;内部复用 story-long-analyze / story-short-analyze 的拆解管道,按篇幅自动分流。触发方式:/story-import、「导入小说」「反向解析」「导入」「把我的书导进来」。

Installs
16K
Last 24h
+99
Trending rank
#2003
Security
Pass

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/zenstory-ai/oh-story-claudecode --skill story-import
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads story-import automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

Security audits

Independent scans of the skill's instructions and bundled files.

Gen Agent Trust Hub PassSAFE ·The story-import skill provides a structured workflow for importing and analyzing existing novels. It utilizes local Python and Node.js scripts to manage project states and validate outlines. The analysis did not reveal any security risks.
Socket PassNo alerts
Snyk PassLOW ·Risk: LOW · No issues

SKILL.md

The instructions your agent reads when the skill is triggered.

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

名词与目录边界(全流程硬约束)

  • {导入书名}:用户自己已经写到一半或已经完本、现在要重建为工程的小说;它的分析源固定为 拆文库/{导入书名}/。
  • {对标书名}:用户另行选择的外部参考作品;它必须是独立拆解产物,来源固定为 拆文库/{对标书名}/,且不得指向本次导入源。
  • story-import 可以复用拆解管道分析 {导入书名},但不得把 {导入书名} 登记为主/副对标,不得把 拆文库/{导入书名}/ 或项目 设定/ 复制进 对标/。
  • 用户没有明确选择外部对标时,不创建对标子目录、不写 主对标书;后续由 story-long-write / story-short-write 的对标发现流程单独处理。

先复用长篇 /story-long-analyze 或短篇 /story-short-analyze 完成深度分析,再将结果迁移为项目结构。拆文方法、模板和质量检查由对应 skill 负责。

时刻表与交接

导入按下表分时刻执行,各时刻通过落盘文件交接。

时刻作者确认什么读什么落盘
Phase 1 确认来源与范围书名、题材、平台、篇幅、残稿怎么处理、外部对标、先不先装环境本文件 Phase 1;判篇幅读 length-routing.md导入记录
Phase 2 深度分析不打扰作者deep-analysis.md,再照它进入拆书流程拆文库/{导入书名}/
Phase 3 结构迁移原文没分卷时卷怎么分;要不要存本书文风长篇 structure-mapping-long.md(绑了外部对标再读 benchmark-sync.md);短篇 structure-mapping-short.md项目 设定/、正文/、大纲/(短篇为三个单文件)
逐批反推细纲(长篇)不打扰作者本批任务包(见 outline-reverse.md)大纲/细纲_第XXX章.md
Phase 4 追踪初始化(长篇)不打扰作者import-tracking.md追踪/
Phase 5 汇报与激活请作者核对、拍板的事import-report.md.active-book

书目录:长篇和短篇均为 {导入书名}/,与分析源 拆文库/{导入书名}/ 同名;写正文守卫据此放行正文迁移,名字不一致时迁正文会被拦。 导入记录:{书目录}/.story/work/导入记录.md,Phase 1 建立,格式见下方 Step 5。每个时刻开头先读它,不回翻对话;时刻交付前把作者在对话里新定的事(决定、偏好、红线、否掉的方案)和进度写回它,再往下走。 换上下文:深度分析、每批细纲、追踪初始化读的东西多。每个时刻交付后,汇报末尾加一句「下一步建议新开一个对话,说『继续导入』,会更专注」;作者要在本对话继续也照做。作者说「继续导入」时,在项目根下找进度没勾完的 */.story/work/导入记录.md,从第一个未完成的进度接着做。 导入续写入口顺序:用户只问流程时先答结论再收原文——推荐先 /story-setup,新开对话 /story-import,导完长篇 /story-long-write 写第N章(N 是导入后的下一章);也可直接导入,缺环境时 Step 4 给选择。导入过的书、追踪是旧结构的书按 import-special-cases.md 处理。


Phase 1:确认来源与范围

Step 1:确认意图

默认目标是可续写的写作工程。意图不明时主动问:「你是想把这本书做成可续写的写作工程(设定/大纲/正文/追踪,能接着往下写),还是只要一份拆文库分析?」只要分析 → 直接用 /story-long-analyze(短篇 /story-short-analyze),到拆文库为止,不建导入记录、不做迁移。

Step 2:拿到原文

未提供原文时问:「你要导入哪本书?请提供文件路径或直接贴文本。」单文件(.txt/.md)按章节分隔符切分,目录按文件名排序合并。贴入的文本在 Step 5 书名定下后原样保存到 {书目录}/.story/work/导入原文.md,供换对话后读取。原文备份到 拆文库/{导入书名}/原文/ 由 Phase 2 拆解管道负责。

Step 3:基本信息确认

  1. 自动检测书名(如有)、总章数、总字数、章节格式。
  2. 请作者确认:导入书名、题材类型、目标平台(长篇:起点/番茄/晋江/其他;短篇:知乎盐言/番茄/七猫/黑岩/红果/小程序/未定)、是否完本(半成品写到第 N 章)、篇幅(长篇/短篇,按 length-routing.md 检测:用户显式声明 > 结构信号 > 字数兜底,向作者复述结果请其确认;决定结构迁移走长篇还是短篇)、最后一章是否完整——残稿时告诉作者,请他决定「接着残章写」还是「先补完再导入」,本 skill 只记录决定,不替作者选。
  3. 外部对标(可选、与导入源分离):作者已明确指定时记录 {对标书名},并确认 拆文库/{对标书名}/ 是该参考作品的独立拆解产物;不得把 {导入书名} 或本次刚生成的拆文目录当候选。未指定时不追问,记为“未绑定”。
  4. 向作者展示检测到的章节范围、字数、篇幅、最后一章状态与“外部对标:{对标书名/未绑定}”,确认后往下走。

Step 4:写作环境检测

先读取 .story-deployed,按顶部说明检查版本,版本不匹配不阻断调用。再按顶部的当前宿主来源检查 chapter-extractor,记下 story-architect 是否可用,供逐批细纲使用。ZCode 缺角色时提示启用或更新 oh-story 插件并新开会话;作者也可选择主会话串行,不重复部署 workspace。

其他宿主 agent 不可用时这样问:

「这个项目还没装好写作环境。装好后由专门的分析助手逐段拆书,主对话不会被整本书塞满;不装也能导,只是全部在主对话里做,慢一些,结果一样完整。你想:1. 先装环境(推荐):运行 /story-setup,装完再说"导入" 2. 直接导入,慢一点也行」

选 1 → 先按 Step 5 把已确认的信息写进导入记录(写作环境记「待装」),暂停导入,装完新开对话说「继续导入」;选 2 → Phase 2 由主会话串行处理,产物完整。

Step 5:写导入记录

确认完把结果写进 {书目录}/.story/work/导入记录.md(目录不存在就建;贴入的原文同时存到同目录),再进入 Phase 2:

# 导入记录:《{导入书名}》
- 原文:{源文件或目录路径;贴入文本写 .story/work/导入原文.md}
- 篇幅:{长篇 | 短篇}({判定依据一句})
- 范围:第 1–{N} 章,约 {Y} 万字;{完本 | 半成品}
- 最后一章:{完整 | 残稿:第 {N+1} 章写了一半,作者决定{接着残章写 | 先补完再导入}}
- 题材:{题材类型};目标平台:{平台}
- 外部对标:{对标书名 | 未绑定}
- 写作环境:{已装,分析助手可用{,story-architect 可用} | 待装(继续时重新检测) | 助手不可用,作者选主会话串行}
- 卷划分:{待 Phase 3 | 按原文卷界 | 作者已确认:1–40 / 41–95 / …}
- 作者交代:{偏好、红线、否掉的方案,逐条;没有写「无」}

## 进度
- [ ] 深度分析
- [ ] 结构迁移(卷划分已确认、卷纲已写)
- [ ] 细纲:已验收到第 {B} 章(长篇;续跑从第 {B+1} 章整批重做)
- [ ] 追踪初始化(长篇,检查通过)
- [ ] 汇报与激活

Phase 2:深度分析

读 deep-analysis.md,按导入记录进入对应拆解管道,自动完成已确认的分析范围,中途停靠按该文件处理。完成后勾进度。

Phase 3:结构迁移

长篇按 structure-mapping-long.md 的迁移步骤把 拆文库/{导入书名}/ 迁成 {导入书名}/ 工程;原文没有明确卷界时,卷划分必须等作者确认,确认结果写进导入记录。结构迁移验收后,按 outline-reverse.md 逐批反推细纲。短篇按 structure-mapping-short.md 迁成 {导入书名}/ 的三个单文件,不产 追踪/、大纲/、正文/ 等长篇目录,迁完直接到 Phase 5。

Phase 4:追踪初始化(仅长篇)

读 import-tracking.md,用本 skill 自带的 scripts/tracking_commit.py init 一次性生成 追踪/,check 通过后勾进度。

Phase 5:汇报与激活

读 import-report.md:自检、按模板向作者汇报、设置 .active-book。


流程衔接

时机跳转到命令
导入完想继续写story-long-write / story-short-write/story-long-write + "写第N章"(N 是导入后的下一章) / /story-short-write + "补完构思"
导入完想审查质量story-review/story-review
想拆一本外部对标书story-long-analyze / story-short-analyze/story-long-analyze / /story-short-analyze
从零开新书story-long-write / story-short-write/story-long-write + "开书" / /story-short-write
项目未装写作环境story-setup/story-setup

FAQ

What does the story-import skill do?

逆向导入已有小说。将已写好的小说(半成品或完本)反向解析为标准项目目录结构,兼容 story-long-write / story-short-write 后续写作流程;内部复用 story-long-analyze / story-short-analyze 的拆解管道,按篇幅自动分流。触发方式:/story-import、「导入小说」「反向解析」「导入」「把我的书导进来」。

How do I install story-import?

Run npx skills add https://github.com/zenstory-ai/oh-story-claudecode --skill story-import in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/story-import/ (personal) or .claude/skills/story-import/ (project).

Which AI agents can use story-import?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is story-import safe to install?

Security partners have reviewed it: Gen Agent Trust Hub passed; Socket passed; Snyk passed. As with any skill, read the SKILL.md and bundled scripts before installing.

Who maintains story-import?

It is published by zenstory-ai in zenstory-ai/oh-story-claudecode. It has 16,007 recorded installs.

More from zenstory-ai/oh-story-claudecode

View all →

story-long-write

zenstory-ai/oh-story-claudecode

长篇网文规划与写作。支持只讨论结构、只写大纲或指定细纲,明确要求正文后再写章节。触发方式:/story-long-write、/写长篇、「帮我开书」「定设定」「出卷纲」「规划剧情」「写大纲」「补细纲」「日更」「续写」「继续写」「修改第X章」「回炉」「重写第X章」。

17.4K installs

story-deslop

zenstory-ai/oh-story-claudecode

网文去AI味。从表达、叙事用笔、故事因果三层诊断并修复文本,保留作者文风与已定剧情。触发方式:/story-deslop、/去AI味、「去AI味」「这篇太AI了」「网文去AI味」。

17.4K installs

story-long-analyze

zenstory-ai/oh-story-claudecode

长篇网文拆文。保留黄金三章、逐章摘要、剧情、情绪、节奏、角色、设定和文风接口,以连续章节块完成因果、双时间线、关系与三维节奏分析;兼容旧成果直接使用、按需增强和断点续跑。含可选三层灵感库管道(灵感库、跨书灵感聚合、更新灵感库)。触发方式:/story-long-analyze、/长篇拆文、「帮我拆这本书」「拆这本书」「分析黄金三章」「深度拆解」「完整拆解」或提供小说文本文件路径。

17.2K installs

story-short-write

zenstory-ai/oh-story-claudecode

短篇网文写作。辅助短篇小说创作,从构思到成稿,聚焦情绪拉扯与节奏把控。触发方式:/story-short-write、/写短篇、「帮我写一篇短篇」「写个盐言故事」。

17.2K installs

story-long-scan

zenstory-ai/oh-story-claudecode

长篇网文扫榜。分析起点、番茄、晋江、七猫等平台排行榜与新书数据,提炼市场趋势与热门题材。触发方式:/story-long-scan、/长篇扫榜、「长篇什么火」「起点排行」「扫七猫新书」。

17K installs

story-short-analyze

zenstory-ai/oh-story-claudecode

短篇网文拆文。拆解爆款短篇小说(番茄短篇 / 故事会 / 知乎盐言 / 追妻 / 世情 / 重生 / 虐渣等通俗题材)的故事核、结构、情感线、反转设计、写作手法、共鸣层次。单一全量拆解管道:跑完 Stage 2-6 产出完整拆文报告,落盘到 拆文库/{书名}/,下游 story-short-write 同时读拆文报告 + 情节节点 + 写作手法 + 原文 + meta.json 写下一篇。触发方式:/story-short-analyze、/短篇拆文、「拆短篇」「拆这篇短文」「短篇拆文」「精细拆解短篇」「8000 字短篇拆解」「番茄短篇拆文」「故事会拆解」「盐言故事拆解」「分析这篇短篇」——均进入同一管道。

17K installs

Popular other skills

View category →

hyperframes-cli

heygen-com/hyperframes

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

1.3M installs

triage

mattpocock/skills

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs