cee5d0c58d
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 同步目录树与定位段。
103 lines
12 KiB
Markdown
103 lines
12 KiB
Markdown
# craft 合并计划 —— 分类 → 整合 的 SoT
|
||
|
||
> 输入：7 本书蒸馏出的 94 个方法论单元（80 个 SKILL.md，其中毕飞宇包为 1 总包 + 15 子单元；总包不计为独立单元）。
|
||
> 筛选线（用户已确认）：**只收写作技巧**——直接作用于小说文本的方法；**作者本人的培养一律不要**；**必须适配中文小说**。
|
||
> 输出：按小说创作领域合并的 **15 个综合 skill**，每个是一个包（`.claude/skills/<slug>/`：SKILL.md 入口 + references/ 全量内容 + scripts/ 脚本），共收 75 个单元。
|
||
> 裁剪 19 个：作者培养 16 个 + 非虚构专用 3 个（见 §4）。
|
||
> 原始单元保留在 `craft/books/` 作原料参照；综合 skill 是唯一的可调用层。
|
||
|
||
## 1. 领域分类（15 个领域 → 15 个综合 skill）
|
||
|
||
| # | 领域 | 综合 skill | 合并的源单元 |
|
||
|---|------|-----------|-------------|
|
||
| 1 | 概念与前提 | `concept-design` 概念设计 | story-engineering: concept-what-if, concept-four-questions, concept-delivery-strategy；becoming-a-writer: originality-is-honesty；writing-tools-clark: story-engine |
|
||
| 2 | 结构与里程碑 | `story-structure` 故事结构 | story-engineering: structure-four-boxes, structure-six-milestones, structure-setup-five-missions, structure-inciting-vs-plot-point, structure-first-plot-point, structure-part2-wanderer, structure-midpoint；bifeiyu: bifeiyu-system；writing-tools-clark: inciting-incident；becoming-a-writer: fiction-opening |
|
||
| 3 | 动力与钩子 | `narrative-momentum` 叙事动力 | writing-tools-clark: gold-coins, internal-cliffhanger；bifeiyu: bifeiyu-momentum |
|
||
| 4 | 结尾 | `story-ending` 结尾设计 | writing-tools-clark: write-toward-ending；aspects-of-the-novel: expansion-vs-completion |
|
||
| 5 | 伏笔与回收 | `foreshadow-payoff` 伏笔与回收 | writing-tools-clark: chekhov-gun；bifeiyu: bifeiyu-foreshadowing；wo-neng-fou-xiang-xin-zi-ji: detail-driven-climax |
|
||
| 6 | 人物设计 | `character-design` 人物设计 | story-engineering: character-seven-variables, character-three-dimensions, character-inner-demon；aspects-of-the-novel: flat-vs-round-character；writing-tools-clark: archetype-toolkit |
|
||
| 7 | 人物呈现 | `character-presentation` 人物呈现 | writing-tools-clark: mosaic-of-detail；aspects-of-the-novel: visible-private-life；bifeiyu: bifeiyu-relationship, bifeiyu-character-fate, bifeiyu-anti-norm；wo-neng-fou-xiang-xin-zi-ji: character-voice-discovery |
|
||
| 8 | 场景执行 | `scene-craft` 场景执行 | story-engineering: scene-mission-driven, scene-enter-late-exit-early；becoming-a-writer: fiction-scene-craft；writing-tools-clark: cinematic-distances；aspects-of-the-novel: mystification |
|
||
| 9 | 展示与留白 | `show-and-omission` 展示与留白 | sense-of-style: show-dont-tell, curse-of-knowledge；wo-neng-fou-xiang-xin-zi-ji: no-psychological-description, imagination-to-fact；bifeiyu: bifeiyu-anti-logic, bifeiyu-iceberg |
|
||
| 10 | 对话 | `dialogue-craft` 对话写作 | becoming-a-writer: fiction-dialogue；writing-tools-clark: dialogue-as-action |
|
||
| 11 | 叙述与视角 | `narration-pov` 叙述与视角 | bifeiyu: bifeiyu-perspective；wo-neng-fou-xiang-xin-zi-ji: outsider-perspective, certainty-uncertainty-tension, skeptical-narration；writing-tools-clark: mix-narrative-modes |
|
||
| 12 | 主题与立场 | `theme-and-stance` 主题与立场 | story-engineering: theme-demonstrate-not-tell；bifeiyu: bifeiyu-shakespeare, bifeiyu-mercy-ruth；wo-neng-fou-xiang-xin-zi-ji: humor-as-structure |
|
||
| 13 | 语言与修辞 | `prose-craft` 语言修辞 | writing-tools-clark: sentence-rhythm, ladder-of-abstraction, back-off-show-off, voice-equalizer；bifeiyu: bifeiyu-paiban, bifeiyu-lyric-pass, bifeiyu-base-temp |
|
||
| 14 | 规划工作流 | `story-planning` 规划工作流 | story-engineering: workflow-beat-sheet, workflow-pantsing-is-planning；becoming-a-writer: story-draft-flow |
|
||
| 15 | 作品诊断 | `novel-diagnosis` 作品诊断 | story-engineering: six-core-competencies；aspects-of-the-novel: seven-aspects, story-vs-plot, time-vs-value-life, plot-character-tug, pattern-vs-rhythm, fantasy-prophecy-twin, round-table, quack-scholar-check |
|
||
|
||
单元数核对：5+10+3+2+3+5+6+5+6+2+5+4+7+3+9 = 75，加 §4 裁剪的 19 个 = 94。✓
|
||
|
||
## 2. 关键合并理由（重叠证据）
|
||
|
||
- **展示不说教是同一个原则的多个分身**：show-dont-tell（原则本体与落地）、no-psychological-description（情绪层：不写心理写动作）、imagination-to-fact（想象锚定细节）、bifeiyu-iceberg（留白层）、bifeiyu-anti-logic（飞白：从没写处看）合成 `show-and-omission`；主题层的 theme-demonstrate-not-tell 归 `theme-and-stance`；人物细节层的 mosaic-of-detail 归 `character-presentation`；修辞克制 back-off-show-off 归 `prose-craft`。
|
||
- **伏笔三家各说各话但是同一件事**：chekhov-gun 管"登记与兑现"，bifeiyu-foreshadowing 管"铺垫的自然度（修楼梯）"，detail-driven-climax 管"高潮从细节生长"。合成一条完整链路：埋设 → 自然过渡 → 兑现/高潮。
|
||
- **开头被写了 4 遍**：fiction-opening、inciting-incident、structure-setup-five-missions、structure-inciting-vs-plot-point。全部并入 `story-structure` 的开篇段，保留各自差异点（Brande 讲"别等完美第一句"，Clark 讲"开篇引擎+持续升级"，Brooks 讲"Setup 五使命 + 煽动事件≠第一情节点"）。
|
||
- **风格是文本技巧的留下，作者成长的砍掉**：voice-equalizer（风格工程化诊断与调节）和 bifeiyu-base-temp（风格体温 = 文本的稳定气质）作用于文本，进 `prose-craft`；voice-clean-professional、voice-growth-not-taught 讲作者声音的成长路径，属作者培养，裁剪。
|
||
- **诊断框架合成一套体检**：six-core-competencies 与 seven-aspects 都是"整体维度框架"，forster 其余 6 个是具体透镜，round-table/quack-scholar-check 是评审纪律 → 一个 `novel-diagnosis`，内部三段。
|
||
- **fantasy-prophecy-twin 的适配要求**：福斯特以英国小说的神异传统立论，蒸馏时须把"幻想/预言"两副面孔转述到中文语境（志怪、神魔、仙侠传统的门槛与姿态），说清适用边界。
|
||
|
||
## 3. 整合规范 v2（全量合并：只重复合并，不压缩抛弃）
|
||
|
||
> v1（压缩蒸馏：≤220 行、案例 ≤3 个、引文 ≤2 行）已废弃——举例、规则细节与原文摘录被大量压缩抛弃，审计见 `docs/2026-08-19-craft-skill举例审计清单.md`。自本次重抽取起执行 v2。
|
||
|
||
**目录结构**（每个综合 skill 一个包，不把一切压进 SKILL.md）：
|
||
|
||
```text
|
||
.claude/skills/<slug>/
|
||
├── SKILL.md # 入口：定位、触发、方法索引（每方法点一句话 + 指针）
|
||
├── references/ # 全量内容，按主题分文件
|
||
│ ├── <topic>.md
|
||
│ └── _coverage.md # 覆盖对照表（源单元 → 方法点 → 落点）
|
||
└── scripts/ # 可选：可执行的检查清单 / 诊断流程 / 台账模板
|
||
```
|
||
|
||
**规则**
|
||
|
||
1. 全量保存：75 个入册源单元的方法规则、判断标准、示例、原文摘录、描述，必须全部有落点（SKILL.md 索引、references/ 或 scripts/）。允许重复合并，不允许压缩抛弃。
|
||
2. SKILL.md 只做入口：frontmatter + 一句话定位 + `## 方法索引`（按创作动作组织，不按书组织；每个方法点一句话 + `→ references/<topic>.md` 指针）+ `## 引用索引`（表：文件 | 覆盖内容）+ 可选 `## 脚本`。方法细节与案例不进 SKILL.md。
|
||
3. references/<topic>.md 承载全量内容：方法细节、操作步骤、判断标准、案例全文、原文摘录、常见误区。任何文件不设行数上限。
|
||
4. 举例必须接近原文：保留具体对话、数字、动作、原句，禁止压缩成概括。
|
||
5. 原文摘录全量引用（源单元 R 段引文），不限处数、不限长度。
|
||
6. **追溯分离**：SKILL.md、references 内容文件、scripts/ 一律不带追溯标记（《书名》unit-slug 之类）；来源只记录在 `references/_coverage.md`：每个源单元一行，落点到文件级（references/<topic>.md），知道每个单元的内容在哪些文件即可，不做逐句定位。正文里的自然归属（句中出现作者名、书名）是内容本身，保留。
|
||
7. 合并规则：同一方法点多书出现 → 合并一条，保留各书视角与引文；同一作品案例 → 去重留最全，角度不同则都留；规则冲突 → 都保留，标注冲突与各自出处。
|
||
8. 中文适配内容（翻译腔信号、志怪神魔传统等）保留并标注"中文适配"；英文书案例照原文保留，方法点须说明中文落地。
|
||
9. scripts/ 仅在源单元含检查清单/诊断流程/模板类可执行内容时建，不硬造。
|
||
10. frontmatter：`name`（=目录名）、`description`（激活场景 + 关键 trigger + 不适用于，中文）、`domain`、`sources`（同 §1 分配表，不变；frontmatter 是机器元数据，不算正文追溯标记）。
|
||
11. 白话中文，禁抽象标签堆砌、禁排比凑数。
|
||
|
||
## 4. 裁剪清单（不进综合 skill，文件留 books/ 作原料）
|
||
|
||
**作者培养类（16 个，用户筛选线：不针对作者本人）**
|
||
|
||
| 单元 | 内容 |
|
||
|------|------|
|
||
| becoming-a-writer: morning-pages, scheduled-writing, imagination-over-willpower, writer-quiet-mind, writer-dual-self, wordless-leisure | 写作习惯与心理状态 |
|
||
| becoming-a-writer: pre-writing-blocks, set-aside-the-manuscript, childs-eye | 写作困难诊断、写后心态、素材积累 |
|
||
| wo-neng-fou-xiang-xin-zi-ji: obstacle-crossing | 写作障碍应对 |
|
||
| becoming-a-writer: two-pass-reading, imitate-technique-not-style | 读书方法与模仿学习 |
|
||
| bifeiyu: bifeiyu-reading-as-writing；wo-neng-fou-xiang-xin-zi-ji: literary-influence-transformation | 阅读即写作、文学影响转化 |
|
||
| story-engineering: voice-clean-professional, voice-growth-not-taught | 作者声音的入门与成长路径 |
|
||
|
||
**非虚构专用（3 个）**
|
||
|
||
| 单元 | 裁剪原因 |
|
||
|------|---------|
|
||
| sense-of-style: arcs-of-coherence | 原书 INDEX 标记非虚构专用（连贯弧依赖说明文段落结构） |
|
||
| sense-of-style: metadiscourse-killer | 非虚构专用（清理元话语是学术/公文文体问题） |
|
||
| sense-of-style: single-variable-rule | 非虚构为主（对比平行性；小说里对比常是隐喻的，原文自带此免责声明） |
|
||
|
||
**流水线测试产物（不入册，2026-08-19 用户拍板）**：源单元随附的 `test-prompts.json` / `test-results.md` 是拆书管线的验证产物，不是方法论内容，不合并；原料原件仍留 `books/`（含 gold-coins 的 `test-prompts.json`），将来需要可随时补。
|
||
|
||
## 5. 检查与清理门禁（整合完成后逐条过）
|
||
|
||
机械门禁：`craft/scripts/check_craft_skills.py`（覆盖闭合 + frontmatter + 包结构）；方法点覆盖与举例忠实度由独立子代理对照源单元核验。
|
||
|
||
- [ ] 94 个源单元：75 个恰好出现在一个综合 skill 的 sources 里，19 个在裁剪清单，无遗漏无重复
|
||
- [ ] 15 个综合 skill frontmatter 可解析，name=目录名，description 含 trigger 和"不适用于"
|
||
- [ ] 包结构完整：SKILL.md 含方法索引与引用索引；references/ 非空；`_coverage.md` 覆盖该 skill 全部源单元，引用的落点文件均存在
|
||
- [ ] 追溯分离：SKILL.md、references 内容文件、scripts/ 无追溯标记（机械扫描）；追溯集中在 `_coverage.md`（落点到文件级）
|
||
- [ ] 方法点覆盖与举例忠实度过独立子代理核验（无遗漏，举例接近原文）
|
||
- [ ] `craft/books/` 中无过程垃圾（PIPELINE_STATE / candidates / rejected / 原书 raw 文本）
|
||
- [ ] 综合 skill 之间无职责重叠（每个方法点有唯一归属，跨域引用只写一句话指针）
|