前言¶
数据分析做完之后，汇报材料往往还要再排一版 PPT：版式、字体、配色若和网页报告不一致，改起来费时，也容易和前面的分析结论对不上。若你已经在 byteplan 体系里用 byteplan-analysis 产出分析结果，并习惯 byteplan-html 那套渐变背景、卡片式布局和大字号展示，那么把同一套视觉语言延伸到 PPT，会比从零搭模板更省事。
下面介绍 SkillHub 社区 Skill byteplan-ppt（坐标 @user_801e2aaa/byteplan-ppt，当前资料记载版本 1.0.3）：在已有分析数据之上生成 PPT 报告，并声明与 byteplan-html 风格一致。
这是什么¶
byteplan-ppt 是发布者 user_801e2aaa 在 SkillHub 上架的社区来源（community）Skill，分类为 office-efficiency（办公效率）。官方简介概括为：根据已有的分析数据生成 PPT 报告；PPT 风格与 byteplan-html 完全一致，包括渐变背景、卡片式设计、大字体展示；使用微软雅黑字体。
标签 requires_api_key=false，表示按 SkillHub 页面标注，不依赖额外 API Key。它不能替代数据分析本身：需要先使用 byteplan-analysis skill 完成数据分析，再在此基础上生成 PPT。
核心功能¶
结合 SkillHub 页面与抓取元数据，可核实的能力如下：
- 输入前提：依赖 byteplan-analysis 产出的分析数据，而不是从零写稿或重新跑数。
- 输出形态：生成 PPT 格式的报告，用于演示与汇报。
- 视觉规范：与 byteplan-html 对齐——渐变背景、卡片式设计、大字体；字体为微软雅黑。
- 部署成本：
requires_api_key=false，无需在 Skill 层配置 API Key（具体分析链路是否另有数据源要求，以 byteplan-analysis 及你本地数据为准）。
SkillHub 统计（以抓取资料为准）：评分 100000，下载 1868 次，安装 183 次。SkillHub 技能页当前展示版本为 v1.0.2，与 API 元数据中的 1.0.3 可能存在发布滞后，安装后以本地 skillhub 拉取结果为准。
安装与启用¶
Skill 基于通用 SKILL.md 格式，可通过 SkillHub 官方安装说明安装到当前 Agent 的 skills 目录。
方式一：让 AI 按官方文档安装¶
将下面提示词发给支持 Skill 安装的 AI 客户端（Cursor、Claude Code、Codex 等，以你环境是否支持 Skill 为准）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_801e2aaa/byteplan-ppt`。
方式二：SkillHub CLI¶
先确认是否已安装 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（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
安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认会装到 ./skills/，可能不会被客户端识别。文档给出的常见路径示例：
| 客户端 | skills 目录（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装命令形式如下（将 <skills 目录> 换成你环境中的实际路径）：
skillhub install @user_801e2aaa/byteplan-ppt --dir <skills 目录>
也可先搜索再安装：
skillhub search byteplan-ppt
安装完成后，按你所用客户端的要求刷新或重启 Agent，使新 Skill 生效。
典型用法¶
公开资料未提供逐步截图或固定文件名约定，可复现的流程只能写到官方已声明的依赖关系：
- 安装并启用 byteplan-analysis，对目标数据完成分析，得到该 Skill 约定的分析结果（具体字段与产物路径以 byteplan-analysis 的 SKILL.md 为准）。
- 安装 byteplan-ppt 到当前 Agent 的 skills 目录。
- 在同一工作流中向 Agent 说明：在现有分析数据基础上生成 PPT 报告，并保持与 byteplan-html 一致的风格（渐变背景、卡片式、大字号、微软雅黑）。
若你同时使用 byteplan-html 生成网页报告，可将 HTML 版作为视觉对照，检查 PPT 是否与之一致。
适用场景与注意¶
适合谁
- 已在 byteplan 系列中用 byteplan-analysis 做数据分析，需要把结论做成演示稿的团队或个人。
- 希望 PPT 与 byteplan-html 网页报告视觉统一，减少二次排版。
限制与注意
- 前置 Skill 必选：未先完成 byteplan-analysis，本 Skill 无法凭空生成有依据的报告。
- 风格绑定：版式跟随 byteplan 系列约定，不适合需要完全自定义企业模板、或必须与现有
.pptx母版像素级一致的场景。 - 字体环境：说明中指定微软雅黑；在非 Windows 或缺少该字体的环境，渲染可能回退到系统字体，观感会与设计预期有差异。
- 版本信息：SkillHub 页面与 API 元数据的版本号可能不一致，升级时用
skillhub查询本地已安装版本。 - 来源属性：社区来源 Skill，使用前可在 SkillHub 查看评分、下载量，并结合自己的数据敏感度评估是否用于生产环境。
结尾¶
byteplan-ppt 的定位很直接：在 byteplan-analysis 的分析结果上，输出与 byteplan-html 同风格的 PPT，减少「分析一套、汇报又一套」的重复劳动。安装与坐标以 SkillHub 为准。
- SkillHub 技能页：https://www.skillhub.cn/skills/user_801e2aaa/byteplan-ppt
- API 坐标页：https://api.skillhub.cn/user_801e2aaa/byteplan-ppt
- 安装说明：https://skillhub.cn/install/skillhub.md
