Turn reports into PowerPoint decks without the AI-slop look. An agent skill purpose-built for the Antigravity + Kiro + Codex pipeline — GPT-image renders dense Traditional Chinese slide text far better than Gemini.
See the codeSee what people are saying
README
agy-ppt
沒有 AI 味的報告。
內容有根據，呈現像人做的，而且真的講得動。
語言： 繁體中文 | English
agy-ppt 是為 Antigravity＋Kiro＋Codex 這條 pipeline 打造的簡報 skill：Antigravity 擔任導演，負責大綱、設計方向、內容與品質把關；Kiro 負責所有工程；Codex（GPT 圖片模型）負責把每一頁算成圖，最後組裝成含講稿的 .pptx。
為什麼算圖不用 Gemini？實測發現：Gemini 生成圖片時能承載的繁體中文很少，字一多就糊掉、亂寫；同樣的版面，GPT 撐得住幾十個中文字。簡報正好是文字密度最高的場景，這個分工是被現實逼出來的，不是偏好。
成品是混合式 PowerPoint：以圖片保留視覺細節，並在適合時保留可編輯文字、原生圖表與可替換圖片。
使用需求：需要可載入 skill、且具備圖片生成能力的 agent 環境（本專案以 Codex 內建圖片生成實作與測試）。這是硬需求，沒有圖片生成的環境跑不起來。
Showcase
| Dense Executive | Balanced Executive |
|---|---|
 |  |
| 高密度敘事、結構化資訊卡、原生圖表與不同用途的可替換影像。 | 清楚層級、中度視覺密度與可編輯 PowerPoint 元件。 |
兩種風格都保留可編輯文字、適用時的原生圖表，以及可替換圖片；並非只有單一版型。瀏覽可重現範例以查看四張投影片預覽、prompt、大綱、風格設定與素材來源。
安裝
需求：Python 3.11+、Git，以及已登入並可使用圖片生成工具的 agent 環境。
git clone https://github.com/sujunmin/agy-ppt.git
cd agy-ppt
python3 skills/agy-ppt/scripts/codex_ppt_runtime.py bootstrap
mkdir -p ~/.gemini/config/skills
rsync -a --delete ./skills/agy-ppt/ ~/.gemini/config/skills/agy-ppt/
bootstrap 只建立共用 runtime 並安裝執行所需依賴；它不會執行測試、OCR qualification 或產生範例簡報。其他 agent 可把 skills/agy-ppt/ 放到其支援的 workspace skill 位置。
基本使用
載入 agy-ppt skill 後，向 AGY 說明主題、受眾、頁數與來源，例如：
請把這份報告做成 10 頁的繁體中文簡報，對象是部門主管。
預設互動流程會逐步請你確認：
- 確認大綱
- 確認視覺風格
- 檢視一張真實樣張
- 核准後產生完整簡報
修改大綱或風格會使相依的樣張核准失效；在三個核准完成前，不會產生整套簡報。
視覺風格可明確選用高密度、卡片化與圖像豐富的版面；這是 opt-in 偏好，預設仍維持平衡密度，且不會用重複圖片、空泛卡片或未受來源支持的文字來湊數。
運作方式
使用者需求 / 來源
→ 大綱核准
→ 風格核准
→ 單張樣張核准
→ 完整簡報
含 OCR 的來源會先建立可追溯證據，再交回 AGY 判斷：
PDF / 圖片 → 擷取 / OCR 證據 → 來源接地 → AGY
AGY 始終是唯一的 orchestrator 與語意判斷者；OCR 與圖片 worker 不會自行改寫內容或跳過核准階段。
支援的輸入
- Markdown、純文字、DOCX、靜態 HTML 與既有來源系統支援的公開遠端內容
- 可搜尋、掃描及混合型 PDF
- PNG、JPEG、單幀 TIFF
多幀 TIFF 會被明確拒絕。OCR 準確度取決於來源品質、provider 與模型。
文件
- 簡報核准流程
- Phase 16：有根據的簡報規劃與人類編輯品質
- Phase 17：簡報策略智能與實際呈現品質
- Phase 18：交付真實度、可攜性與智慧編輯能力
- 架構與角色分工
- 來源取得、擷取與接地
- OCR 架構與 providers
- 安全、CI 與開發測試
- 故障恢復
- 變更紀錄
開發者的完整測試與 release qualification 指令位於上述 CI／測試文件，不屬於一般使用者安裝流程。
參與貢獻
歡迎錯誤修正、文件、測試、簡報品質與版面改善、PowerPoint 相容性修正及新功能。小而聚焦的 PR 可直接提出；若會改變產品流程、AGY 語意權限、凍結契約或主要架構，請先開 issue／discussion。視覺變更必須檢查實際 render，單元測試通過本身不代表簡報品質已合格。詳見 貢獻指南。
專案狀態與授權
Phase 15 OCR 與來源接地管線、Phase 16 有根據的簡報與編輯品質、Phase 17 簡報策略與實際呈現品質，以及 Phase 18 交付真實度、可攜性與智慧編輯能力 baseline 均已完成並凍結。採用原生文字、形狀、圖表與圖片物件的混合式 PowerPoint 輸出，在確保佐證事實不可竄改與已核准視覺品質的前提下，提供業務關鍵欄位可編輯性與圖片替換能力；不宣稱 100% 全原生編輯、跨客戶端無縫相容或字型普遍可攜。Linux x86_64 是主要 production target，但正式部署仍需驗證 hard isolation；macOS 僅供開發/API 驗證，Windows 尚未通過 production-security qualification。OCR JSON schemas 仍為 deferred。
本專案採 MIT License，衍生自 ningzimu/codex-ppt-skill，並非 upstream 官方版本。第三方授權資料見 THIRD_PARTY_NOTICES.md。
Similar repos
Turn reports into PowerPoint decks without the AI-slop look. An agent skill purpose-built for the Antigravity + Kiro + Codex pipeline — GPT-image renders dense Traditional Chinese slide text far better than Gemini.
See the codeSee what people are saying
README
agy-ppt
沒有 AI 味的報告。
內容有根據，呈現像人做的，而且真的講得動。
語言： 繁體中文 | English
agy-ppt 是為 Antigravity＋Kiro＋Codex 這條 pipeline 打造的簡報 skill：Antigravity 擔任導演，負責大綱、設計方向、內容與品質把關；Kiro 負責所有工程；Codex（GPT 圖片模型）負責把每一頁算成圖，最後組裝成含講稿的 .pptx。
為什麼算圖不用 Gemini？實測發現：Gemini 生成圖片時能承載的繁體中文很少，字一多就糊掉、亂寫；同樣的版面，GPT 撐得住幾十個中文字。簡報正好是文字密度最高的場景，這個分工是被現實逼出來的，不是偏好。
成品是混合式 PowerPoint：以圖片保留視覺細節，並在適合時保留可編輯文字、原生圖表與可替換圖片。
使用需求：需要可載入 skill、且具備圖片生成能力的 agent 環境（本專案以 Codex 內建圖片生成實作與測試）。這是硬需求，沒有圖片生成的環境跑不起來。
Showcase
| Dense Executive | Balanced Executive |
|---|---|
| |
| 高密度敘事、結構化資訊卡、原生圖表與不同用途的可替換影像。 | 清楚層級、中度視覺密度與可編輯 PowerPoint 元件。 |
兩種風格都保留可編輯文字、適用時的原生圖表，以及可替換圖片；並非只有單一版型。瀏覽可重現範例以查看四張投影片預覽、prompt、大綱、風格設定與素材來源。
安裝
需求：Python 3.11+、Git，以及已登入並可使用圖片生成工具的 agent 環境。
git clone https://github.com/sujunmin/agy-ppt.git
cd agy-ppt
python3 skills/agy-ppt/scripts/codex_ppt_runtime.py bootstrap
mkdir -p ~/.gemini/config/skills
rsync -a --delete ./skills/agy-ppt/ ~/.gemini/config/skills/agy-ppt/
bootstrap 只建立共用 runtime 並安裝執行所需依賴；它不會執行測試、OCR qualification 或產生範例簡報。其他 agent 可把 skills/agy-ppt/ 放到其支援的 workspace skill 位置。
基本使用
載入 agy-ppt skill 後，向 AGY 說明主題、受眾、頁數與來源，例如：
請把這份報告做成 10 頁的繁體中文簡報，對象是部門主管。
預設互動流程會逐步請你確認：
- 確認大綱
- 確認視覺風格
- 檢視一張真實樣張
- 核准後產生完整簡報
修改大綱或風格會使相依的樣張核准失效；在三個核准完成前，不會產生整套簡報。
視覺風格可明確選用高密度、卡片化與圖像豐富的版面；這是 opt-in 偏好，預設仍維持平衡密度，且不會用重複圖片、空泛卡片或未受來源支持的文字來湊數。
運作方式
使用者需求 / 來源
→ 大綱核准
→ 風格核准
→ 單張樣張核准
→ 完整簡報
含 OCR 的來源會先建立可追溯證據，再交回 AGY 判斷：
PDF / 圖片 → 擷取 / OCR 證據 → 來源接地 → AGY
AGY 始終是唯一的 orchestrator 與語意判斷者；OCR 與圖片 worker 不會自行改寫內容或跳過核准階段。
支援的輸入
- Markdown、純文字、DOCX、靜態 HTML 與既有來源系統支援的公開遠端內容
- 可搜尋、掃描及混合型 PDF
- PNG、JPEG、單幀 TIFF
多幀 TIFF 會被明確拒絕。OCR 準確度取決於來源品質、provider 與模型。
文件
- 簡報核准流程
- Phase 16：有根據的簡報規劃與人類編輯品質
- Phase 17：簡報策略智能與實際呈現品質
- Phase 18：交付真實度、可攜性與智慧編輯能力
- 架構與角色分工
- 來源取得、擷取與接地
- OCR 架構與 providers
- 安全、CI 與開發測試
- 故障恢復
- 變更紀錄
開發者的完整測試與 release qualification 指令位於上述 CI／測試文件，不屬於一般使用者安裝流程。
參與貢獻
歡迎錯誤修正、文件、測試、簡報品質與版面改善、PowerPoint 相容性修正及新功能。小而聚焦的 PR 可直接提出；若會改變產品流程、AGY 語意權限、凍結契約或主要架構，請先開 issue／discussion。視覺變更必須檢查實際 render，單元測試通過本身不代表簡報品質已合格。詳見 貢獻指南。
專案狀態與授權
Phase 15 OCR 與來源接地管線、Phase 16 有根據的簡報與編輯品質、Phase 17 簡報策略與實際呈現品質，以及 Phase 18 交付真實度、可攜性與智慧編輯能力 baseline 均已完成並凍結。採用原生文字、形狀、圖表與圖片物件的混合式 PowerPoint 輸出，在確保佐證事實不可竄改與已核准視覺品質的前提下，提供業務關鍵欄位可編輯性與圖片替換能力；不宣稱 100% 全原生編輯、跨客戶端無縫相容或字型普遍可攜。Linux x86_64 是主要 production target，但正式部署仍需驗證 hard isolation；macOS 僅供開發/API 驗證，Windows 尚未通過 production-security qualification。OCR JSON schemas 仍為 deferred。
本專案採 MIT License，衍生自 ningzimu/codex-ppt-skill，並非 upstream 官方版本。第三方授權資料見 THIRD_PARTY_NOTICES.md。