zjs105910/workbuddy-market / bundled/novel-writing-suite/skills/story-long-analyze
story-long-analyze
Verified长篇网文拆文。保留黄金三章、逐章摘要、剧情、情绪、节奏、角色、设定和文风接口,以连续章节块完成因果、双时间线、关系与三维节奏分析;兼容旧成果直接使用、按需增强和断点续跑。含可选三层灵感库管道(灵感库、跨书灵感聚合、更新灵感库)。触发方式:/story-long-analyze、/长篇拆文、「帮我拆这本书」「拆这本书」「分析黄金三章」「深度拆解」「完整拆解」或提供小说文本文件路径。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 14.0 KB |
| references/author-facing.md | markdown | 12.2 KB |
| references/deconstruction-notes.md | markdown | 10.9 KB |
| references/final-checks.md | markdown | 1.4 KB |
| references/index-rebuild.md | markdown | 2.9 KB |
| references/inspiration-library.md | markdown | 9.7 KB |
| references/pipeline-ops.md | markdown | 10.9 KB |
| references/semantic-acceptance-fixtures.md | markdown | 5.5 KB |
| references/stage1-golden-chapters.md | markdown | 6.4 KB |
| references/stage2-extraction.md | markdown | 13.6 KB |
| references/stage3-plot-rhythm.md | markdown | 29.8 KB |
| references/stage4-characters-settings.md | markdown | 11.2 KB |
| references/stage5-report.md | markdown | 3.1 KB |
| references/style-profile-generator.md | markdown | 4.4 KB |
| references/style-profile-protocol.md | markdown | 6.6 KB |
| references/synthesis-inputs.md | markdown | 4.1 KB |
| scripts/build_chapter_index.py | script | 20.4 KB |
| scripts/inspect_existing_assets.py | script | 31.3 KB |
| scripts/inspiration_index.py | script | 38.4 KB |
| scripts/manage_analysis_run.py | script | 56.4 KB |
| scripts/render_relation_chart.py | script | 19.0 KB |
references/inspiration-library.md
View on GitHub# 三层灵感库管道
story-long-analyze 的可选后置管道:把 Stage 3 已抽象好的 EM 机制卡组织成可跨书检索的机制资产。不重新拆文,不写新故事;**单书拆文不自动入库**——只在用户提出「灵感库 / 提炼灵感 / 跨书灵感聚合 / 更新灵感库」时运行。
## 复用优先(第一原则)
机制与案例分析在拆文主管道已完成一次:`剧情/情绪模块.md` 的 EM 卡是机制全文的**唯一维护点**,剧情单元是案例的唯一维护点。本管道只做登记(IA)、单书归并(NM)、跨书聚合与打标(CBA),任何一层都**不复制** EM 卡正文;卡内引用一律用 `书名/EM-xxx` 式裸 ID,需要读原文时按 ID 经 `灵感索引.csv` 回查(或用 `resolve` 子命令),禁止在卡里堆路径链接——`validate` 会机械拒绝。
## 输入边界
只读:各书 `剧情/情绪模块.md`(EM 完整卡+其他机制索引)、按 EM 卡「关联节奏/证据来源」定点查证的 `剧情/节奏.md` 与剧情单元、现有 `灵感库/灵感索引.csv` 与 NM/CBA 卡。
**禁止读取 `原文/`、`chapter_index.csv` 与逐章摘要正文。** 一本书没有 `剧情/情绪模块.md` 或完整卡字段不全时,停止并返回 `repair_action`:先用 `--intent enhance` 补跑 Stage 3+(从既有摘要聚合,原文读取可为 0),不得在灵感层代写机制卡。原文追加或局部变化后,主管道 rebuild 并更新 EM 卡,再重跑登记即可(幂等);`validate` 的 `ia_em_set_mismatch` 会指出未重登记的书。
## 公共目录
从当前工作区向上定位最近的现有 `灵感库/`;没有时在工作区根创建:
```text
灵感库/
├── 灵感索引.csv # 三层统一索引,也是 ID → 位置的唯一解析表
├── 单小说灵感合并/{书名}/NM-001.md # 仅在确有合并时创建
└── 跨书灵感聚合/CBA-001_{机制名}.md
```
- 原子灵感 = Inspiration Atom,ID `IA-001`。**只是索引行,没有文件**——对一张 EM 卡的登记,编号镜像 EM 编号。
- 单小说灵感合并 = Single-Novel Merge,ID `NM-001`。
- 跨书灵感聚合 = Cross-Book Aggregation,ID `CBA-001`。
## 管道三步
### 1. 原子灵感登记(确定性机械步骤)
```text
{PYTHON} "{story-long-analyze skill 根}/scripts/inspiration_index.py" register-atoms --root "{灵感库}" --module "{拆文目录}/剧情/情绪模块.md" --book "{书名}"
```
- 完整卡(读者想看什么/情绪链/戏剧单元/可替换项/不可照搬 五字段齐)登记为 `grade=full`;「其他机制索引」条目登记为 `grade=index`。
- 五字段缺失报 `em_fields_missing`,字段在而值空报 `em_field_value_empty`(多行值合法:值可写在字段名行之后、下一个字段/标题之前的列表或段落里)。机制字段(标题/读者想看什么/情绪链/戏剧单元/可替换项)的专名检查分两级:本卡「不可照搬」已点名该词却仍在抽象字段使用、或 `可替换项` 写成「专名→任意X」(报 `replaceable_antipattern`),都是高置信真引用,报 `source_specific_name_in_mechanism` error;仅角色卡文件名子串命中而无佐证的降为 `leak_suspect` warning 并列出命中字段,人工复核。都指回 Stage 3 修复;「不可照搬」字段本身例外——点名原书专名正是它的职责。
- 泄漏门的角色名单取自工作区 `拆文库/{书}/角色/`。工作区从 `--root` 向上探测含 `拆文库/` 的目录,探测不到报 `workspace_not_located`(可加 `--workspace` 显式指定),不得回退空名单静默通过;输出恒带 `character_roster` 数,书目录在而 `角色/` 缺失报 `character_roster_missing` warning,提示人工确认无专名。
- 所有卡的所有问题一次收集报全(`errors` 数组),有任一 error 即整体不写盘。落盘 `剧情/情绪模块.md` 后先用只读的 `check-atoms`(与 register-atoms 同参数)自检:输出卡数、索引数、名单规模与全部问题,不写任何文件。
- 一次原子写入、重跑逐字节幂等;多本书逐本串行登记,不要并行跑 `register-atoms`。`--module` 必须是 `拆文库/{--book}/` 下的文件(`module_book_mismatch`);卡头须为 `### EM-xxx 名称`,缺名称报 `em_title_missing`,认不出的 EM 标题行报 `em_header_unrecognized`,同卡重复字段报 `em_field_duplicate`——三者都意味着卡被截断或并进了上一张。本步不得调用模型重新概括机制。
### 2. 单小说灵感合并
只在一本书内确有 ≥2 张 EM 卡同构时创建 NM;孤立机制不建 NM。卡内容是**合并增量**,机制链不抄写:
```markdown
# NM-001:{簇名}
- 合并对象:EM-001、EM-003
- 合并理由:{为何同构,一两句}
- 差异形态:{各卡触发物/场合/规模的不同}
- 本书特有偏置:
- 共同反例/边界:
```
### 3. 跨书灵感聚合
把各书 IA/NM 与现有 CBA 轻量索引比较,只读可能匹配的 active CBA。已建库后的增量先跑只读的 `coverage`:它列出尚未进入任何 active CBA 闭包的原子与现存单书假设卡——聚合比较只对 uncovered 原子做,顺带复核单书假设卡是否因新证据升级为「跨书重复验证」;uncovered 为空即无事可做,不重读已覆盖的 EM 卡。CBA 是**唯一供写作反复读取的卡**,必须自包含跨书归纳的抽象(聚合新产出,不是 EM 原文复制):
```markdown
# CBA-001:{机制名}
- 验证状态:{单书假设/跨书重复验证}
- 来源:{甲书/EM-001、甲书/NM-002、乙书/EM-003}(溯源按 ID 查 灵感索引.csv 或用 resolve)
## 共同机制链
{触发 → 读者认知/情绪变化 → 持续阅读动力 → 兑现}
## 可变参数
- 人物功能位:/关系动作:/冲突载体:/兑现规模:/节奏位置:
## 可能适用于
- 题材:/读者需求:/情绪:/关系动作(可空):/剧情功能:/节奏位置(可空):/适用阶段:/风险:
## 条件、反例与边界
- 成立条件:/反例:/不可照搬:/误用风险:
```
`novel_count`/`atom_count` 不手写进卡——由索引 `source_ids` 闭包自动核算并校验。只有一部书支持时,最多激活 3 张最有写作复用价值的 CBA 并标 `单书假设`;两部及以上独立来源才标 `跨书重复验证`。标签只表达适用性,一本书来源不能写成市场定论。
## 索引与受控标签
`灵感索引.csv` 表头严格为:
```csv
item_id,layer,title,source_book,path,source_ids,novel_count,atom_count,grade,tags,status
```
- IA 行 `path` 为空、`grade` 取 `full/index`;NM/CBA 行 `grade` 留空;IA/NM 的 `tags` 留空,避免写作绕过聚合层。
- `source_ids` 来源图:IA 行=单个 `EM-xxx`;NM 行=同书 ≥2 个 `EM-xxx`(`|` 分隔);CBA 行=`书名/EM-xxx` 与 `书名/NM-xxx` 混合列表(必须带书名前缀)。引用 NM 时其成员 EM 自动并入闭包,**不需要也不应该再展开列出**;`novel_count`=闭包内不同小说数,`atom_count`=闭包内不同 EM 数。
- 标签序列化为 `轴=值1|值2;轴=值`。CBA 必填轴:题材、读者需求、情绪、剧情功能、适用阶段、风险;可选轴:关系动作、节奏位置。同义值先归一;不用「好看/有趣/高级」等不可执行词。
- **标签值受控于库内 `灵感库/标签词表.md`**(每轴一节 `## 轴`、一行一值 `- 值`):建库首轮聚合把用到的值落盘成首版,此后打标先读词表。扩表走同义判定——候选新值逐一与该轴现有值语义比对,重合或从属就用现有值,确属新维度才追加一行;词表膨胀就是查询失效的前兆。query 命中靠值的精确匹配,写入侧与查询侧共用这一张表。
- `validate` 校验:表头、ID 前缀、EM↔IA 集合一致、NM/CBA 闭包与计数、必填标签轴、单书 active CBA ≤3、验证状态标记、**卡内无路径引用**;词表存在时另拒表外值(`tag_value_not_in_vocabulary`)与缺必填轴的词表(`vocabulary_axis_missing`)——词表缺失时这两项不查(旧库兼容),应尽快补建;同义值靠扩表时的人工比对,不做机械子串判定。列数不对的索引行报 `column_count_mismatch`。
- `query --tag 轴=值 …` 只筛 `layer=跨书灵感聚合` 且 `status=active`,核心轴(题材/读者需求/情绪/剧情功能/适用阶段)2 分、其余 1 分,无核心轴命中不返回,按分数/来源数/ID 稳定排序取 Top 3–8。返回值另带 `unmatched_tags`(请求值在全库该轴零出现)与 `axis_inventory`(所查各轴现存值):零命中先按它们纠词重查一次,仍零命中才算「库里没有」。
- `resolve --ref 书名/EM-xxx --ref CBA-001` 把裸 ID 解析为可读位置——需要时才查,不预先展开进任何卡。
## 写作侧消费约定
写作模块只读标签命中的 active CBA 全卡(Top 3–8),不沿来源下钻 EM/NM;CBA 不作文风样本,也不触发原文读取;同一 CBA 最多派生 2 个候选变化。消费入口只在 story-long-write 的开书、卷纲、细纲三处(适用阶段=设定/卷纲/细纲);逐章写前召回和写手 prompt 不读灵感库,灵感经细纲进入正文。
## 断点与禁止事项
不设进度文件——索引与卡片现状就是状态;中断后重跑登记(幂等),用 `validate` 报错清单定位未完成层。禁止:回读原文、二次逐块语义分析、任何层复制 EM 卡机制全文、卡内路径链接、自动生成故事种子/角色组合/成稿桥段、复制原作专名与原句(跨书层连角色名都不得出现)、为凑数硬并语义不同的机制。
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 |