5ea153e6a1
craft/ 在 v2 全量合并、追溯分离、搬入 .claude/skills/ 后已完成历史 使命，不再需要保留本地副本： - books/ 原料层（94 单元）—— 原始副本仍在 ~/Downloads/skills-unpack/books/，需要时重生 - scripts/check_craft_skills.py 门禁脚本 —— git 历史保留 - MERGE_PLAN.md / README.md / _index.md 三份 SoT 文档 —— git 历史保留 蒸馏全过程（输入、阶段、决策、裁剪、落点、提交历史、未来追溯）合并 入 docs/2026-08-19-craft-distillation-trace.md 单一留痕文档。原 docs/2026-08-19-craft-skill举例审计清单.md（v1 失真证据）一并吸收并删除。 综合 skill 现行落点未变：.claude/skills/_index.md 下 15 个【方法论 参照】技能。
126 lines
5.8 KiB
Markdown
126 lines
5.8 KiB
Markdown
# 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 提示词层"两种可能，待定 |