前言¶

做汇报或方案时，常见路径是：在文档里堆素材，再手工套模板、调版式、导出 PPT。Agent 能写大纲和文案，但若直接改 PPTX 结构，容易在版式、主题一致性和导出质量上踩坑。下面介绍 SkillHub 上的 api_maker2（坐标 @user_7e25a48a/api-maker）：把「调研汇总 → 单页 HTML → 导出 .pptx」写成固定流水线，并覆盖从零生成与增量改稿两类任务。

这是什么¶

api_maker2 是社区来源（community）的 Agent Skill，当前版本 1.0.1，分类为 office-efficiency，发布者为 user_7e25a48a（SkillHub 页面标注作者为「yazi测试账号」）。官方简介写明：在本地生成专业 PowerPoint 演示文稿；当用户要做 PPT、幻灯片、deck、Keynote 式演示、报告或方案材料，或要改单页、换主题配色、增删页、导出 .pptx 时，应触发该 Skill。标签 requires_api_key=false，不依赖外部 API Key。

SkillHub 页面：https://www.skillhub.cn/skills/user_7e25a48a/api-maker
API 入口（安装包下载等）：https://api.skillhub.cn/user_7e25a48a/api-maker

核心功能¶

以下能力均来自 Skill 包内 SKILL.md 与 SkillHub 检索结果，可按同样方式核对。

1. 三阶段流水线：research.md（统一内容层）→ 每页独立 HTML（1280×720，Tailwind CSS + Lucide 图标）→ 通过 dist/export-pptx.mjs 导出 .pptx。
2. 状态文件 presentation.json：记录标题、theme、每页 type / title / content_spec 与文件映射；增删改页以该文件为单一事实来源，HTML 文件名创建后不重命名。
3. 完整生成流程：收集需求 → 写 research.md（网页调研 / 整理用户材料 / AI 整理）→ 规划大纲 → 阻塞点：向用户展示大纲并等待确认 → 初始化项目 → 按串行或并行模式生成各页 HTML → 图标校验 → 导出。
4. 增量编辑：改文案、改样式、换主题、增删页等，按「最小改动」原则操作；改完后同步 content_spec、重新跑图标校验并再导出。
5. 辅助脚本：scripts/validate-icons.mjs 修正无效 Lucide 图标名；scripts/check-fonts.sh 检查或安装字体；导出依赖 Playwright 无头 Chromium，需在非沙箱环境执行。

安装与启用¶

安装前需已具备 skillhub CLI。未安装时可按 SkillHub 官方说明执行：

command -v skillhub && skillhub --version

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装 api_maker2 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别。SkillHub 检索给出的命令为：

skillhub install api-maker --namespace user_7e25a48a --dir <你的 skills 目录>

常见路径（摘自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下 .agents/skills/

也可让 Agent 按 https://skillhub.cn/install/skillhub.md 安装坐标 @user_7e25a48a/api-maker。

启用后，Agent 读取 Skill 目录下的 SKILL.md 即可按其中工作流执行；SKILL_DIR 即该 SKILL.md 所在目录。

典型用法¶

下面步骤对应 Skill 内「Core Workflow」与导出章节，便于对照复现。

1. 在项目目录准备三件套

<project_dir>/
├── research.md
├── presentation.json
└── slides/
    ├── slide_001.html
    └── ...

presentation.json 示例结构（字段含义见 Skill 文档）：

{
  "title": "Presentation Title",
  "theme": "Natural-language style description",
  "slides": [
    {
      "file": "slide_001.html",
      "type": "title",
      "title": "Slide Title",
      "content_spec": "本页要点与结构说明（不写死文案）"
    }
  ]
}

2. 生成 HTML 后校验图标

将 SKILL_DIR 替换为 Skill 安装路径中的 api-maker 目录：

node "$SKILL_DIR/scripts/validate-icons.mjs" "<project_dir>"

3. 首次导出前检查字体

bash "$SKILL_DIR/scripts/check-fonts.sh"
bash "$SKILL_DIR/scripts/check-fonts.sh" --install

4. 导出 .pptx

需在允许 Playwright 运行的环境执行；export-pptx.mjs 为约 2 MB 编译产物，Skill 要求用 node 直接运行、不要通读源码：

node "$SKILL_DIR/dist/export-pptx.mjs" <project_dir> --output <output_path>

若缺少 Playwright，Skill 给出的安装方式为：

npm init -y && npm install playwright && npx playwright install chromium

导出文件名建议格式：<title>_YYYYMMDD_HHmmss.pptx。

与用户对话时，自然语言即可触发，例如：「根据这份材料做 12 页技术汇报 PPT」「把第 3 页改成深色数据页并重新导出」。Agent 应按 Skill 在 Step 4 暂停等待大纲确认，再进入生成与导出。

适用场景与注意¶

适合谁：需要在本地产出可编辑 .pptx、又希望 Agent 负责调研整理、分页设计与版式一致性的开发者或办公场景；分类为办公效率，与「只做 Markdown 大纲、不做文件」的用法相比，更强调可交付文件。

限制与注意：

• 导出依赖 Node.js、Playwright、Chromium 及字体环境；沙箱内导出可能失败，Skill 明确要求在沙箱外运行导出命令。
• 默认串行逐页生成 HTML；仅在确认平台支持子 Agent 写文件时（如 Claude Code）才考虑并行模式。
• 工作流中 Step 4 为阻塞步骤，未获用户确认不得进入生成 HTML，避免擅自定稿。
• SkillHub 抓取页显示评分 100000、下载 773（与用户线索中的数字可能因统计时间不同而不一致，以 SkillHub 页面为准）。

结尾¶

api_maker2 把 PPT 制作拆成可核对的项目结构与命令行导出，适合交给 Agent 做全流程或单页迭代。安装与说明以 SkillHub 为准：

• 技能页：https://www.skillhub.cn/skills/user_7e25a48a/api-maker
• 安装文档：https://skillhub.cn/install/skillhub.md