1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | qiaomu-bento-ppt |
| 作者/维护者 | 向阳乔木（GitHub 用户名 joeseesun） |
| 来源链接 | https://github.com/joeseesun/qiaomu-bento-ppt |
| 许可证 | MIT（GitHub API 确认） |
| GitHub Stars / Forks | 100 / 8（GitHub API，截至 2026-07-30） |
| 最新版本 | v1.2.0（仓库 manifest.json 记录，2026-07-27 更新） |
| 安装方式 | npx skills add joeseesun/qiaomu-bento-ppt（另支持手动复制到各工具的规则目录，见第 10 章） |
2. 功能介绍与亮点
qiaomu-bento-ppt 把简报、笔记、报告、URL、数据集或已有的 .bento.html 文件，转成可编辑、可演示、可离线分发的单文件 HTML 演示文稿（bento/slides 格式）。它先判断受众与叙事弧，再把内容映射到表现形式：趋势/量级用图表，规格/对比用表格，前后变化用形态渐变（morph），次级解释用可展开状态卡片，关键数字用动态计数。产出的单文件同时携带文档数据、查看器与编辑器——双击打开即可编辑、演示或保存，不需安装 PowerPoint 或登录云服务。
主要亮点：
- 内置校验门禁链：路由、结构、Shell 完整性、身份一致性（编辑时
docId不变）、视觉质量、浏览器复核、回滚边界（默认不覆盖原文件）逐层把关，证据不足标注“missing evidence”。 - 上游版本治理：内置固定版本官方 bento shell 与规范快照（SHA-256 校验），日常生成不联网，仅用户明确要求同步时才运行专门脚本，且只开 PR 供人工复核。
- 权限边界显式声明：SKILL.md 明文禁止发布/部署/签名、禁止读取签名密钥、禁止把 token/cookie/账号信息写入产出文件。
- 中英双语文档，附可复现示例 deck。
3. 适用场景
固定分类：文档与办公自动化。
适合需要频繁产出演示文稿、又希望收件人无需安装 PowerPoint 即可查看和编辑的用户：独立内容创作者、需把报告/数据转成可分享网页演示的产品经理，以及要把演示文稿发给同事协作修改（而非只读分享）的团队。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持。README 提供
mkdir -p .claude/skills+ 手动复制步骤，也支持npx skills add一条命令安装。 - Codex：✅ 原生支持。README 列出 Codex 对应的规则文件路径
AGENTS.md，manifest.json的target_platforms字段同时列出openai/claude/generic。 - OpenClaw / Hermes Agent：✅ 原生支持——
npx skills add是 vercel-labs/skills 官方安装器（经 npm 注册表核实同源），其文档的 Supported Agents 表格列出了 OpenClaw 与 Hermes Agent，可经该安装器原生获取，但本仓库文档未直接点名这两个生态。
5. 推荐理由
多数 AI 生成 PPT 技能止步于“标题 + 三个 bullet”的静态文字页，或做出美观页面却仍是只读产物。qiaomu-bento-ppt 把内容分流到图表、表格、形态渐变等表现形式，再产出自带查看器与编辑器的单文件——打开就能继续改、继续讲。更少见的是它对“上游依赖”的工程化处理：官方 shell 与规范固定版本内置并用哈希校验，日常零联网、零账号，升级走“先开 PR 人工复核”而非静默变更，对希望长期、可控地把演示生成交给 Agent 的用户是值得关注的可靠性保障。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | 上线 5 天涨到 100 stars、8 forks，增长明显快于同期同规模仓库；作者向阳乔木持续发布多个同类技能仓库（qiaomu-design、qiaomu-goal-meta-skill、qiaomu-ppt 等），显示稳定的独立开发投入而非一次性刷星；但截至评估时全部提交与已合并 PR 均来自作者本人，尚无独立第三方参与，故未打更高档位 |
| 可用性 | 8 | 安装命令单一（npx skills add），中英文文档完整并附可复现示例 deck、生成脚本与验证报告；运行时零 API Key、零账号；未打满分因需本机同时具备 Node.js 与 Python 3.10+，且仓库尚新、长期维护记录有限 |
| 安全性 | 9 | 逐脚本核查未见 shell=True、eval/exec、os.system 等风险模式；默认完全离线，仅用户明确要求同步上游时才联网且目标固定为 GitHub 官方地址；无需 API Key；SKILL.md 正文显式禁止发布/签名/直接推送 main、禁止写入凭据类信息；License MIT，清晰 |
综合评分：7.67（三项均值）
安全检查清单： ① shell 命令：有但范围明确，本地 Python 脚本负责提取/构建/校验，仅传入完整 bento 项目路径时才调用固定命令复核，非拼接用户输入执行 ② 联网外发：默认否，仅用户显式要求“同步上游”时才请求官方 GitHub 地址 ③ API key/凭据：不需要 ④ 可疑指令迹象：精读 SKILL.md 与全部脚本，未发现可疑指令或隐藏外发逻辑 ⑤ 作者/组织信誉：独立开发者，GitHub 上有稳定发布历史与可查证身份，无造假迹象 ⑥ License：MIT，明确 ⑦ 最近维护：创建于 2026-07-25，2026-07-30 评估时仍有提交，长期节奏待观察
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| guizang-ppt-skill | 同为单文件 HTML 演示技能，内置“电子杂志”与“瑞士国际主义”两套预设视觉风格系统，由归藏个人打磨多年沉淀而成，获多家机构赞助 | 侧重预设风格的视觉打磨与叙事表达；qiaomu-bento-ppt 侧重内容类型到表现形式的结构化映射（图表/表格/morph/状态卡）与产出物自带编辑器，并额外内置上游版本锁定与哈希校验机制 |
| dashi-ppt-skill | 一条命令生成可在浏览器编辑、且可导出为传统 .pptx 的演示技能 |
提供 .pptx 导出路径，适合仍需交付 Office 格式的场景；qiaomu-bento-ppt 明确不做 .pptx 交付，专注单文件 HTML 的离线可编辑体验，换来的是不依赖 Office 生态的自包含分发方式 |
| pptx-anthropics-skills | Anthropic 官方出品，基于 python-pptx 生成/编辑标准 .pptx 文件，第三方榜单人气第一 |
产出物是标准 Office 格式，兼容性最广、生态最成熟；qiaomu-bento-ppt 换来的是免安装 PowerPoint、双击即演示即改的轻量分发方式,但生态成熟度与用户基数尚无法与官方技能相比 |
8. 用户评价
该技能目前在第三方平台尚无独立具名用户评价；现有讨论仅见于作者本人的公开发布说明。
9. 其他补充
仓库内置路由触发测试用例与浏览器验收脚本可自检，同类技能中较少见；bento/slides 格式与官方 shell 继承自 nyblnet/bento。
10. 安装使用方式
通用安装：
npx skills add joeseesun/qiaomu-bento-pptCodex / Windsurf / Cline 等：将 SKILL.md 内容复制进对应工具的规则文件（Codex 用 AGENTS.md，Windsurf 用 .windsurfrules，Cline 用 .clinerules）。
验证安装：python3 scripts/bento_deck.py locate，返回结果应包含 "standalone": true。
安装后无需重启，直接用自然语言描述需求即可触发，例如“用 qiaomu-bento-ppt 把这份报告做成 12 页离线演示文稿”。前提：本机需已安装 Node.js（用于 npx）与 Python 3.10+，查看产出需现代浏览器；正常生成不需要 API Key 或账号。
11. 注意事项
- 仓库创建仅 5 天，长期维护节奏与社区参与度尚待观察，当前提交与合并 PR 均来自作者本人。
- 运行需本机同时具备 Node.js 与 Python 3.10+，并非零依赖的纯提示词技能。
- 默认拒绝覆盖已有输出文件，需显式传入
--overwrite，初次遇“output exists”报错属预期行为。 - 使用外链图片或视频会破坏“完全离线可分发”的卖点，建议改用内嵌资源。
- 不支持导出
.pptx，仅产出单文件 HTML；需要 Office 格式应改用其他技能。