前言¶
組會、論文分享、答辯彙報，常見路徑是：先讀 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。
