前言¶
數據分析做完之後，彙報材料往往還要再排一版 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
