前言¶
做汇报材料时，常见路径是：在 PowerPoint 里手调版式，或让模型吐出一大段文字再自己贴进幻灯片。前者费时间，后者很难直接得到可交付的 .pptx，改一页往往牵动全局。
下面介绍 SkillHub 上的 ap1fdsa（包内 Skill 名为 aippt-maker）。它把「调研整理 → 单页 HTML 画布 → 导出 PPTX」串成固定流水线，由 Agent 按 SKILL.md 执行，适合从零做 deck，也支持改单页、换主题、增删页后重新导出。
这是什么¶
ap1fdsa 是社区发布的 Agent Skill，坐标 @u_5a98e01f/ap1fdsa，当前版本 1.0.0，分类为 office-efficiency，标签 requires_api_key=false（无需配置 API Key）。
官方入口：
- Skill 包地址：
https://api.skillhub.cn/u_5a98e01f/ap1fdsa - SkillHub 页面：
https://www.skillhub.cn/skills/u_5a98e01f/ap1fdsa
Skill 自述能力：在本地生成专业 PowerPoint；当用户要做 PPT、幻灯片、汇报或方案材料，或要对已有 deck 做增量编辑（改单页、换主题配色、增删页、导出 .pptx）时触发。
核心功能¶
以下能力均来自包内 SKILL.md 与工作流说明。
Research → HTML → PPTX 三阶段¶
research.md：在定大纲前，把网页调研、用户提供的材料或模型整理的内容写入项目目录下的统一内容层，后续大纲与单页生成只从这里取料，不依赖对话上下文记忆。presentation.json：记录标题、theme、每页类型与content_spec、文件映射；增删改页以该文件为单一事实来源。- 单页 HTML（1280×720）：每页独立 HTML，使用 Tailwind CSS 与 Lucide 图标；便于在浏览器预览，再由导出脚本转成 PPTX。
- 导出：通过
dist/export-pptx.mjs（约 2MB 编译产物，文档要求用node直接执行，不要读源码省 token）将项目目录导出为.pptx。
完整生成流程（8 步）¶
Agent 需按顺序执行，其中「向用户展示大纲并等待确认」为硬性阻塞点，未确认不得进入初始化与生成 HTML：
- 收集主题、受众、页数、风格及是否已有素材。
- 按模式生成
research.md（网页调研 / 整理用户材料 / AI 整理）。 - 结合
references/ppt-design.md规划每页type、title、content_spec。 - 阻塞：展示大纲与
theme，等待用户明确确认。 - 创建
slides/并写入presentation.json。 - 按
references/slide-generation.md串行或（在支持子 Agent 写文件的平台）并行生成各页 HTML。 - 运行图标校验脚本，修正无效的 Lucide 图标名。
- 检查字体、运行导出，得到带时间戳的
.pptx。
增量编辑¶
修改文案、样式、整页重设计、换主题、增删页时，遵循「文件名一旦创建不重命名、索引单调递增不复用」等规则；改完后同步 content_spec、重新校验图标并再次导出。
安装与启用¶
SkillHub 页面给出的安装提示为：参照 https://skillhub.cn/install/skillhub.md，安装 @u_5a98e01f/ap1fdsa。
1、安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装 ap1fdsa 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向 Agent 实际读取的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。
skillhub install @u_5a98e01f/ap1fdsa --dir <你的 skills 目录>
常用路径（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后按你所用客户端的要求重启或刷新 Agent，使 Skill 生效。
典型用法¶
项目目录结构¶
Agent 会在你指定的项目目录下维护如下结构：
<project_dir>/
├── research.md
├── presentation.json
└── slides/
├── slide_001.html
├── slide_002.html
└── ...
presentation.json 中 slides 数组顺序即放映顺序；file 字段稳定，创建后不重命名文件。
对话侧触发示例¶
用自然语言描述需求即可，例如：
- 「根据这份会议纪要做 12 页季度复盘 PPT，偏商务蓝灰风格。」
- 「在现有项目里把第 5 页改成数据对比，并重新导出 pptx。」
Agent 应走 Skill 中的阻塞确认：先给你大纲与主题，确认后再生成 HTML 与导出。
图标校验与导出（命令行）¶
图标校验（在项目 HTML 生成完成后）：
node "$SKILL_DIR/scripts/validate-icons.mjs" "<project_dir>"
首次导出前检查/安装字体（缺字体会导致版式计算错误）：
bash "$SKILL_DIR/scripts/check-fonts.sh"
bash "$SKILL_DIR/scripts/check-fonts.sh" --install
导出需在可运行 Playwright 无头 Chromium 的环境执行（文档说明不宜在受限沙箱内完成）：
node "$SKILL_DIR/dist/export-pptx.mjs" <project_dir> --output <output_path>
若缺少 Playwright，可先安装：
npm init -y && npm install playwright && npx playwright install chromium
导出文件名格式为 <title>_YYYYMMDD_HHmmss.pptx。
适用场景与注意¶
适合谁
- 需要可编辑
.pptx交付物，又希望由 Agent 承担调研整理与版式生成的团队或个人。 - 愿意按流程先确认大纲，再批量生成多页幻灯片的场景。
限制与注意
- 依赖 Node、Playwright Chromium 及 Skill 附带的字体检查脚本；导出步骤对运行环境要求高于纯文本 Skill。
- 默认单页串行生成；并行仅建议在确认支持子 Agent 写文件的平台使用。
- SkillHub 抓取元数据显示：评分 100000，下载 744，安装计数 0；实际体验取决于本地 Node/Playwright 与 Agent 是否严格遵循
SKILL.md中的阻塞与门禁步骤。
结尾¶
ap1fdsa 把 PPT 制作拆成可审计的项目文件（research.md、presentation.json、逐页 HTML），再在本地导出 PowerPoint，适合作为「办公效率」类 Agent Skill 使用。安装与详情见 SkillHub：https://www.skillhub.cn/skills/u_5a98e01f/ap1fdsa，Skill 包：https://api.skillhub.cn/u_5a98e01f/ap1fdsa。
