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/ → .agent/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 现在落在 .agent/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 覆盖对照表（唯一追溯 文件）。总目录：.agent/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 搬入 .agent/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； 脚本路径写死到 .agent/skills/，重新启用时无需改路径
• 重做综合：基于 .agent/skills/_index.md 的"按创作环节取用"映射 表出发，从 references/ 全量内容出发重排
• 升级到 muse 的路径：试用出结论再拍；craft README 原文说"知识卡 vs 提示词层"两种可能，待定

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

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

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