zenstory-ai/oh-story-claudecode / skills/story-import
story-import
Unverified逆向导入已有小说。将已写好的小说(半成品或完本)反向解析为标准项目目录结构,兼容 story-long-write / story-short-write 后续写作流程;内部复用 story-long-analyze / story-short-analyze 的拆解管道,按篇幅自动分流。触发方式:/story-import、「导入小说」「反向解析」「导入」「把我的书导进来」。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 10.7 KB |
| references/benchmark-sync.md | markdown | 4.0 KB |
| references/character-state-reverse.md | markdown | 4.2 KB |
| references/deep-analysis.md | markdown | 4.3 KB |
| references/import-report.md | markdown | 4.3 KB |
| references/import-special-cases.md | markdown | 2.5 KB |
| references/import-tracking.md | markdown | 6.7 KB |
| references/length-routing.md | markdown | 1.5 KB |
| references/outline-reverse-rules.md | markdown | 6.0 KB |
| references/outline-reverse.md | markdown | 2.8 KB |
| references/structure-mapping-long.md | markdown | 20.1 KB |
| references/structure-mapping-short.md | markdown | 10.2 KB |
| references/tracking-initialization.md | markdown | 1.6 KB |
| scripts/build_outline_brief.jsexecutable | script | 15.4 KB |
| scripts/check-outline-contract.js | script | 12.4 KB |
| scripts/outline_view.jsexecutable | script | 15.1 KB |
| scripts/tracking_commit.jsexecutable | script | 84.7 KB |
| scripts/wordcount_core.jsexecutable | script | 20.3 KB |
references/import-tracking.md
View on GitHub# 追踪初始化时刻(仅长篇)
Phase 4 完整读取本文件、[tracking-initialization.md](tracking-initialization.md) 的事务骨架与 [character-state-reverse.md](character-state-reverse.md) 的快照规则。截止章、残稿决定与卷划分取自导入记录;证据取自已落盘的拆文库和项目 `大纲/`,不重读原文。
导入项目必须通过本 skill 自带的 `scripts/tracking_commit.js init` 一次性生成追踪状态,禁止模型分别写最终文件。
## 语义准备顺序
1. **导入截止章**:将最后完整章 N 写入 `last_chapter`,工具在 `_tracking-state.json` 写入 `imported_through_chapter=N`。第 1..N 章不伪造日更事务,也不另写一份重复当前状态的叙事基线。
2. **核心角色当前快照**:从拆书产物反推主角、反派、核心配角的截至 N 章状态,按角色写入 `character_snapshots`,工具生成 `追踪/角色状态/{角色名}.md`;算法见 character-state-reverse.md。
3. **伏笔当前行**:从有正文证据的铺垫/回收事件生成 `foreshadow`(识别方法见下)。每个 ID 只保留当前状态一行;尚未实际埋设的未来设计留在大纲,不写 `伏笔.md`。
4. **事实与读者认知**:把关键事件生成到 `timeline_events`(提取方法见下)。同一事件同时写客观事实、读者截至 N 章已知内容和实际揭示状态;未来计划揭示章不得伪装成已发生事实。
5. **续写状态卡输入**:准备当前位置、长期约束、活跃核心角色、近三章速记、下一章承诺和连贯性风险。`上下文.md` 由工具生成固定 7 栏,不把文风、文件索引、普通待办或质检计数塞进续写状态卡。
6. **执行初始化**:事务写到 `{书目录}/.story/work/init.json`(成功前保留,不写系统 `/tmp`、书根、`大纲/` 或 `正文/`;已有旧追踪文件时 `init` 会自动将其原样移入 `追踪/_旧追踪存档/`,只在 `_tracking-state.json` 不存在时执行),用 Node.js 18+ 执行:
```text
node {story-import skill 根}/scripts/tracking_commit.js init --project {书目录} --input {书目录}/.story/work/init.json
node {story-import skill 根}/scripts/tracking_commit.js check --project {书目录}
```
半成品最后一章为残稿时,`last_chapter`、角色快照和其他当前语义检查点一律截至最后完整章;残稿处理策略(导入记录里作者的决定)写入 `continuity_risks`,不把未完成动作登记成既成事实。
## 条目形状与容量
在 tracking-initialization.md 的事务骨架上填条目,`last_chapter` 写 N;下面只展示伏笔、时间线与近章速记,不能替代完整初始化事务:
```json
{
"foreshadow": [
{"id": "F027", "summary": "专业团队仍拍不出江晨原版的灵魂", "planted_chapter": 10,
"planned_resolution_chapter": null, "status": "已埋", "importance": "中"}
],
"timeline_events": [
{"id": "E010", "story_time": "实弹训练两天后",
"objective_fact": "文工团高层否决专业重拍版,决定沿用江晨手机拍摄的原版视频",
"reader_knowledge": "读者已看到周薄森指出专业版缺了灵魂,张耀祖当场拍板用回原版",
"reveal_status": "已揭示", "reveal_chapter": 10, "characters": ["江晨", "周薄森", "张耀祖"]}
],
"context": {
"recent_chapters": [{"chapter": 10, "summary": "专业重拍版被判缺了灵魂,高层拍板用回手机原版"}]
}
}
```
- 伏笔 `id` 形如 `F001`,`status` 取 已埋/已回收/已过期/放弃,`importance` 取 高/中/低;`planted_chapter` 不晚于 N。事件 `id` 形如 `E001`,`reveal_status` 取 未揭示/部分揭示/已揭示:`未揭示` 的 `reveal_chapter` 必须为 `null`,部分/完全揭示只能填已经发生的实际章节。
- `context` 在 init 时收六项:`position`、`long_term_constraints`、`active_character_names`、`continuity_risks`、`recent_chapters`(最多 3 章,按章号升序)、`next_chapter_commitments`。
- `character_snapshots` 里的角色就是核心角色;四个列表不限条数(单项 ≤600 字节),单角色文件目标 ≤16384 字节(仅提醒),硬上限 65536 字节,超过在任何写入前拒绝。`active_character_names` 是导入截止章之后下一章的活跃角色,不是核心角色总数:最多 20 人且必须已有快照;`long_term_constraints` 最多 6 条。
- `上下文.md` ≤12288 字节,只含 7 个顶层区块:当前位置、长期约束、核心角色状态、活跃伏笔(最多 8 条)、近三章速记、下一章承诺、连贯性风险。
- 报错按提示改事务本身再跑,字段形状以 tracking-initialization.md 的骨架和本节为准。
## 伏笔提取
| 情节点类型 | 伏笔可能性 | 提取方式 |
|-----------|-----------|---------|
| 铺垫 | 高 | 直接提取为伏笔 |
| 信息揭示(部分) | 中 | 检查后续是否有呼应 |
| 物品首次出现 | 中 | 检查后续是否有使用 |
| 角色秘密 | 高 | 标记为角色伏笔 |
| 未解决的悬念 | 高 | 从章尾标记提取 |
状态推断:后续情节点实际回应了同一伏笔 → 已回收;尚未回应 → 已埋。不能只凭节点叫“揭示”或“解决”就判回收;半成品末尾尚未回应的铺垫可注明“接近断点”。
## 时间线提取
从情节点和时间标记提取:明确日期直接记录;相对时间有可靠参照点时推算,季节只能确定到季节。按章节、章内情节点序号整理;缺少参照时写“时间未明”,有依据的推断标 `[推断]`。
## 验收
初始化成功后应得到:
```text
追踪/
├── _tracking-state.json
├── 上下文.md
├── 逐章记录/ # 导入旧章不补造文件,续写从第 N+1 章开始
├── 角色状态/{角色名}.md
├── 伏笔.md
├── 时间线/
│ ├── 作者真相.md
│ └── 读者已知.md
```
- [ ] `tracking_commit.js check` 通过,`_tracking-state.json` 与全部自动生成的追踪文件一致
- [ ] `_tracking-state.json.imported_through_chapter` 等于最后完整导入章
- [ ] `追踪/伏笔.md` 每个 ID 至多一行,未来尚未埋设的设计没有混入
- [ ] `_tracking-state.json.timeline` 已登记关键事实与读者认知,`读者已知.md` 无真相泄露
- [ ] `追踪/角色状态/{角色名}.md` 已覆盖全部核心角色并对齐 character-state-reverse.md
- [ ] `追踪/逐章记录/` 空目录已创建,且没有为导入章伪造日更记录
- [ ] `追踪/上下文.md` 顶层恰好固定 7 栏且 ≤12288 字节
通过后在导入记录勾「追踪初始化」,`init.json` 可删除;汇报末尾按 [SKILL.md 的换上下文规则](../SKILL.md#时刻表与交接) 建议新开对话。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |