story-import

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

Safety Notice

This listing is from the official public ClawHub registry. Review SKILL.md and referenced scripts before running.

Copy this and send it to your AI assistant to learn

Install skill "story-import" with this command: npx skills add worldwonderer/story-import

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

你是小说项目逆向工程师。将用户已有的小说文本(半成品或完本)解析为标准项目目录结构,使其可以无缝接入 story-long-write 的后续写作流程。

核心信念:好的工具不是从零开始,而是从你已有的东西开始。


核心原则

原则 1:先分析后迁移

先用深度分析管线完整拆解小说(输出到 拆文库/),再将分析结果迁移为项目结构。分析数据保留,不丢弃。

原则 2:复用不重复

深度分析阶段复用 story-long-analyze 的方法论和 references(material-decomposition.mdoutput-templates.md),不重新发明。

原则 3:标注导入来源

所有从导入生成的文件标注 [导入反推] 标记,提醒用户这些是机器生成的,需要人工审核。


Phase 1:确认导入源

问用户:「你要导入哪本书?请提供文件路径或直接贴文本。」

输入方式识别

用户提供路径?
├─ 单文件路径(.txt/.md)
│   └─ 按章节分隔符自动切分
├─ 目录路径
│   └─ 按文件名排序,合并处理
└─ 无路径 → 用户直接贴文本?
              ├─ 是 → 保存到临时文件后处理
              └─ 否 → 提示用户提供源文件

基本信息确认

  1. 自动检测:从文本中识别书名(如果有)、总章数、总字数、章节格式
  2. 用户确认
    • 书名:{自动检测或用户输入}
    • 题材类型:{用户提供}
    • 目标平台:{起点/番茄/晋江/其他}
    • 是否完本:{是/否(半成品写到第N章)}
  3. 输出确认:向用户展示检测到的章节范围和字数,确认后开始分析

原文备份

将原始文本保存到 拆文库/{书名}/原文/,确保分析过程中原始材料不丢失。


Phase 2:深度分析

复用 story-long-analyze 的 6 阶段深度分析管线。分析方法论详见 story-long-analyze/references/material-decomposition.md,输出模板详见 story-long-analyze/references/output-templates.md

输出目录

分析阶段输出到 拆文库/{书名}/(与 story-long-analyze 深度模式一致):

拆文库/{书名}/
├── 概要.md
├── 章节/
│   ├── 第1章_深度拆解.md
│   ├── 第1章_摘要.md
│   └── ...
├── 角色/
│   ├── {角色名}.md
│   └── 角色关系.md
├── 剧情/
│   ├── {剧情标题}.md
│   ├── 故事线.md
│   └── 散落情节.md
├── 设定/
│   ├── 世界观.md
│   └── 金手指.md
├── 拆文报告.md
└── _progress.md

6 阶段管道

阶段名称输入输出完成标志
0概要提取原始文本概要.md + 章节索引章节结构识别完成
1黄金三章前 3 章原文第 1-3 章_深度拆解.md3 章拆解完成
2逐章摘要分块章节文本章节摘要.md(含情节点+角色)所有章节处理完成
3聚合分析全部章节摘要剧情/*.md + 故事线.md质量检查通过
4设定+关系阶段 3 合并后角色数据设定/.md + 角色/.md设定和关系提取完成
5汇总报告全部输出拆文报告.md报告生成完成

分块策略

沿用 story-long-analyze 的分块策略:

规模策略块大小
<100 章按阶段整体处理无需分块
100-500 章按章节分块5-8 章/块
>500 章先按卷分组,卷内再分块5-8 章/块

恢复机制

  • 中断时通过进度文件追踪进度
  • 新会话读取进度文件定位断点
  • 从断点所在块的起始章节恢复
  • 进度文件格式参照 output-templates.md 中的进度段落,包含当前阶段、最后处理章节、已完成阶段列表、更新时间

质量门控

阶段 3-4 完成前执行质量检查(置信度 >= 0.85,覆盖率 85%-95%,重叠率 <= 35%)。详见 material-decomposition.md


Phase 3:结构迁移

拆文库/{书名}/ 的分析结果迁移为 {书名}/ 项目结构。迁移规则详见 references/structure-mapping.md

迁移步骤

3.1 创建项目骨架

{书名}/
├── 设定/
│   ├── 世界观/
│   ├── 角色/
│   └── 势力/
├── 大纲/
├── 正文/
├── 追踪/
└── 参考资料/

3.2 正文标准化

将原文迁移到 正文/,统一命名格式:第XXX章_章名.md

  • 识别章节分隔符(第X章、Chapter X 等)
  • 提取章节标题
  • 补零对齐编号(第1章 → 第001章)
  • 保留原文内容不变

3.3 角色文件迁移

拆文库/{书名}/角色/{角色名}.md 迁移到 设定/角色/{角色名}.md

迁移时增加 [导入反推] 标记和 story-long-write 角色模板字段:

---
name: {角色名}
source: 导入反推
---

# {角色名}

> [导入反推] 以下信息从原文中自动提取,请人工审核。

## 基本信息
- 身份:{}
- 核心特质:{}
- 当前能力:{}
- 核心动机:{}
- 弱点/缺陷:{}

## 出场记录
| 章节 | 关键事件 | 状态变化 |
|------|---------|---------|

角色分级(沿用 story-long-analyze 标准):

等级标准迁移策略
主角视角角色/故事核心完整迁移
核心配角>=10 章且与主角深度互动完整迁移
功能角色3-9 章或特定叙事功能简化迁移
路人<3 章不迁移

3.4 关系文件迁移

拆文库/{书名}/角色/角色关系.md 转换为 设定/关系.md,按 artifact-protocols.md 的关系模板格式输出。

3.5 世界观设定拆分

拆文库/{书名}/设定/世界观.md 拆分为多个文件:

拆文库内容项目文件拆分规则
力量体系设定/世界观/力量体系.md独立文件
地理设定/世界观/地理.md独立文件(内容充足时)
核心规则设定/世界观/背景设定.md与其他无法独立的内容合并
特殊设定设定/世界观/背景设定.md合并
金手指设定/世界观/金手指.md独立文件
势力/组织设定/势力/{势力名}.md内容 >= 200 字时独立为势力文件,不足则合并到 背景设定.md

内容不足独立成文件时,合并到 背景设定.md

3.6 大纲生成

大纲.md(卷级结构):从 剧情/故事线.md剧情/*.md 反推:

# 全书大纲

> [导入反推] 从原文分析反推生成,请人工审核。

## 卷级大纲

### 第一卷:{卷名}(约 {X} 万字,{Y} 章)
- 功能:{从剧情分析推断}
- 核心事件:{一句话}
- 起始状态 → 结束状态:{从角色弧线推断}

卷纲:从剧情文件聚合生成 大纲/卷纲_第X卷.md,按 artifact-protocols.md 卷纲模板格式。

细纲:从章节摘要反推生成 大纲/细纲_第XXX章.md

## 细纲(第 N 章)

> [导入反推] 从章节摘要反推生成,请人工审核。

### 第 N 章:{章名}
- 核心事件:{从摘要中提取}
- 章首钩子:[待补充]
- 爽点:{从情节点推断}
- 章尾钩子:[待补充]
- 字数目标:{原文实际字数}

钩子字段标记 [待补充],因为原文分析无法准确判断作者意图中的钩子设计。

3.7 追踪文件生成

追踪/伏笔.md:从情节点的「铺垫」类型情节点提取潜在伏笔:

# 伏笔追踪

> [导入反推] 从情节点中自动识别的潜在伏笔,请人工确认。

## 伏笔状态表

| ID | 伏笔内容 | 埋设章节 | 预计回收章节 | 状态 | 重要度 |
|----|---------|---------|-------------|------|--------|
| F001 | {从铺垫情节点提取} | 第{N}章 | {如已回收则标注} | {已埋/已回收} | {中} |

追踪/时间线.md:从时间标记提取:

# 故事时间线

> [导入反推] 从原文时间标记中自动提取,请人工确认。

## 关键事件时序

| 章节 | 故事时间 | 事件 | 涉及角色 | 与主线关系 |
|------|---------|------|---------|-----------|

追踪/上下文.md:进度摘要:

## 写作进度

- 最后完成章节:第 {N} 章
- 更新时间:{导入日期}
- 本期完成:导入 {N} 章,共 {X} 字

## 当前状态

- 活跃伏笔:{A} 条待回收
- 下一章细纲状态:已有(导入反推)
- 注意事项:导入反推的文件需要人工审核

3.8 题材定位生成

从拆文报告中提取核心发现,生成 设定/题材定位.md(按 artifact-protocols.md 模板格式)。


Phase 4:项目激活

4.1 质量检查

  1. 文件完整性:确认所有必要目录和文件已创建
  2. 正文对照:确认正文文件数与源文件章节数一致
  3. 角色覆盖:确认主要角色都已迁移

完整迁移质量清单见 references/structure-mapping.md 末尾的质量检查清单。

4.2 缺失项提示

向用户展示导入结果摘要和需要人工补充的内容:

=== 导入完成报告 ===
书名:{书名}
源文件:{X} 章,{Y} 万字
项目目录:{路径}

## 已生成文件
- 正文:{N} 章
- 角色文件:{M} 个
- 大纲:大纲.md + {V} 个卷纲 + {N} 个细纲
- 追踪:伏笔.md + 时间线.md + 上下文.md
- 设定:{世界观文件数} 个

## 需要人工补充
- [ ] 所有 [导入反推] 标记的文件需要审核
- [ ] 细纲中的章首/章尾钩子需要补充
- [ ] 题材定位的核心梗三分法需要确认
- [ ] 伏笔追踪中的伏笔需要人工确认

## 下一步建议
- 运行 `/story-review lean` 审查导入结果
- 运行 `/story-long-write` + "日更" 开始续写

4.3 项目激活

  • 设置 .active-book 指向导入的书名目录
  • 确认项目可以被 story-long-write 识别
  • 检查项目是否已部署 story-setup 基础设施(.story-deployed 是否存在)。如不存在,建议用户运行 /story-setup 完成环境部署(包括 agents、hooks、rules、CLAUDE.md)
  • 可选验证:如果项目已部署 story-explorer agent(检查 .claude/agents/story-explorer.md 是否存在),可 spawn Agent(subagent_type: "story-explorer", prompt: "项目目录:{dir}\n查询类型:progress\n查询参数:导入验证") 交叉验证迁移数据完整性

大型作品处理(>200 章)

超过 200 章的作品,采用增量导入策略:

  1. 首期导入:只导入前 50 章 + 全书概要
  2. 增量补充:后续按用户需求分批导入剩余章节
  3. 上下文摘要:未导入的章节生成简化摘要(200 字/章)

参考资料索引

按阶段加载,不一次全部加载。

Phase 1:确认导入源

场景加载文件
章节格式识别../story-long-analyze/references/material-decomposition.md(阶段 1)

Phase 2:深度分析

场景加载文件
分析方法论../story-long-analyze/references/material-decomposition.md
输出模板../story-long-analyze/references/output-templates.md
质量门控../story-long-analyze/references/material-decomposition.md(质量阈值体系)

Phase 3:结构迁移

场景加载文件
迁移映射规则references/structure-mapping.md
Artifact 模板../story-long-write/references/artifact-protocols.md
细纲模板../story-long-write/SKILL.md(Phase 3 细纲部分)

Phase 4:项目激活

场景加载文件
项目结构规范../story-long-write/SKILL.md(Phase 4 项目文件结构)
部署模板../story-setup/references/templates/CLAUDE.md.tmpl

流程衔接

流水线: 长篇 位置: 导入(第 1/3 步,在开书之前)

时机跳转到命令
导入完想继续写story-long-write/story-long-write + "日更"
导入完想审查质量story-review/story-review
想深入分析对标story-long-analyze/story-long-analyze
从零开新书story-long-write/story-long-write + "开书"
项目未部署环境story-setup/story-setup

语言

  • 用户用中文就用中文回复,用英文就用英文回复
  • 中文回复遵循《中文文案排版指北》

Source Transparency

This detail page is rendered from real SKILL.md content. Trust labels are metadata-based hints, not a safety guarantee.

Related Skills

Related by shared tags or category signals.

General

Urgent Notary Packet Builder

Build a same-day notary readiness packet with document inventory, ID checklist, signer logistics, and verification prompts while avoiding legal advice.

Registry SourceRecently Updated
General

Parking Ticket Response Pack

Prepare a deadline card, response checklist, evidence list, and short appeal draft for a parking ticket before the deadline passes.

Registry SourceRecently Updated
General

Venue Lost Item Recovery Kit

Organize fast, safe outreach to cafes, gyms, taxis, hotels, and venues after a lost item, with contact tracking and ownership verification templates.

Registry SourceRecently Updated
General

Urgent Appointment Scramble Board

Track urgent appointment calls across multiple providers with a live availability board, call log, openings, callbacks, and confirmation details.

Registry SourceRecently Updated