Skip to content

zenstory-ai/oh-story-claudecode / skills/story-import

story-import

Verified

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

references/structure-mapping-long.md

View on GitHub
# 结构迁移(长篇)

长篇的结构迁移按本文件把 `拆文库/{导入书名}/` 转成长篇项目 `{导入书名}/`。书目录名与拆文目录名相同,写正文守卫据此放行正文迁移。

外部对标、目标平台与作者交代取自导入记录(`{书目录}/.story/work/导入记录.md`)。本时刻只建追踪目录骨架,状态由 Phase 4 初始化;逐章细纲在最后一步分批反推。

---

## 迁移步骤

### Step 1:创建项目骨架

```
{导入书名}/
├── 设定/
│   ├── 世界观/
│   ├── 角色/
│   └── 势力/
├── 大纲/
├── 正文/
├── 追踪/
│   └── 逐章记录/
├── 对标/                       # 可选;仅在显式绑定外部对标时创建子目录
└── 参考资料/
```

### Step 2:正文标准化

将原文迁移到 `正文/`,统一命名 `第XXX章_章名.md`:识别章节分隔符、提取章节标题、补零对齐编号(第1章 → 第001章)、保留原文内容不变,规则见下方「正文标准化规则」。

### Step 3:角色文件迁移

将 `拆文库/{导入书名}/角色/{角色名}.md` 迁移到 `设定/角色/{角色名}.md`,按下方「角色文件迁移模板」写。角色分级沿用拆文档案里的「定位」:

| 等级 | 标准(按故事作用定级,出场比例仅作线索) | 迁移策略 |
|------|------|---------|
| 主角 | 推动主线核心视角与抉择 + 完整成长轨迹 | 完整迁移 |
| 反派 | 与主角构成核心对立 + 推动主冲突 + 明确动机(含幕后或中后期登场主反派) | 完整迁移 |
| 核心配角 | 推动重要支线、关键关系或阶段转折,有独立立场与弧线(不因登场晚或占比 <20% 降级) | 完整迁移 |
| 功能角色 | 仅承担单次传话、见证或场景触发,无独立支线与弧线 | 只填模板里标了「功能角色也填」的项 |

### Step 4:关系文件迁移

将 `拆文库/{导入书名}/角色/角色关系.md` 转换为 `设定/关系.md`,按下方「关系文件转换规则」输出。

### Step 5:同步世界观设定

当前拆文契约按主题输出 `拆文库/{导入书名}/设定/世界观/*.md` 与 `设定/势力/*.md`,导入时原样同步;`世界观/` 必须有 `背景设定.md`(`力量体系.md`、`地理.md` 或小势力资料不足 200 字时,上游已并入 `背景设定.md`,独立文件可省略)。当前产物缺失时停止并提示修复 Stage 4;检查器确认的旧成果则从已有扁平设定转换到当前项目路径,标注来源,不回写或覆盖拆文库。

### Step 6:题材定位生成

从拆文报告中提取核心发现,生成 `设定/题材定位.md`(下方「题材定位生成」模板)。本书题材、核心梗、情绪与节奏摘要来自 `拆文库/{导入书名}/`,但这些字段不是对标登记,不得用 `{导入书名}` 填对标。导入记录里「作者交代」的偏好与红线同步写进模板的「作者已定」小节,续写时才看得到。

### Step 7:外部对标(只在导入记录绑定了外部对标时)

导入记录绑定了外部 `{对标书名}` 时,读 [benchmark-sync.md](benchmark-sync.md) 照做:在题材定位追加对标登记,把 `拆文库/{对标书名}/` 的资料和文风同步到 `对标/{对标书名}/`。没有绑定时跳过本步,不创建对标子目录。

### Step 8:本书文风

项目里还没有 `设定/文风.md`、而 `拆文库/{导入书名}/文风.md` 存在时,问作者:「拆书时整理了这本书自己的文风(句子长短、对话写法、常用手法),要存成本书的文风设定吗?存了以后续写照这个写;不存就按对标或默认写法。」作者同意后复制成 `设定/文风.md`,第一行写 `> 来源:导入时从本书已写章节整理(拆文库/{导入书名}/文风.md)`;不同意就不建。已有 `设定/文风.md` 时不覆盖、不提问。本书文风只放 `设定/`,不复制进 `对标/`。

### Step 9:大纲与卷纲(作者确认点)

按下方「大纲反推规则」反推 `大纲/大纲.md`:原文有明确卷界直接按卷界分;没有时向作者展示候选卷划分,**等作者确认后**才写定卷级结构和 `大纲/卷纲_第X卷.md`,确认结果(或「按原文卷界」)写进导入记录的「卷划分」。`剧情/散落情节.md` 合并到相关卷纲或大纲附录。

每份卷纲写完,按当前平台探测 Python 3(`python3` → `python` → `py -3`)跑 `{PYTHON} {story-import skill 根}/scripts/outline_view.py --check --strict {书目录}/大纲/卷纲_第X卷.md`,问题数归零才算写定;写正文时用同一个脚本按单元取卷纲,若未通过,续写第一章会停止。

### Step 10:逐批反推细纲

卷纲写定、本文件末尾的质量清单通过后,在导入记录勾「结构迁移」,再按 [outline-reverse.md](outline-reverse.md) 分批反推细纲。细纲时刻只读任务包,不再读本文件;建议作者新开对话说「继续导入」再开始第一批。

---

## 映射总览

| 拆文库路径 | 项目路径 | 转换方式 |
|-----------|---------|---------|
| `原文/` | `正文/第XXX章_章名.md` | 按章节分割并标准化命名 |
| `快速预览.md` | — | 参考卷划分候选、剧情走向,不直接迁移 |
| `角色/{角色名}.md` | `设定/角色/{角色名}.md` | 按角色卡模板改写 |
| `角色/角色关系.md` | `设定/关系.md` | 格式转换 |
| `设定/世界观/*.md` | `设定/世界观/*.md` | 按主题原样同步 |
| `设定/势力/*.md` | `设定/势力/*.md` | 按势力原样同步 |
| `剧情/故事线.md` | `大纲/大纲.md` | 反推卷级结构(需用户确认卷划分,见下) |
| `剧情/{标题}.md` | `大纲/卷纲_第X卷.md` 的一段剧情 | 一个剧情文件对应一张剧情段卡 |
| `剧情/节奏.md` | `设定/题材定位.md`(节奏摘要) | 提炼已写部分的既有节奏,保留为本书导入基线;不复制到 `对标/` |
| `剧情/情绪模块.md` | `设定/题材定位.md`(情绪摘要)、剧情段卡「这段让读者图什么」 | 提炼已写部分的读者需求与情绪引擎;不复制到 `对标/` |
| `文风.md` | `设定/文风.md` | 作者同意才建(Step 8) |
| `章节/第N章_摘要.md` | `大纲/细纲_第XXX章.md` | 逐批反推([outline-reverse.md](outline-reverse.md)) |
| — | `设定/题材定位.md` | 从拆文报告生成 |
| `剧情/散落情节.md` | `大纲/大纲.md` 附录或对应卷纲 | 合并到相关卷的大纲 |

旧拆文的目录或字段名与上表不同时,先建立一次“旧路径 → 当前目标”的来源映射,再按实际可读内容转换;不要为了改名再复制出一套拆文目录。`剧情/节奏.md`、`剧情/情绪模块.md` 或主题化设定缺失时,旧内容能支持的导入步骤照常执行,对应摘要写「未知/待增强」;只有用户要启用依赖这些资料的新对标召回时,才回到 story-long-analyze 做按需增强。

---

## 正文标准化规则

- **命名格式**:统一命名为 `第{零填充三位}章_{章名}.md`(如 `第001章_初入江湖.md`;无章名写 `第001章_无题.md`)。
- **章节分隔识别**:单文件按 `第X章/回/节`(含 `#` 标题前缀)、`Chapter X` 或 `1. 标题` 等分隔符切分。
- **内容处理**:保留小说正文(不改写情节、措辞或台词),编码统一为 UTF-8,仅移除可确认不属于小说正文的下载广告等文件头尾信息(无法确认的内容保留)。

---

## 角色文件迁移模板

字段与长篇写作的主角卡、配角卡一致,续写时可直接使用。证据取拆文档案和关键情节;外貌从原文找依据填、缺依据写 `[待补充]`;口头禅与标志动作只在原文确实反复出现时引原句,没有写「无固定口头禅」,不硬凑。

```markdown
---
name: {角色名}
---

# {角色名}

## 角色卡
- 角色定位:{主角/反派/核心配角/功能角色;一句话说清在故事里干什么}(功能角色也填)
- 身份标签:{截至第 N 章的身份}(功能角色也填)
- 与主角关系:{主角本人写「本人」}(功能角色也填)
- 外貌特征:{原文写到的 3-5 个记忆点}
- 性格关键词:{3-5 个,从行为归纳,写出矛盾面}
- 核心目标:{全书或当前阶段想达成什么}
- 核心动机:{为什么非要达成}
- 致命弱点:{会让他犯错的性格缺陷}
- 口头禅/标志动作:{原文反复出现的说法或动作引原句;没有写「无固定口头禅」}(功能角色也填)
- 当前能力与资源:{截至第 N 章}
- 退场方式:{已退场写在第几章、怎么退的;未退场写 [待补充]}

## 经历与成长
{拆文档案的核心经历与成长弧线,按时序}

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

## 别名
{别名、类型和依据;没有写「无」}
```

---

## 关系文件转换规则

拆文的 `角色关系.md` 是有向表:`关系ID | 主体 → 客体 | 关系动作/类型 | 表面关系 | 真实关系 | 触发事件 | 双方得失 | 变化后状态 | 证据等级 | 证据`,同一对角色的历史演变按行保留。转成项目格式:

- 同一对角色合成一行;两个方向的动作不同时,写进「当前状态」(如「A 护着 B;B 在利用 A」)。
- 关系类型:家人→亲情、恋人→爱情、朋友→友情、敌人→敌对、师徒→师生、上下级→主从、商业→利益;同事按实际互动归友情或利益。
- 情感倾向:拆文没有这一列,从关系动作和双方得失判断(保护、依赖多为正面;控制、欺骗、竞争多为负面);两种都有写「复杂」。
- 当前状态取这对角色最后一行的「变化后状态」;起始章节取最早一条证据的章;变化节点按时序列各行的「触发事件」。
- 「真实关系」和「表面关系」不同的,另写进「表面与真实」小节,注明截至第 N 章读者知不知道。续写不能提前说破,必须保留。
- 证据等级是 C 的关系,在当前状态后标「(只有旁人说法)」。

### 目标格式模板(设定/关系.md)

```markdown
# 角色关系图

## 关系总览

| 角色 A | 角色 B | 关系类型{亲情/爱情/友情/敌对/师生/主从/利益} | 情感倾向{正面/负面/中性/复杂} | 当前状态 | 起始章节 | 变化节点 |
|--------|--------|---------------------------------------------|-----------------------------|---------|---------|---------|
| {名} | {名} | {类型} | {倾向} | {描述} | 第{N}章 | {事件} |

## 表面与真实

| 角色 A | 角色 B | 表面关系 | 真实关系 | 读者截至第 N 章知道吗 |
|--------|--------|---------|---------|---------------------|
| {名} | {名} | {旁人看到的} | {实际是} | {知道/部分知道/不知道} |

## 关系演变

{角色A}<->{角色B}:
- 起点:{初始关系}
- 转折:{章节·事件·变化}
- 当前:{现状}

## 核心冲突关系

{列出推动剧情的2-3对核心对立/合作关系}
```

没有表面与真实不同的关系时,「表面与真实」小节写「无」。

---

## 大纲反推规则

### 大纲.md(卷级结构)与卷划分规则

从 `剧情/故事线.md`、`剧情/*.md` 和 `快速预览.md` 反推:

- **情形 A(原文有明确卷界)**:按原文卷级标记(如「第一卷 XXXX」「卷一」)直接划分,无需询问用户。
- **情形 B(原文无明确卷界)**:禁止按「每卷默认 20-40 章」机械切分。先根据故事线阶段、主要场景切换(新地图/新阵营)、大型时间跳跃或阶段目标完成检测候选卷边界(见下方「候选边界检测参考」),向用户展示候选方案(如 `候选卷一:第 1-18 章(世界观建立 + 初步成长,场景:城郊学院)`),**等用户确认或调整后**才生成 `大纲/大纲.md` 的卷级结构和 `大纲/卷纲_第X卷.md`(未确认前只记候选方案,不写定卷纲)。

#### 目标格式模板(大纲/大纲.md)

与长篇写作的全书大纲同形,续写时直接接着用;导入只填有证据的项,其余写 `[待补充]`:

```markdown
# 大纲

## 全书概况
- 已写:第 1–{N} 章,约 {Y} 万字;{完本 | 连载中}
- 全书主线:{从故事线反推;证据不足写 [待补充]}

## 分卷表
| 卷 | 卷名 | 字数区间 | 所属阶段 | 功能 | 核心事件 | 起始状态 → 结束状态 | 这卷读者等着看什么、揭开或用上什么 |
|---|---|---|---|---|---|---|---|
| 1 | {卷名} | 约 {X} 万字,{Y} 章 | {开篇/发展/高潮/收尾} | {从剧情分析推断} | {一句话} | {从角色弧线推断} | {有证据才写,否则 [待补充]} |
```

### 候选边界检测参考

| 信号类型 | 示例 | 卷边界可能性 |
|---------|------|------------|
| 章节连续 + 同一故事线 | 同一城市/同一势力视角 | 同一卷 |
| 主要场景切换(新地图/新阵营) | 从城郊进入帝都 | 候选新卷起点 |
| 大型时间跳跃(数月/数年) | 「三年后…」 | 候选新卷起点 |
| 主要阶段目标完成 + 新目标开启 | 击败阶段 boss → 新危机出现 | 候选新卷起点 |
| 故事线汇总中已有阶段划分 | `剧情/故事线.md` 内部分段 | 优先参考 |

### 卷纲反推

#### 目标格式模板(大纲/卷纲_第X卷.md)

卷纲沿用长篇写作的格式:只有每段剧情的卡在标题末尾写单元编号注释 `<!-- L1-01 -->`,全卷有效的段不写注释。写正文时脚本按本章章号落在哪张卡的章节范围里找到这一段,只取全卷段和该段的卡,所以每张卡都要有编号注释和章节范围;编号只写在标题注释里,卷纲正文和细纲提到剧情段写「第几段剧情」或段名。只反推已写内容,缺证据的字段写 `[待补充]`、不杜撰;续写补纲时由长篇写作按它的模板补全。

```markdown
# {卷名} 卷纲

## 核心信息

- 章节范围:第{X}-{Y}章
- 字数目标:{W}万字
- 本卷定位:{铺垫/发展/高潮/转折/收尾}

## 这卷读者等着看什么(反推)

- 读者期待:{从本卷剧情归纳读者在等什么、主角在哪出彩;证据不足写 [待补充]}
- 这卷主打哪条线:{从情节点归纳承担本卷最大高潮的线}
- 本卷顺带的收获:{其余顺带兑现的线;证据不足写 [待补充]}
- 这卷揭开或用上的:[待补充]
- 这卷先不能揭开、不能用上的:[待补充]
- 有没有硬伤:{没问题 / 要补 / 有硬伤;无法判断写 [待补充]}

## 核心矛盾

{一句话:本卷要解决什么问题或达到什么目标}

## 本卷剧情(反推)

单元编号按 L{卷号}-{两位序号} 编(L1-01、L1-02…);各段章节范围首尾相接,合起来覆盖本卷全部已写章。

### 第一段剧情:{一句话} <!-- L1-01 -->

- 章节范围:第{A}-{B}章
- 这段怎么排:{建立期待→尝试→加压/转向→主角出手→兑现→余波,从情节点分布归纳,标对应章范围}
- 这段让读者图什么:{从 `剧情/情绪模块.md` 里本段用到的模块归纳:缺什么→什么事点着→主角做了什么→读者看到的结果;证据不足写 [待补充]}
- 主角这段要什么:{本段主角要保住/拿到/证明什么}
- 核心阻碍:{主要敌意、限制或误判}
- 主角的关键选择和出手:{主角做了什么替代不了的判断和行动}
- 怎么兑现、好处归谁:{兑现怎么发生,收益归谁}
- 这段主打哪条线、顺带收获什么:{线}
- 怎么引出下一段:{怎么推入下一段;本卷最后一张卡写已留下的悬念}

## 情绪弧线

- 走势:{一句话说这卷情绪怎么起落}

| 章节 | 情绪{紧张/轻松/悲伤/热血/温馨/震惊} | 强度{1-10} | 触发事件 |
|------|-----------------------------------------|-----------|---------|
| 第{N}章 | {情绪} | {N} | {事件} |

## 人物弧线

| 角色 | 本卷起点 | 本卷终点 | 关键转变 |
|------|---------|---------|---------|
| {名} | {状态} | {状态} | {事件} |

## 本卷反转(如有)

| 类型{身份/动机/阵营/信息/命运} | 涉及角色 | 怎么误导读者 | 第几章揭开 | 影响哪些线 |
|------|---------|---------|---------|---------|
| {类型} | {名} | {如何误导} | 第{N}章 | {线} |

## 本卷伏笔

| 编号 | 伏笔 | 埋在第几章 | 预计第几章收 | 长短{短期/中期/长期} |
|------|------|---------|---------|---------------------|
```

#### 字段映射

从剧情文件提取每卷的:
- 核心矛盾 → 核心矛盾字段
- `剧情/{标题}.md` 的结构分布与情节点 → 一张剧情段卡(怎么走、目标、阻碍、关键行动、兑现)
- 情节点分布 → 情绪弧线
- 角色出场 → 人物弧线
- 铺垫类情节点 → 伏笔

半成品最后一张卡的章节范围到第 N 章为止;第 N+1 章以后的单元由续写时的补纲来排,导入不预写。

---

## 题材定位生成

从拆文报告中提取核心发现,生成 `设定/题材定位.md`。

### 目标格式模板(设定/题材定位.md)

```markdown
# 题材定位

## 基本信息
- 题材类型:{玄幻/都市/系统/...}
- 目标平台:{Phase 1 向用户采集的目标平台;无则取 `拆文报告.md`「基本信息」的「目标平台」,仍无填 [待补充]。story-review 据此选平台 rubric}
- 核心梗:{一句话卖点}
- 微创新点:{与同类题材的差异}

## 作者已定
- {导入记录「作者交代」里的偏好与红线、残稿决定,一条一行;没有写「无」}

## 这本书靠什么吸引人
- 表层卖点:{读者一眼看到的吸引力}
- 深层爽点:{持续追读的情绪驱动力}
- 长线钩子:{支撑全书的悬念/目标}

## 读者需求 / 情绪引擎
> 本段从 `拆文库/{导入书名}/剧情/情绪模块.md` 提炼,只记录本书已写内容的续写基线,不把本书登记成对标。

| 读者需求 | 情绪缺口 | 满足方式 | 可复现模块 | 来源 |
|---------|---------|---------|------------|------|
| {安全感/优越感/期待感/情感补偿/认知反转/陪伴感} | {缺什么} | {如何被满足} | {EM-001 等} | `[导入分析] 剧情/情绪模块.md` |

## 节奏与触发参考
> 本段从 `拆文库/{导入书名}/剧情/节奏.md` 提炼,只记录已写部分的节奏事实。

| 节奏模块 | 关键信息推进 | 情绪触动点 | 爆发节奏 | 来源 |
|---------|-------------|------------|----------|------|
| {RH/TR 编号} | {信息如何被扩写} | {触发什么感受} | {铺垫→爆发→冷却} | `[导入分析] 剧情/节奏.md` |

## 题材框架
- 关键转折节点:{列出}
```

### 字段映射

- 题材类型、核心梗、微创新点 → 从 `拆文报告.md`「基本信息」「核心发现」提取
- 这本书靠什么吸引人 → 表层卖点、深层爽点、长线钩子依次取 `拆文报告.md`「核心发现」「读者在追什么」「伏笔与冲突」
- 读者需求 / 情绪引擎 → 从 `剧情/情绪模块.md` 提取;当前契约产物缺失时补 Stage 3+,旧成果按兼容规则处理
- 节奏与触发参考 → 从 `剧情/节奏.md` 提取;当前契约产物缺失时停止迁移并补齐,不用其他概要冒充;旧成果可标「未知/待增强」继续导入
- 题材框架 → 从本书导入分析生成;外部对标的登记和概要由 benchmark-sync.md 追加,两类来源不混写

---

## 质量检查清单

迁移完成、进入逐批细纲前执行(不念给作者,没通过先修):

- [ ] 正文文件数 = 源文件章节数
- [ ] 主要角色(主角 + 反派 + 核心配角)文件已创建,外貌有原文依据或标了 [待补充],口头禅无原文依据时写「无固定口头禅」而非硬凑
- [ ] 关系.md 非空;拆文里表面关系和真实关系不同的,都进了「表面与真实」
- [ ] 大纲.md 有卷级结构;每卷卷纲各段剧情的章节范围覆盖本卷全部已写章,`outline_view.py --check --strict` 问题数为 0
- [ ] 散落情节已合并到相关卷纲或大纲附录
- [ ] 卷划分已经用户确认(原文无明确卷界时必检),确认结果已写进导入记录
- [ ] `拆文库/{导入书名}/` 未被复制到 `对标/`,本书未登记为自身对标
- [ ] 若绑定外部对标,已按 benchmark-sync.md 的清单核过
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall