LearnPrompt/humanize-ppt
AST-based outline director for human-centered AI presentation workflows.
Humanize PPT – AI驅動的「可講」簡報投影片
是什麼 – Humanize PPT 是一個小型基於 Python 的編排層，將原始素材（Markdown、筆記、資料）轉換為 可簡報 的投影片文稿。它本身不渲染視覺設計；而是決定 故事的流動（即「AST」——觀眾狀態轉移大綱），判斷哪些頁面需要圖片、SVG 圖表或短影片，並將這些決策交給下游渲染技能（HTML 簡報產生器、原生 PowerPoint 匯出器、Remotion 影片製作者等）。渲染完成後，它會執行自動 簡報檢查，標記出「好看但無法講解」的投影片（例如，被徽章遮蓋的文字、缺少講者筆記），並產生修復提示供渲染器使用。
核心理念
| 概念 | Humanize PPT 的作用 |
|---|---|
| AST 大綱 | 解析來源素材，產生 JSON 計畫（slide_plan.json），記錄每頁投影片的觀眾初始狀態、目標狀態及投影片意圖。 |
| 視覺增強 | 為每頁投影片判斷是否需要圖片、決定性 SVG 圖表或 Remotion 影片，並將請求（提示詞 + 目標路徑）寫入計畫。實際資產由插件技能如 baoyu-image-gen（本地 Codex CLI）或 remotion-video-production 產生。 |
| 風格畫廊 | 在大綱確定前，可讓渲染器產生 ≥4 個封面頁候選，讓使用者在不承諾完整文稿的前提下選擇視覺風格。 |
| 簡報檢查 | 下游渲染器完成後，Humanize PPT 掃描輸出結果，與 AST 計畫對比，自動報告「失敗」投影片（如文字溢出、徽章遮蓋文字、缺少講者筆記）。它會產生 fix_prompt.md，可回饋給渲染器進行第二次執行（最多 3 次迭代）。 |
| 簡報模式 | 產生一個輕量級 HTML 講者外殼（presenter-shell.html），顯示當前投影片、計時器、講者筆記、下一頁預覽和投影片地圖，讓你在最終文稿渲染前即可進行排練。 |
如何融入 AI 代理工作流程
- 作為技能安裝 – 像 Claude‑Code、Codex 或 Hermes 這樣的代理可透過一行命令添加該技能（
npx skills add LearnPrompt/humanize-ppt）。 - 向代理發出指令 – 「使用 Humanize PPT 將此 Markdown 轉為中文 PPT，然後用
guizang-ppt-skill原生渲染，用baoyu-image-gen配圖，用 Remotion 製作影片。」 - Humanize PPT 執行 – 它建立 AST 計畫，產生簡要說明（
guizang-production-prompt.md、ppt-master-production-prompt.md等），並交給選定的渲染器。 - 渲染器產生文稿 – 產生 HTML 簡報集、原生
.pptx檔案或一組 MP4 影片。 - 自動 QA – Humanize PPT 讀取渲染檔案，執行三輪檢查，返回簡潔報告（
qa_report.md）和任何修復提示。 - 迭代或簡報 – 可將修復提示回饋給渲染器，或直接跳轉到講者外殼進行排練。
主要組件（如倉儲所述）
scripts/humanize_ppt.py– CLI 進入點。接收來源 Markdown、輸出資料夾、標題、渲染器選擇、風格標誌等。slide_plan.json– 機器可讀的計畫，列出每頁投影片、其 AST 狀態、媒體槽位和任何風格選擇。presenter-shell.html– 與任何渲染文稿相容的輕量級 HTML 講者外殼；顯示投影片、計時器、講者筆記和導航。qa_report.md/fix_prompt.md– 人類可讀的診斷資訊和向下游渲染器提出修復問題的精確提示。
下游技能生態系（倉儲列為完整流程所需）
| 技能 | 渲染內容 | 倉儲 |
|---|---|---|
guizang-ppt-skill |
中文原生 PPT（雜誌 / 瑞士風格） | https://github.com/op7418/guizang-ppt-skill |
frontend-slides |
英文 HTML 簡報文稿（視口安全） | https://github.com/zarazhangrui/frontend-slides |
beautiful-html-templates |
英文多模板 HTML 文稿 | https://github.com/zarazhangrui/beautiful-html-templates |
ppt-master |
完全可編輯的 .pptx（DrawingML、筆記、過渡效果） |
https://github.com/hugohe3/ppt-master |
remotion-video-production |
每頁說明性 MP4 影片 | (Remotion 生態系統) |
baoyu-image-gen |
本地 Codex‑CLI 圖像生成（無需 API 金鑰） | https://github.com/JimLiu/baoyu-skills/tree/main/skills/baoyu-image-gen |
快速入門範例（來自 README）
# 為代理安裝技能
npx skills add LearnPrompt/humanize-ppt -g
# 向代理發出一條指令完成整個流程
"用 humanize-ppt 把这份材料做成中文演讲 PPT：先出 AST 大纲和每页意图，
按大纲调 guizang-ppt-skill 原生渲染，配图用 baoyu-image-gen、视频用 remotion，
渲染完跑一遍演讲体检告诉我哪几页只能看不能讲，最后出演讲模式。"
代理將：
- 呼叫
humanize_ppt.py→ 產生guizang-production-prompt.md。 - 呼叫
guizang-ppt-skill→ 獲得精美的 HTML/PPTX 文稿。 - 執行
baoyu-image-gen和 Remotion 產生媒體資產。 - 執行 Humanize 的 QA 步驟 → 收到問題投影片清單。
- 可選地，使用產生的修復提示重新執行渲染器。
- 開啟
presenter-shell.html進行排練。
你將獲得
- AST 驅動的投影片計畫（
slide_plan.json）。 - 渲染器特定的簡要說明（
*-production-prompt.md）。 - 可選的風格畫廊 HTML（用於選擇封面風格）。
- 媒體資產（真實圖片、SVG 圖表、MP4 影片）放置在你指定的路徑中。
- QA 報告（
qa_report.md）：精準定位「只能看不能講」的投影片。 - 可編輯的原生 PPTX（使用
ppt-master時）或可直接簡報的 HTML 文稿。 - 即用型排練講者外殼。
許可證
MIT – 可自由使用、修改，並整合到其他 AI 代理工具鏈中。
總結
Humanize PPT 不是視覺模板庫；它是讓 AI 生成的投影片文稿 可講 的 故事編排層。透過將 內容規劃（AST） 與 視覺渲染 分離，並提供自動「簡報健康檢查」，它讓 LLM 驅動的代理能產生既美觀又適合現場演講的文稿。
相關
- 專案
- 專案
- 專案
- 專案
- 專案