muse-agent-example/craft/MERGE_PLAN.md

craft 合并计划 —— 分类 → 整合 的 SoT

输入：7 本书蒸馏出的 94 个方法论单元（80 个 SKILL.md，其中毕飞宇包为 1 总包 + 15 子单元；总包不计为独立单元）。 筛选线（用户已确认）：只收写作技巧——直接作用于小说文本的方法；作者本人的培养一律不要；必须适配中文小说。 输出：按小说创作领域合并的 15 个综合 skill，每个是一个包（.claude/skills/<slug>/：SKILL.md 入口 + references/ 全量内容 + scripts/ 脚本），共收 75 个单元。 裁剪 19 个：作者培养 16 个 + 非虚构专用 3 个（见 §4）。 原始单元保留在 craft/books/ 作原料参照；综合 skill 是唯一的可调用层。

1. 领域分类（15 个领域 → 15 个综合 skill）

#	领域	综合 skill	合并的源单元
1	概念与前提	concept-design 概念设计	story-engineering: concept-what-if, concept-four-questions, concept-delivery-strategy；becoming-a-writer: originality-is-honesty；writing-tools-clark: story-engine
2	结构与里程碑	story-structure 故事结构	story-engineering: structure-four-boxes, structure-six-milestones, structure-setup-five-missions, structure-inciting-vs-plot-point, structure-first-plot-point, structure-part2-wanderer, structure-midpoint；bifeiyu: bifeiyu-system；writing-tools-clark: inciting-incident；becoming-a-writer: fiction-opening
3	动力与钩子	narrative-momentum 叙事动力	writing-tools-clark: gold-coins, internal-cliffhanger；bifeiyu: bifeiyu-momentum
4	结尾	story-ending 结尾设计	writing-tools-clark: write-toward-ending；aspects-of-the-novel: expansion-vs-completion
5	伏笔与回收	foreshadow-payoff 伏笔与回收	writing-tools-clark: chekhov-gun；bifeiyu: bifeiyu-foreshadowing；wo-neng-fou-xiang-xin-zi-ji: detail-driven-climax
6	人物设计	character-design 人物设计	story-engineering: character-seven-variables, character-three-dimensions, character-inner-demon；aspects-of-the-novel: flat-vs-round-character；writing-tools-clark: archetype-toolkit
7	人物呈现	character-presentation 人物呈现	writing-tools-clark: mosaic-of-detail；aspects-of-the-novel: visible-private-life；bifeiyu: bifeiyu-relationship, bifeiyu-character-fate, bifeiyu-anti-norm；wo-neng-fou-xiang-xin-zi-ji: character-voice-discovery
8	场景执行	scene-craft 场景执行	story-engineering: scene-mission-driven, scene-enter-late-exit-early；becoming-a-writer: fiction-scene-craft；writing-tools-clark: cinematic-distances；aspects-of-the-novel: mystification
9	展示与留白	show-and-omission 展示与留白	sense-of-style: show-dont-tell, curse-of-knowledge；wo-neng-fou-xiang-xin-zi-ji: no-psychological-description, imagination-to-fact；bifeiyu: bifeiyu-anti-logic, bifeiyu-iceberg
10	对话	dialogue-craft 对话写作	becoming-a-writer: fiction-dialogue；writing-tools-clark: dialogue-as-action
11	叙述与视角	narration-pov 叙述与视角	bifeiyu: bifeiyu-perspective；wo-neng-fou-xiang-xin-zi-ji: outsider-perspective, certainty-uncertainty-tension, skeptical-narration；writing-tools-clark: mix-narrative-modes
12	主题与立场	theme-and-stance 主题与立场	story-engineering: theme-demonstrate-not-tell；bifeiyu: bifeiyu-shakespeare, bifeiyu-mercy-ruth；wo-neng-fou-xiang-xin-zi-ji: humor-as-structure
13	语言与修辞	prose-craft 语言修辞	writing-tools-clark: sentence-rhythm, ladder-of-abstraction, back-off-show-off, voice-equalizer；bifeiyu: bifeiyu-paiban, bifeiyu-lyric-pass, bifeiyu-base-temp
14	规划工作流	story-planning 规划工作流	story-engineering: workflow-beat-sheet, workflow-pantsing-is-planning；becoming-a-writer: story-draft-flow
15	作品诊断	novel-diagnosis 作品诊断	story-engineering: six-core-competencies；aspects-of-the-novel: seven-aspects, story-vs-plot, time-vs-value-life, plot-character-tug, pattern-vs-rhythm, fantasy-prophecy-twin, round-table, quack-scholar-check

单元数核对：5+10+3+2+3+5+6+5+6+2+5+4+7+3+9 = 75，加 §4 裁剪的 19 个 = 94。✓

2. 关键合并理由（重叠证据）

• 展示不说教是同一个原则的多个分身：show-dont-tell（原则本体与落地）、no-psychological-description（情绪层：不写心理写动作）、imagination-to-fact（想象锚定细节）、bifeiyu-iceberg（留白层）、bifeiyu-anti-logic（飞白：从没写处看）合成 show-and-omission；主题层的 theme-demonstrate-not-tell 归 theme-and-stance；人物细节层的 mosaic-of-detail 归 character-presentation；修辞克制 back-off-show-off 归 prose-craft。
• 伏笔三家各说各话但是同一件事：chekhov-gun 管"登记与兑现"，bifeiyu-foreshadowing 管"铺垫的自然度（修楼梯）"，detail-driven-climax 管"高潮从细节生长"。合成一条完整链路：埋设 → 自然过渡 → 兑现/高潮。
• 开头被写了 4 遍：fiction-opening、inciting-incident、structure-setup-five-missions、structure-inciting-vs-plot-point。全部并入 story-structure 的开篇段，保留各自差异点（Brande 讲"别等完美第一句"，Clark 讲"开篇引擎+持续升级"，Brooks 讲"Setup 五使命 + 煽动事件≠第一情节点"）。
• 风格是文本技巧的留下，作者成长的砍掉：voice-equalizer（风格工程化诊断与调节）和 bifeiyu-base-temp（风格体温 = 文本的稳定气质）作用于文本，进 prose-craft；voice-clean-professional、voice-growth-not-taught 讲作者声音的成长路径，属作者培养，裁剪。
• 诊断框架合成一套体检：six-core-competencies 与 seven-aspects 都是"整体维度框架"，forster 其余 6 个是具体透镜，round-table/quack-scholar-check 是评审纪律 → 一个 novel-diagnosis，内部三段。
• fantasy-prophecy-twin 的适配要求：福斯特以英国小说的神异传统立论，蒸馏时须把"幻想/预言"两副面孔转述到中文语境（志怪、神魔、仙侠传统的门槛与姿态），说清适用边界。

3. 整合规范 v2（全量合并：只重复合并，不压缩抛弃）

v1（压缩蒸馏：≤220 行、案例 ≤3 个、引文 ≤2 行）已废弃——举例、规则细节与原文摘录被大量压缩抛弃，审计见 docs/2026-08-19-craft-skill举例审计清单.md。自本次重抽取起执行 v2。

目录结构（每个综合 skill 一个包，不把一切压进 SKILL.md）：

.claude/skills/<slug>/
├── SKILL.md           # 入口：定位、触发、方法索引（每方法点一句话 + 指针）
├── references/        # 全量内容，按主题分文件
│   ├── <topic>.md
│   └── _coverage.md   # 覆盖对照表（源单元 → 方法点 → 落点）
└── scripts/           # 可选：可执行的检查清单 / 诊断流程 / 台账模板

规则

1. 全量保存：75 个入册源单元的方法规则、判断标准、示例、原文摘录、描述，必须全部有落点（SKILL.md 索引、references/ 或 scripts/）。允许重复合并，不允许压缩抛弃。
2. SKILL.md 只做入口：frontmatter + 一句话定位 + ## 方法索引（按创作动作组织，不按书组织；每个方法点一句话 + → references/<topic>.md 指针）+ ## 引用索引（表：文件 | 覆盖内容）+ 可选 ## 脚本。方法细节与案例不进 SKILL.md。
3. references/.md 承载全量内容：方法细节、操作步骤、判断标准、案例全文、原文摘录、常见误区。任何文件不设行数上限。
4. 举例必须接近原文：保留具体对话、数字、动作、原句，禁止压缩成概括。
5. 原文摘录全量引用（源单元 R 段引文），不限处数、不限长度。
6. 追溯分离：SKILL.md、references 内容文件、scripts/ 一律不带追溯标记（《书名》unit-slug 之类）；来源只记录在 references/_coverage.md：每个源单元一行，落点到文件级（references/.md），知道每个单元的内容在哪些文件即可，不做逐句定位。正文里的自然归属（句中出现作者名、书名）是内容本身，保留。
7. 合并规则：同一方法点多书出现 → 合并一条，保留各书视角与引文；同一作品案例 → 去重留最全，角度不同则都留；规则冲突 → 都保留，标注冲突与各自出处。
8. 中文适配内容（翻译腔信号、志怪神魔传统等）保留并标注"中文适配"；英文书案例照原文保留，方法点须说明中文落地。
9. scripts/ 仅在源单元含检查清单/诊断流程/模板类可执行内容时建，不硬造。
10. frontmatter：name（=目录名）、description（激活场景 + 关键 trigger + 不适用于，中文）、domain、sources（同 §1 分配表，不变；frontmatter 是机器元数据，不算正文追溯标记）。
11. 白话中文，禁抽象标签堆砌、禁排比凑数。

4. 裁剪清单（不进综合 skill，文件留 books/ 作原料）

作者培养类（16 个，用户筛选线：不针对作者本人）

单元	内容
becoming-a-writer: morning-pages, scheduled-writing, imagination-over-willpower, writer-quiet-mind, writer-dual-self, wordless-leisure	写作习惯与心理状态
becoming-a-writer: pre-writing-blocks, set-aside-the-manuscript, childs-eye	写作困难诊断、写后心态、素材积累
wo-neng-fou-xiang-xin-zi-ji: obstacle-crossing	写作障碍应对
becoming-a-writer: two-pass-reading, imitate-technique-not-style	读书方法与模仿学习
bifeiyu: bifeiyu-reading-as-writing；wo-neng-fou-xiang-xin-zi-ji: literary-influence-transformation	阅读即写作、文学影响转化
story-engineering: voice-clean-professional, voice-growth-not-taught	作者声音的入门与成长路径

非虚构专用（3 个）

单元	裁剪原因
sense-of-style: arcs-of-coherence	原书 INDEX 标记非虚构专用（连贯弧依赖说明文段落结构）
sense-of-style: metadiscourse-killer	非虚构专用（清理元话语是学术/公文文体问题）
sense-of-style: single-variable-rule	非虚构为主（对比平行性；小说里对比常是隐喻的，原文自带此免责声明）

流水线测试产物（不入册，2026-08-19 用户拍板）：源单元随附的 test-prompts.json / test-results.md 是拆书管线的验证产物，不是方法论内容，不合并；原料原件仍留 books/（含 gold-coins 的 test-prompts.json），将来需要可随时补。

5. 检查与清理门禁（整合完成后逐条过）

机械门禁：craft/scripts/check_craft_skills.py（覆盖闭合 + frontmatter + 包结构）；方法点覆盖与举例忠实度由独立子代理对照源单元核验。

• 94 个源单元：75 个恰好出现在一个综合 skill 的 sources 里，19 个在裁剪清单，无遗漏无重复
• 15 个综合 skill frontmatter 可解析，name=目录名，description 含 trigger 和"不适用于"
• 包结构完整：SKILL.md 含方法索引与引用索引；references/ 非空；_coverage.md 覆盖该 skill 全部源单元，引用的落点文件均存在
• 追溯分离：SKILL.md、references 内容文件、scripts/ 无追溯标记（机械扫描）；追溯集中在 _coverage.md（落点到文件级）
• 方法点覆盖与举例忠实度过独立子代理核验（无遗漏，举例接近原文）
• craft/books/ 中无过程垃圾（PIPELINE_STATE / candidates / rejected / 原书 raw 文本）
• 综合 skill 之间无职责重叠（每个方法点有唯一归属，跨域引用只写一句话指针）