前言¶
组会、论文分享、答辩汇报，常见路径是：先读 PDF，再在 PowerPoint 或 Keynote 里逐页排版公式、表格和流程图。Slidev 用单个 Markdown 文件驱动整套幻灯片，预览和导出都走前端工具链，但对 Agent 来说，缺的是「哪些写法会踩坑、学术口吻怎么控、从 PDF 到 slides.md 怎么批处理」这类项目级约定。
下面介绍 SkillHub 上的 PPT Maker（坐标 @user_55aefa96/saulxiong-slidev-makeppt）。它把一套真实论文分享项目里沉淀的 Slidev 规范、脚本和流程写进 SKILL.md，让助手在无先验上下文时也能按同一套规则改 slides.md。
这是什么¶
PPT Maker 是社区发布的 Agent Skill（版本 1.0.2，分类 office-efficiency，发布者 user_55aefa96）。Skill 包内自述为基于 Slidev 的学术论文分享演示稿制作指南（内部亦称 bears-ppt-skill）。
它解决的不是「一句话生成炫酷商业 PPT」，而是：在 Slidev 项目里，把论文内容整理成约 30 页左右的学术分享 deck，并附带 PDF 抽取、批量修复脚本和口头报告稿（talk_script.md）的写作约定。标签标明 requires_api_key=false，不依赖额外 API Key。
SkillHub 页面统计（以抓取资料为准）：评分 100000，下载 1175 次。
核心功能¶
以下能力均来自 Skill 包内的 SKILL.md 与 README.md。
Slidev 项目结构与编辑目标¶
Skill 假定标准 Slidev 布局：根目录 slides.md 为主编辑文件；components/ 放可自动导入的 Vue 组件；scripts/ 放批处理脚本；public/ 放静态资源。助手应先读 slides.md，用分页符 --- 定位单页，尽量做局部修改，并利用开发态 HMR，避免无谓重启 Vite。
开发与导出命令¶
在项目根目录执行：
npm install # 首次安装依赖
npm run dev # 开发服务，默认 http://localhost:3030
npm run build # 静态构建
npm run export # 导出 PDF
npx slidev export --format pptx # 导出 PPTX
端口占用时可结束占用 3030 的进程后再启动（Skill 文档给出 lsof -ti:3030 | xargs kill -9 示例）。
硬性排版与交互规则¶
Skill 用「踩坑复盘」形式写死多条规则，例如：
- HTML 块内不用 KaTeX
$…$，矩阵与对齐公式列表用 CSS Grid，不用<br>手搓对齐。 - 长内容加
max-h-[…] overflow-y-auto；Mermaid 图注意边距与缩放。 - 标题不要手写序号（避免与 Slidev TOC 重复编号）。
- HTML 表格的
<tr>必须包在<tbody>内。 - 动画组件用递归
setTimeout，不用setInterval；动画为手动播放，带底部控制条，不默认自动循环。
学术口吻校验¶
面向论文分享，而非营销文案。Skill 列出禁用词（如「恐怖」「魔术」「破局」「完美」等）及替换表述，并提供 scripts/academic_tone.py 做语气检查。
从 PDF 到幻灯片的流水线¶
典型流程：
python scripts/extract_pdf.py path/to/paper.pdf pdf_text.txt（依赖pdfplumber）生成带页码标记的纯文本；- 人工或 Agent 据此撰写
slides.md； - 按需运行
fix_math.py、fix_headings.py、fix_tables.py、fix_anim_loop.py、normalize_spacing.py等 idempotent 脚本； academic_tone.py通过后npm run dev预览。
也可用 replace_block.py 按标题区间替换整块内容（例如把静态 Mermaid 换成 Vue 组件）。
口头报告稿¶
用户需要「可照读的 30 分钟报告稿」时，Skill 约定在项目根生成 talk_script.md：按普通话约 200 字/分钟估算字数、逐页结构、翻页标记 【翻页】 等（见 SKILL.md 第 12 节）。
安装与启用¶
通过 SkillHub 安装到 Agent¶
SkillHub 页面给出的安装提示为：先阅读 SkillHub 安装说明，再安装本 Skill。
若本机已有 skillhub CLI，安装时需用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。示例：
command -v skillhub && skillhub --version
skillhub install @user_55aefa96/saulxiong-slidev-makeppt --dir ~/.cursor/skills/
常见路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
未安装 CLI 时，可按 skillhub.md 中的 curl 安装脚本完成安装。本文不展开各 Agent 的重启策略；安装后按你所用客户端的 Skill 加载方式启用即可。
与 Slidev 项目结合¶
Skill 安装到 Agent 后，助手读取的是 Skill 目录下的 SKILL.md。实际出片仍要在 Slidev 项目里维护 slides.md；可将 Skill 包中的 scripts/ 复制到项目，或在新项目中参照 Skill 约定初始化目录（见 README.md 的 Quick start）。
典型用法¶
下面是一条可复现的主线（命令与路径来自官方 Skill 文档）。
- 在 Slidev 项目中准备论文 PDF，抽取文本：
pip install pdfplumber
python scripts/extract_pdf.py path/to/paper.pdf pdf_text.txt
-
根据
pdf_text.txt编写或修改slides.md，新增页时遵循：分隔符---、## 标题（无手写序号）、学术语气 §6。 -
提交前批量整理：
python scripts/fix_math.py && \
python scripts/fix_headings.py && \
python scripts/fix_tables.py && \
python scripts/normalize_spacing.py --apply && \
python scripts/academic_tone.py
- 本地预览并导出：
npm run dev
npm run export
npx slidev export --format pptx
- 若需要照读稿，按 Skill 第 12 节生成
talk_script.md，并按字数与翻页标记自检。
在 Cursor 等环境中，可直接用自然语言描述任务，例如「按 PPT Maker 规则，把第 8 页公式改成 HTML 实体并跑一遍 tone 检查」，前提是已安装本 Skill 且当前工作区是 Slidev 项目。
适用场景与注意¶
适合：
- 已有或愿意使用 Slidev 的开发者、研究生、课题组，需要把 学术论文 做成结构稳定、可预览、可导出 PDF/PPTX 的分享稿；
- 希望 Agent 遵守统一排版与学术措辞，而不是每次从零摸索 Slidev 细节；
- 需要从 PDF 拉正文、用脚本批量修公式/标题/表格的团队。
限制与注意：
- 核心是 Slidev + Markdown/Vue，不是 WPS/Office 原生模板一键生成；最终 PPTX 走
slidev export，版式以 Slidev 主题与内容为准。 - 脚本默认相对
scripts/操作上级目录的slides.md；目录不一致时要改路径或调整项目结构。 extract_pdf.py对复杂版式可能失真，Skill 建议必要时用pdftotext -layout等兜底。- SkillHub 统计中的「安装」与本地
skillhub install是否计入，以平台显示为准；使用时以你本机 skills 目录是否出现@user_55aefa96/saulxiong-slidev-makeppt为准。
结尾¶
PPT Maker 把 Slidev 学术分享稿的编辑契约、批处理脚本和报告稿写法收拢进一份 SKILL.md，适合作为 Agent 在论文演示项目里的长期参考。需要查看元数据或复制安装提示时，可打开 SkillHub 页面：
- 技能页：https://www.skillhub.cn/skills/user_55aefa96/saulxiong-slidev-makeppt
- API 条目：https://api.skillhub.cn/user_55aefa96/saulxiong-slidev-makeppt
安装坐标：@user_55aefa96/saulxiong-slidev-makeppt，当前版本 1.0.2。
