罗斯蒙德演示材料结构化整理

SKILL.md 节选

# 演示材料结构化整理

## 硬性规则（必须遵守）

1. **要点必须锚定素材原文**。每条 `points[].quote` 都要在素材库中逐字命中，杜撰、改写（如把"三天内"写成"72 小时"）一律 E3 拦截。
2. **先定主线，再填内容**。禁止"把素材按顺序念一遍"；页面 `role` 必须是十种角色之一，且必须包含「封面」与「收尾」（缺一即 E7）。
3. **人工补充必须注明**。`custom=true` 的要点（原素材里没有的内容）必须填 `note` 说明依据，否则 E13 拦截——保证"哪些来自素材、哪些是人工加的"始终可追溯。
4. **不用绝对化表述**。"行业第一""绝对""最好""100%"会触发 W10；对外材料应改用可验证说法。
5. **只改 outline.json，不在 Word 里改**。Word 是渲染产物，下次渲染会覆盖；改结构后重跑 `--reindex` 与校验。

## 五步流程

```bash
PY="<python>"
S="<skill>/scripts"

# 1 素材切片建库（S-x）
"$PY" "$S/parse_materials.py" 素材目录 -o materials.json --name "素材库名"
#    其他来源：
#      "$PY" "$S/parse_materials.py" --text "粘贴的一大段内容" --text-name "微信记录" -o materials.json
#      cat 文件 | "$PY" "$S/parse_materials.py" --stdin -o materials.json
#      "$PY" "$S/parse_materials.py" --json-list list.json -o materials.json
#      （目录里含 .docx 会自动按标题样式切片；--max-chars 控制单条最大字数）

# 2 生成页面骨架（P-x），按受众与主线预设
"$PY" "$S/build_outline.py" --materials materials.json --name "演示名称" \
    --audience "受众" --goal "演示目标" --duration 20 \
    --preset problem -o outline.json
#    --preset: problem 问题导向（默认）/ solution 方案导向 / internal 内部汇报

# 3 按每页 candidates 推荐的素材，填写 points（text / quote / sids）
#    quote 必须是素材原文片段，逐字复制；sids 用 find_quote 或人工确认

# 4 校验（有 ERROR 不许交付）
"$PY" "$S/check_outline.py" outline.json -o 校验报告.md

# 5 渲染 Word 演示脚本（可选 --md 同步出 Markdown 大纲）
"$PY" "$S/render_docx.py" outline.json -o 演示脚本.docx --md 演示大纲.md
```

人工调整结构后：

```bash
"$PY" "$S/render_docx.py" outline.json --reindex --out-json outline.json   # 重排编号
"$PY" "$S/check_outline.py" outline.json -o 校验报告.md                    # 必须复检
"$PY" "$S/render_docx.py" outline.json -o 演示脚本.docx --md 演示大纲.md
```

## 脚本

| 脚本 | 作用 |
|---|---|
| `parse_materials.py` | 素材 → `materials.json`（S-x）。支持目录/单文件/长文本/stdin/Word/JSON 清单 |
| `build_outline.py` | 生成页面骨架 `outline.json`（P-x），附每页候选素材线索 |
| `check_outline.py` | 质量闸门：14 条 ERROR + 10 条 WARN，有 ERROR 则 exit 1 |
| `render_docx.py` | 渲染 Word 演示脚本；`--md` 出 Markdown 大纲；`--reindex` 重排编号 |
| `lib_outline.py` | 公共库：切片、归一化逐字比对、相似度、时长配比 |

## 校验规则

**ERROR（命中即 exit 1，不许交付）**

| 码 | 含义 |
|---|---|
| E1 | 要点文本为空 |
| E2 | 要点缺少素材引文，且未标记为人工补充 |
| E3 | 引文在素材库中找不到逐字匹配（杜撰或改写） |
| E4 | 引用了不存在的素材编号 |
| E5 | 非封面页没有任何要点 |
| E6 | 页面 role 不在十种角色内 |
| E7 | 缺「封面」或「收尾」页，主线不完整 |
| E8 | 页面标题为空 |
| E9 | 素材库为空，无法核验 |
| E10 | 大纲没有任何页面 |
| E11 | 页面 id 重复 |
| E12 | 要点 id 重复 |
| E13 | 人工补充要点未写 note |
| E14 | 引文与所标素材编号对不上 |

**WARN（提示，不阻断）**

| 码 | 含义 |
|---|---|
| W1 | 单页要点少于 2 条或多于 6 条 |
| W2 | 素材未被任何页面引用（疑似遗漏内容） |
| W3 | 要点含数字但引文中没有该数字 |
| W4 | 页面缺少讲稿备注 |
| W5 | 页面时长合计与计划偏差超 20% |

SKILL.md 不止这些内容，安装后可阅读全文。

技能包内容

共 23 个文件，合计 120.0 KiB