前言¶
做汇报或方案时，常见路径是：在文档里堆素材，再手工套模板、调版式、导出 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 检索结果，可按同样方式核对。
- 三阶段流水线：
research.md（统一内容层）→ 每页独立 HTML（1280×720，Tailwind CSS + Lucide 图标）→ 通过dist/export-pptx.mjs导出.pptx。 - 状态文件
presentation.json：记录标题、theme、每页type/title/content_spec与文件映射；增删改页以该文件为单一事实来源，HTML 文件名创建后不重命名。 - 完整生成流程：收集需求 → 写
research.md（网页调研 / 整理用户材料 / AI 整理）→ 规划大纲 → 阻塞点：向用户展示大纲并等待确认 → 初始化项目 → 按串行或并行模式生成各页 HTML → 图标校验 → 导出。 - 增量编辑：改文案、改样式、换主题、增删页等，按「最小改动」原则操作；改完后同步
content_spec、重新跑图标校验并再导出。 - 辅助脚本：
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
