10 KiB
10 KiB
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（任一 commitcee5d0c/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 |