muse-agent-example/docs/2026-08-19-craft-distillation-trace.md

# craft 蒸馏操作留痕（2026-08-19）

> 本文件是 2026-08-19 在 agent-example 上完成的小说写作方法论蒸馏操作
> 的完整留痕。原始 SoT 文档与原料层（`craft/`）已删除，需追溯细节可
> 从 git 历史恢复（见"未来追溯"）。

## 起因

把 7 本小说写作书蒸馏成方法论库，落地 agent-example 试用区，验收后
升级到 muse。

## 输入

7 本书共 94 个方法论单元（cangjie-skill 管线蒸馏）：

| 书 | 作者 | 单元数 | 侧重 |
|----|------|--------|------|
| 《Story Engineering》 | Larry Brooks | 21 | 工程化长篇结构 |
| 《成为作家》 | Dorothea Brande | 16 | 作家养成与小说入门 |
| 《Writing Tools》 | Roy Peter Clark | 15 | 微观技巧工具箱 |
| 《小说面面观》 | E.M. Forster | 12 | 评估与诊断框架 |
| 《我能否相信自己》 | 余华 | 10 | 中文母语叙述技法 |
| 《小说课》 | 毕飞宇 | 15 | 中文母语小说方法论 |
| 《风格感觉》 | Steven Pinker | 5 | 语言风格 |

原始副本路径：`~/Downloads/skills-unpack/books/`（不在本仓；本次 rsync
副本到 `craft/books/` 作为原料层，与 `craft/` 一并删除；未来可从该原
始副本重新生成）。

## 蒸馏过程

| 阶段 | 关键事件 | 产物 |
|------|----------|------|
| v1 压缩蒸馏 | 限制 ≤220 行 / 案例 ≤3 个 / 引文 ≤2 行 | 15 个综合 skill，2074 行 |
| 审计 | 193 处举例 vs 源单元对照 | 142 忠于原文 / 45 简化 / 4 无出处 |
| v2 全量合并 | 取消压缩限制 | 15 个综合 skill 包，15304 行；references/ + scripts/ + _coverage.md 三件套 |
| 追溯分离 | SKILL.md 与 references 内容文件去来源标记 | 唯一追溯文件 = references/_coverage.md |
| 搬迁 | craft/skills/ → .claude/skills/，新建 _index.md | 与 33 个运行时技能并列 |
| 统一格式 | _coverage.md 收为"源单元 → references/ 文件"两列表 | 15 文件，409 行 → 234 行 |

## 关键决策

- **整合规范 v2**：只重复合并、不压缩抛弃；举例保留具体对话/数字/动作/
  原句；原文摘录全量引用、不限长度。`MERGE_PLAN.md §3` 头注引用审计文档，
  显式废弃 v1 压缩蒸馏。
- **追溯分离**：SKILL.md 与 references 内容文件无《书名》unit-slug 形式
  追溯标记，所有来源只在 `_coverage.md`（落点到 references/ 文件级即可，
  不做逐方法点定位）。
- **筛选线**：只收写作技巧、必须适配中文小说、不收作者培养；非虚构专用
  技法不入。
- **流水线测试产物不入册**：gold-coins 的 test-prompts.json（用户拍板），
  同类 test-results.md 等也不再合并。
- **v1 失真作为反例保留**：审计结果作为后续不再走压缩蒸馏路的证据。

## 裁剪清单（19 个）

**作者培养（16 个）**：becoming-a-writer 的 morning-pages / scheduled-writing
/ imagination-over-willpower / writer-quiet-mind / writer-dual-self /
wordless-leisure / pre-writing-blocks / set-aside-the-manuscript / childs-eye
/ two-pass-reading / imitate-technique-not-style；wo-neng-fou-xiang-xin-zi-ji
的 obstacle-crossing / literary-influence-transformation；bifeiyu 的
bifeiyu-reading-as-writing；story-engineering 的 voice-clean-professional
/ voice-growth-not-taught。

**非虚构专用（3 个）**：sense-of-style 的 arcs-of-coherence /
metadiscourse-killer / single-variable-rule。

**流水线测试产物（1 个）**：writing-tools-clark/gold-coins 的
test-prompts.json。

合计 75 入册 + 19 裁剪 = 94。

## 综合 skill 落点（craft/ 删除后）

15 个综合 skill 现在落在 `.claude/skills/<slug>/` 下：

| 领域 | Skill |
|------|-------|
| 概念与前提 | concept-design |
| 结构与里程碑 | story-structure |
| 动力与钩子 | narrative-momentum |
| 结尾 | story-ending |
| 伏笔与回收 | foreshadow-payoff |
| 人物设计 | character-design |
| 人物呈现 | character-presentation |
| 场景执行 | scene-craft |
| 展示与留白 | show-and-omission |
| 对话 | dialogue-craft |
| 叙述与视角 | narration-pov |
| 主题与立场 | theme-and-stance |
| 语言与修辞 | prose-craft |
| 规划工作流 | story-planning |
| 作品诊断 | novel-diagnosis |

每个 skill 一个包：SKILL.md 入口 + references/ 全量内容（按主题拆分）
+ scripts/ 可执行清单 + references/_coverage.md 覆盖对照表（唯一追溯
文件）。总目录：`.claude/skills/_index.md`（33 个【运行时】技能 + 15
个【方法论参照】技能）。

## 已删除

- `craft/` 整目录（含 books/ 原料层 94 单元、`scripts/check_craft_skills.py`
  门禁脚本、`MERGE_PLAN.md` / `README.md` / `_index.md` 三份 SoT 文档）
- `docs/2026-08-19-craft-skill举例审计清单.md`（审计原始文件，关键发
  现已吸收进本留痕文档）

## 提交历史（feat/creative-data-closure-dashboard 分支）

| commit | 内容 |
|--------|------|
| `9e6f5fb` | chore(craft): 统一 15 个 _coverage.md 到文件级两列格式 |
| `79adaa0` | docs(craft): 登记举例审计清单（v1 蒸馏失真证据） |
| `cee5d0c` | chore(craft): 蒸馏 v2 全量合并 + 追溯分离 + 综合 skill 搬入 .claude/skills/ |

## 未来追溯

- **重抽回 craft/books/**：原副本在 `~/Downloads/skills-unpack/books/`
  （用户私人目录，不入仓）
- **恢复 SoT 文档**：从 git 恢复 `craft/MERGE_PLAN.md`、`craft/README.md`、
  `craft/_index.md`（任一 commit cee5d0c / 9e6f5fb 都有）
- **恢复门禁脚本**：从 git 恢复 `craft/scripts/check_craft_skills.py`；
  脚本路径写死到 `.claude/skills/`，重新启用时无需改路径
- **重做综合**：基于 `.claude/skills/_index.md` 的"按创作环节取用"映射
  表出发，从 references/ 全量内容出发重排
- **升级到 muse 的路径**：试用出结论再拍；craft README 原文说"知识卡
  vs 提示词层"两种可能，待定

## 蒸馏来源单元对照（自 SKILL.md frontmatter 迁入，2026-08-20）

原 frontmatter 的 `domain` / `sources` 两个字段无任何代码消费，且 `domain` 已由
`harness/manifests/skills.json` 的 `lifecycle` 承载。来源出处属历史留痕，不该常驻
运行时提示词，于此保存后从 frontmatter 移除。

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