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 同步目录树与定位段。
3.9 KiB
3.9 KiB
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/。
试用方式
- 按问题找:写作者卡在某类问题时,查
../.claude/skills/_index.md的领域表,读对应.claude/skills/<slug>/SKILL.md。 - 按环节用:主会话给 writer/planner 派发任务时,按
_index.md的"创作环节映射"把相关综合 skill 的正文附进上下文。 - 对照原文:每个 skill 的来源追溯集中在
references/_coverage.md(落点到文件级);凭它回books/<书>/<unit>/SKILL.md核对出处。内容文件本身不带追溯标记。 - 改动综合 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/是蒸馏产物不是原书全文;原书全文不进入本仓。