zizi cee5d0c58d chore(craft): 蒸馏 v2 全量合并 + 追溯分离 + 综合 skill 搬入 .claude/skills/
7 本写作书(Story Engineering、成为作家、Writing Tools、小说面面观、
我能否相信自己、小说课、风格感觉)按 15 个创作领域全量合并成综合 skill,
丢弃 v1 压缩蒸馏的思路(案例限 3 个、引文限 2 行、文件 ≤220 行)——被审计
证实丢了原文 75% 体积。

落点:.claude/skills/<slug>/  下,每包含 SKILL.md 入口 + references/ 全量
内容(按主题拆分)+ scripts/ 可执行清单 + _coverage.md 覆盖对照表(唯一
追溯文件)。craft/ 目录只剩 books/ 原料层与 MERGE_PLAN.md / README.md /
scripts/check_craft_skills.py 等 SoT。

规范要点:
- 整合规范 v2:只重复合并、不压缩抛弃;举例保留具体对话/数字/动作/原句
- 追溯分离:SKILL.md 与 references/ 内容文件无《书名》unit-slug 标记,
  所有来源只在 _coverage.md(落点到文件级即可)
- 门禁:覆盖闭合 + frontmatter + 包结构 + 标记扫描,craft 15 个全过

craft/skills/ 的 15 个 skill 整体搬到 .claude/skills/,新建 _index.md 统管
运行时技能(33)与方法论参照(15),后者标签【方法论参照】,明示不落库、
不进 meta/chains。AGENTS.md 同步目录树与定位段。
2026-08-19 19:01:45 +08:00

3.9 KiB
Raw Blame History

craft/ —— 小说写作方法论能力域(试用区)

定位:从 7 本写作书蒸馏出的方法论库,在 agent-example 试用,验收后升级进 muse。 本域是方法论参照库,不是项目运行时 Skill:不落库、无数据库合同、不进 meta/chains/、不登记进 AGENTS.md 的 Skill 领域索引表。运行时能力仍由 .claude/skills/ 承载;craft 供 writer 角色和主会话在创作时按需取用。

结构

craft/
├── README.md          # 本文件:定位与用法
├── MERGE_PLAN.md      # 分类→整合的 SoT:15 个综合 skill 的分配表、合并理由、整合规范、裁剪清单
├── _index.md          # 15 个综合 skill 总目录(领域 × 触发场景 × 创作环节映射)
├── (skills/ 已搬到 ../.claude/skills/)
├── books/             # 原料参照层:7 本书 94 个源单元原样保留,仅供追溯,不直接调用
└── scripts/
    └── check_craft_skills.py  # 机械检查:覆盖率、frontmatter、重复引用、过程垃圾

来源

7 本书共 94 个方法论单元(cangjie-skill 管线蒸馏,2026-08-18/19),已做中文适用性筛选:

书 目录 单元数 侧重
Larry Brooks《Story Engineering》 story-engineering 21 工程化长篇结构
多萝西娅·布兰德《成为作家》 becoming-a-writer 16 作家养成与小说入门
Roy Peter Clark《Writing Tools》 writing-tools-clark 15 微观技巧工具箱
E.M.福斯特《小说面面观》 aspects-of-the-novel 12 评估与诊断框架
余华《我能否相信自己》 wo-neng-fou-xiang-xin-zi-ji 10 中文母语叙述技法
Steven Pinker《风格感觉》 sense-of-style 5(筛后) 语言风格(3 个非虚构专用已裁剪)
毕飞宇《小说课》 bifeiyu-novel-skill 15 中文母语小说方法论

整合过程:按小说创作领域(不按书、不按作者)蒸馏合并,筛选线为"只收写作技巧、必须适配中文小说、不收作者培养"——94 个单元中 75 个入册为 15 个综合 skill,裁剪 19 个(作者培养 16 + 非虚构专用 3)。分配表、合并理由和裁剪清单见 MERGE_PLAN.md。整合执行全量合并规范(MERGE_PLAN §3):规则、示例、原文摘录全量保存,SKILL.md 是入口索引,细节与引文在 references/。

试用方式

  1. 按问题找:写作者卡在某类问题时,查 ../.claude/skills/_index.md 的领域表,读对应 .claude/skills/<slug>/SKILL.md。
  2. 按环节用:主会话给 writer/planner 派发任务时,按 _index.md 的"创作环节映射"把相关综合 skill 的正文附进上下文。
  3. 对照原文:每个 skill 的来源追溯集中在 references/_coverage.md(落点到文件级);凭它回 books/<书>/<unit>/SKILL.md 核对出处。内容文件本身不带追溯标记。
  4. 改动综合 skill 后跑 .venv/bin/python craft/scripts/check_craft_skills.py 过门禁。

升级到 muse 的路径

试用验收后,15 个综合 skill 的去处(待定,试用出结论再拍):

  • 进 muse 知识体系:作为公共范式/知识卡入库(走 muse 的知识绑定与授权机制),由 writer 上下文按需召回——对应 muse 的"知识确认:默认自动"决策。
  • 进 muse 提示词层:高频方法(场景执行、对话、伏笔)直接蒸馏进 writer 角色提示词或功能 skill 的方法段。
  • 验收标准在试用中沉淀:方法点是否真被创作消费、是否产生可观察的正文质量差异。

合规边界

  • 原文摘录与书籍引文按需进入 .claude/skills/*/references/ 与 books/,仅限仓内私用;不得随 craft 内容对外发布、不得进入任何公开服务或市场。
  • books/ 是蒸馏产物不是原书全文;原书全文不进入本仓。