ppt-master文档助手
将任意文档、网页文章或粘贴文本转化为 ppt-master 最优输入格式的 Markdown。对原文进行去噪、结构化精炼、YAML 意图声明、页级拆分和图表标注,输出格式专为 ppt-master 的 Strategist 管线优化。触发词:生成PPT素材、提炼成PPT、文档转PPT、转为幻灯格式、doc-to-slides。
skillhub install @user_633c893d/md-format
README 文档
4,834 字Doc to Slides
把任意输入转化为 ppt-master 能直接读取的干净 Markdown,并附一份给 Strategist 阶段 1 的意图提示。
定位:本 skill 是 ppt-master 的上游预处理,服务 Generate PPTX route 的 Step 1。它不是替代品,也不是第五条 route ——
routing.md有硬规则Forbidden — route-choice menus,所以用户已表达"生成 PPT"时,本 skill 不得跳出来竞争路由。所有设计决策(页面编排、模式、风格、配色、配图)由 ppt-master 的 Strategist 通过 confirm_ui 三阶段与用户确认,本 skill 不参与、不代拍。
硬性规则
- 加载本 skill 前先调用
Skill({ skill: "doc-to-slides" })读入本文件,不要凭记忆执行 - ⛔ Step 6 是唯一用户门禁,必须等用户确认后才能写入文件
- 本 skill 的门禁不替代 ppt-master Step 4 的 confirm_ui 三阶段 —— 那才是最终决策点
产出原则
- 不编造、不添加、不改变原意。只做压缩与结构化;跨源补事实是 ppt-master
topic-research的职责 - 结构服务拆页:干净的 H2 层级让 Strategist 写 §IX 时几乎不用重排
- 提示而非规定:视觉倾向、意图提示都是建议,Strategist 有最终决定权
触发条件
- 用户提供文档 / 网页链接 / 粘贴文本,并表达"生成 PPT"、"做演示文稿"、"提炼成幻灯片格式"
- 用户提到本 skill 名称或触发词
工作流
Step 1: 接收输入
| 输入类型 | 处理方式 |
|---|---|
| PDF / DOCX / XLSX / PPTX / EPUB / HTML / LaTeX / RST | 用 ppt-master 的统一转换器:python3 <ppt-master>/scripts/sourcetomd.py <file>(Windows 上 python3 不可用则用 python) |
| 网页 URL | sourcetomd.py <URL>;仅在失败时退回 WebFetch |
| Markdown / TXT / CSV / TSV | 直接 Read |
| 用户粘贴文本 | 直接使用对话中的文本 |
sourcetomd.py默认把 Markdown 写在源文件旁边,-o可指定输出。
Step 2: 去噪与提取
- 移除:页眉页脚、导航栏、广告、免责声明、版权信息、重复的页码行
- 保留:正文、标题层级、数据表格、关键数字、图表说明及其数据来源
- 标准化:标题统一为 Markdown H1–H3;散落的数字整理成可读形式
Step 3: 内容精炼
对每一节执行:
- 提炼核心结论 — 一句话概括本节核心信息,写入
>blockquote - 压缩要点 — 段落压缩为 3–5 条 bullet,每条 ≤20 字
- 抽取数据表 — 结构化数字 / 对比关系转为 Markdown 表格
- 标注视觉倾向 — 适合图示的节,在末尾加语义提示(见格式规范)
🚨 硬性自查(不可跳过):遍历所有 H2 节统计 bullet 数 —— 超过 5 条则合并相近项;不足 3 条则回原文补充;逐节过完才能进入 Step 4。
Step 4: 写 Intent Hints
推断以下字段,组装成一个 HTML 注释块,放在输出文件最顶部。
用 HTML 注释块的原因:ppt-master Step 1 不解析 Markdown 内的 YAML front matter。HTML 注释在渲染中不可见、不会被当成页面内容,但 Strategist 读 content 文件时能看到,从而在阶段 1 给出更贴合的推荐。
| 字段 | 阶段 | 怎么推断 | 取值 |
|---|---|---|---|
canvas | 1 | 按内容形态:普通演示横版 → ppt169(1280×720) | 见 ppt-master config.py CANVAS_FORMATS |
page_count | 1 | 由 H2 节数给范围建议,不要拍死 | 如 12–15 |
audience | 1 | 从内容语气和术语推断,越具体越好 | 自由文本 |
communication_intent | 1 | 从结论和 CTA 推断"要达成什么",可复合 | 自由文本 |
audience_outcome | 1 | 看完会做什么 / 知道什么 / 决定什么 | 自由文本 |
core_message | 1 | 别的都忘了也要记住的那一句 | 自由文本 |
delivery_context | 1 | presenter-led / reader-led / hybrid / recorded + 场合与时长 | 自由文本 |
artifact_afterlife | 1 | 审阅 / 批准 / 审计 / 归档 / 交接 / 复用 / 无计划 | 自由文本 |
content_divergence | 1 | 不要替用户推断,只留空位 | 留空 |
reading_mode | 2 | 内容密度高 → text;适中 → balanced;演示型 → presentation | text / balanced / presentation |
mode | 2 | 从内容结构推断叙事骨架 | pyramid / narrative / instructional / showcase / briefing |
visual_style | 2 | 见下方 18 个 preset,只能从名单里选 | 见下 |
palette | 2 | 优先从品牌色推断,无则留空 | #主色, #辅色, #背景色 起手 |
mode与visual_style的custom值由 Strategist 阶段 2 强制随附 AI 提案,本 skill 不要提供 custom。
mode 的 5 个 preset:
| 值 | 说明 | 适用 |
|---|---|---|
briefing | 不加叙事骨架,原样呈现;约束最轻 | 商业汇报、数据报告 |
pyramid | 结论先行 → 层层论证 | 提案、说服性汇报 |
narrative | 故事弧线,起承转合 | 品牌故事、融资路演 |
instructional | 前提 → 讲解 → 检验 | 培训课件、教学材料 |
showcase | 视觉主导,文字极简 | 产品展示、案例集 |
visualstyle 的 18 个 preset(与 ppt-master 的 confirmui/static/catalogs.json 对齐):
| 分组 | preset |
|---|---|
| Corporate / product | swiss-minimal soft-rounded glassmorphism dark-tech blueprint |
| Editorial / publication | editorial photo-editorial data-journalism brutalist |
| Expressive / print | memphis zine vintage-poster paper-cut |
| Hand-drawn / brush | sketch-notes ink-notes chalkboard ink-wash |
| Specialty | pixel-art |
挑风格时按内容气质对照:严肃商业 / 咨询 → swiss-minimal;财经 / 长文分析 → editorial 或 data-journalism;科技 / AI → dark-tech;产品 / SaaS / 培训 → soft-rounded;文化 / 东方审美 → ink-wash;教学 / 课堂 → sketch-notes 或 chalkboard;老字号 / 周年 → vintage-poster。
⚠️
visualstyle不携带颜色 —— 风格只描述形状语言、装饰密度、留白节奏、字体性格、质感,不含 HEX、不锁配色。配色是 confirmui 里独立的一项,两者正交。
注释块格式(文件第一行):
<!-- doc-to-slides · intent hints
以下仅为给 ppt-master Strategist 阶段 1 的参考提示,不是输入契约;
最终取值一律以 ppt-master confirm_ui 的 stage1/stage2 用户确认为准。
canvas: <推断值>
page_count: <建议范围>
audience: <推断值>
communication_intent: <推断值>
audience_outcome: <推断值>
core_message: <推断值>
delivery_context: <推断值>
artifact_afterlife: <推断值>
reading_mode: <推断值>
mode: <推断值>
visual_style: <推断值>
palette: <推断值或留空>
content_divergence: (留空,由用户在 confirm_ui 中自行填写)
-->
Step 5: 组装输出
<!-- doc-to-slides · intent hints
...(见 Step 4)
-->
# <文档标题>
---
## <第一节核心标题>
> <一句话核心结论>
- <精炼要点1>
- <精炼要点2>
- <精炼要点3>
| 指标 | 数据 |
|------|------|
| ... | ... |
<!-- visual: <内容形状的语义描述> -->
---
## <第二节核心标题>
...
Step 6: 输出与确认(⛔ BLOCKING)
- 展示 Intent Hints 推断结果,逐项说明依据,询问是否调整
- 展示 内容提炼结果(每节 blockquote + bullet 条数 + 表格 + 视觉提示),确认无信息丢失
- ⛔ 等待用户确认或修改
- 确认后写入工作目录下的
<标题>.md - 告知下一步:放进 ppt-master 项目的
sources/,从 Generate 流程 Step 2 起继续;受众 / 目标 / 风格的改动要在 ppt-master 的 confirm_ui 里改才有效
格式规范
节边界
- 每个
---+ H2 = 给 Strategist 的一个页面候选(最终页数由 Strategist 阶段 2 与用户确认) - 层级对应:本文 H1 + H2 恰好对应 ppt-master §IX 的
### Part N+#### Slide NN,保持这个层级可免除 Strategist 的重排 - H2 标题 ≤20 字;H3 仅在需要子层级时使用
核心结论(blockquote)
以 > 开头,紧跟 H2 标题后,一条即可,15 字以内。
要点(bullet)
每条 ≤20 字,3–5 条为佳,不超过 5 条。
表格
标准 Markdown 表格语法,表头下有分隔线。
视觉倾向提示
<!-- visual: 三年营收同比变化趋势·单指标量级增长 -->
<!-- visual: 四类竞品价格对比·离散分类比较 -->
<!-- visual: 不需要图示 -->
- 放在对应节末尾
- 写内容形状,不要写图表类型:ppt-master 用 3–8 个 content-shape 语义标签从 76 个图表模板里召回,没有
bar/line这类固定类型枚举,写死类型会误导 - 只是建议,Strategist 有最终决定权
文件命名与落位
- 输出
<文档标题>.md到当前工作目录,交付时放进<project>/sources/ - 文件名要语义清晰 —— 多源项目里 stem 必须互不冲突,且
sources/下的<stem>.md就是 ppt-master 认定的内容契约文件
交接给 ppt-master
- 导入:
python3 <ppt-master>/scripts/projectmanager.py import-sources <projectpath> <标题>.md - 从
workflows/generate-pptx.md的 Step 3 起继续(Step 1 内容处理已被本 skill 替代;Step 2 的 init 与 import-sources 仍需执行) - 在 Step 4 的 confirm_ui 三阶段里核对 / 修改沟通契约、模式、视觉风格、配图与生产机制
Intent Hints 只是加快确认速度的备忘,不构成对 Strategist 的约束。若注释里的值与用户在 confirm_ui 的选择冲突,以用户确认为准。
参考
- ppt-master-format.md — ppt-master 流程契约、字段到 Design Spec §I–§X 的映射、§IX 页面结构、图表选择机制
同分类其他技能
查看全部 ›腾讯文档(docs.qq.com)-在线云文档平台,是创建、编辑、管理文档的首选 skill。涉及"新建/创建/编辑/读取/查看/搜索文
335 262.3万 WPS Office 全家桶WPS Office 全家桶 - 四引擎(WPS/MS Office/LibreOffice/纯Python)智能识别用户已安装软件,纯
182 109.3万 ppt-generator-skill智能 PPT 生成助手。根据用户描述的主题、行业、风格,自动生成漂亮的 PPT 文件。支持所有行业(商务、教育、科技、医疗、金融、创意等
378 91.6万 腾讯文档在线协作自动化通过 Tencent Docs Open API 以 curl + jq 创建、读取、列出、搜索和管理腾讯文档的自动化工作流,覆盖在线文
0 85.8万 WPS Office 全家桶WPS Office 全家桶 - 四引擎(WPS/MS Office/LibreOffice/纯Python)智能识别用户已安装软件,纯
5 81.6万 秘书材料星公文写作-妙笔skill体制内资深办公室主任+管理学博士,自学编程开发的智能公文写作Skill,让所有办公室同仁少掉头发、少加无用的班,材料一稿过关,省下的时间
50 77.2万