Agent Skill

ppt-master文档助手

将任意文档、网页文章或粘贴文本转化为 ppt-master 最优输入格式的 Markdown。对原文进行去噪、结构化精炼、YAML 意图声明、页级拆分和图表标注,输出格式专为 ppt-master 的 Strategist 管线优化。触发词:生成PPT素材、提炼成PPT、文档转PPT、转为幻灯格式、doc-to-slides。

办公效率·麻衣神·来自 skill_hub·skillhub.cn ↗
skillhub install @user_633c893d/md-format
3 Stars·4.4万 综合热度·4,834 字文档·源站更新 2026-11-14

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)
网页 URLsourcetomd.py <URL>;仅在失败时退回 WebFetch
Markdown / TXT / CSV / TSV直接 Read
用户粘贴文本直接使用对话中的文本

sourcetomd.py 默认把 Markdown 写在源文件旁边,-o 可指定输出。

Step 2: 去噪与提取

  • 移除:页眉页脚、导航栏、广告、免责声明、版权信息、重复的页码行
  • 保留:正文、标题层级、数据表格、关键数字、图表说明及其数据来源
  • 标准化:标题统一为 Markdown H1–H3;散落的数字整理成可读形式

Step 3: 内容精炼

对每一节执行:

  1. 提炼核心结论 — 一句话概括本节核心信息,写入 > blockquote
  2. 压缩要点 — 段落压缩为 3–5 条 bullet,每条 ≤20 字
  3. 抽取数据表 — 结构化数字 / 对比关系转为 Markdown 表格
  4. 标注视觉倾向 — 适合图示的节,在末尾加语义提示(见格式规范)

🚨 硬性自查(不可跳过):遍历所有 H2 节统计 bullet 数 —— 超过 5 条则合并相近项;不足 3 条则回原文补充;逐节过完才能进入 Step 4。

Step 4: 写 Intent Hints

推断以下字段,组装成一个 HTML 注释块,放在输出文件最顶部。

用 HTML 注释块的原因:ppt-master Step 1 不解析 Markdown 内的 YAML front matter。HTML 注释在渲染中不可见、不会被当成页面内容,但 Strategist 读 content 文件时能看到,从而在阶段 1 给出更贴合的推荐。

字段阶段怎么推断取值
canvas1按内容形态:普通演示横版 → ppt169(1280×720)见 ppt-master config.py CANVAS_FORMATS
page_count1由 H2 节数给范围建议,不要拍死如 12–15
audience1从内容语气和术语推断,越具体越好自由文本
communication_intent1从结论和 CTA 推断"要达成什么",可复合自由文本
audience_outcome1看完会做什么 / 知道什么 / 决定什么自由文本
core_message1别的都忘了也要记住的那一句自由文本
delivery_context1presenter-led / reader-led / hybrid / recorded + 场合与时长自由文本
artifact_afterlife1审阅 / 批准 / 审计 / 归档 / 交接 / 复用 / 无计划自由文本
content_divergence1不要替用户推断,只留空位留空
reading_mode2内容密度高 → text;适中 → balanced;演示型 → presentationtext / balanced / presentation
mode2从内容结构推断叙事骨架pyramid / narrative / instructional / showcase / briefing
visual_style2见下方 18 个 preset,只能从名单里选见下
palette2优先从品牌色推断,无则留空#主色, #辅色, #背景色 起手

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 / productswiss-minimal soft-rounded glassmorphism dark-tech blueprint
Editorial / publicationeditorial photo-editorial data-journalism brutalist
Expressive / printmemphis zine vintage-poster paper-cut
Hand-drawn / brushsketch-notes ink-notes chalkboard ink-wash
Specialtypixel-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)

  1. 展示 Intent Hints 推断结果,逐项说明依据,询问是否调整
  2. 展示 内容提炼结果(每节 blockquote + bullet 条数 + 表格 + 视觉提示),确认无信息丢失
  3. ⛔ 等待用户确认或修改
  4. 确认后写入工作目录下的 <标题>.md
  5. 告知下一步:放进 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

  1. 导入:python3 <ppt-master>/scripts/projectmanager.py import-sources <projectpath> <标题>.md
  2. 从 workflows/generate-pptx.md 的 Step 3 起继续(Step 1 内容处理已被本 skill 替代;Step 2 的 init 与 import-sources 仍需执行)
  3. 在 Step 4 的 confirm_ui 三阶段里核对 / 修改沟通契约、模式、视觉风格、配图与生产机制

Intent Hints 只是加快确认速度的备忘,不构成对 Strategist 的约束。若注释里的值与用户在 confirm_ui 的选择冲突,以用户确认为准。


参考

  • ppt-master-format.md — ppt-master 流程契约、字段到 Design Spec §I–§X 的映射、§IX 页面结构、图表选择机制

同分类其他技能

查看全部 ›