Communitygithub.com

Aumnertic/scene-ppt

根據使用場景設計中文 PPT / 幻燈片 / 簡報:先確認場合、受眾與目的,再依場景選擇風格,用 HTML/SVG 渲染出有設計感的頁面並匯出 PNG 與 PDF。

scene-ppt 是什麼?

這是一個專門為中文用戶設計的 AI 代理技能,用於根據具體場景創建高質量的簡報(PPT)。它能自動判斷場合(如競賽路演、課程彙報等)、受眾與用途,並從四個預設風格分支中選擇最合適的設計:競賽路演(挑戰杯、互聯網+)、課程彙報、班會校園活動,以及強調個人風格的貝塞爾曲線極簡風。若無合適分支,還能派生新風格。此技能支援 macOS、Google Chrome 與 `uv`,透過本地 Chrome 渲染 HTML/SVG 頁面,最終輸出 PNG 與 PDF,但不支援可編輯的 PPTX 匯出。其核心在於要求開發者仔細檢查每一頁的呈現,避免「AI 感」的模板化;主要適用於 Claude Code、Cursor 或 Codex 等平台。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Aumnertic/scene-ppt/tree/HEAD

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

場景化 PPT 設計

這個 skill 提供兩樣東西:

  1. 範本參考:styles/<分支>/exemplar/ 和 samples/ 裡的成品樣板。
  2. 設計指導:guide/ 裡關於「怎麼組織、用什麼形狀」的說明。

核心原則:風格跟著場景和材料走,不寫死。 樣板用來定品質標竿、示範手法,不是讓你照著抄。新 deck 要按自己的內容重新構圖。照抄樣板的排版,或者讓每套 deck 長得都一樣,正是這個 skill 要避免的「AI 感」。

環境要求

  • macOS、Google Chrome、uv。渲染時呼叫本機 Chrome,不需要下載瀏覽器。
  • 字體都是 macOS 系統字體,不能隨 skill 打包。中文字體的粗細檔必須用 PostScript 名指定,例如 STSongti-SC-Black、FZLTTHK--GBK1-0。只寫族名加 font-weight,會回落到常規體。

流程

00 場景判斷

先讀用戶給的材料,材料能回答的問題就不要再問。然後只問「答案會改變設計決定」的問題,一次最多問 3 到 4 個。有提問工具時用提問工具。

問題決定什麼
用在什麼場合?比如比賽路演、課程或學術彙報、班會或校園活動、工作彙報、其他選哪個風格分支
現場投屏講,還是發檔案讓別人自己看?講多久?資訊密度和頁數。投屏講:字大、字少,約 1 分鐘 1 頁。發檔案:資訊可以更密
想讓觀眾記住什麼、感覺到什麼?比如專業可信、有想法、溫暖有趣、熱血選分支裡的哪套主題
有沒有必須用的顏色、標誌或範本要求?比如校徽、班旗色、賽事要求主色變數

場景 → 分支和主題

場景分支主題怎麼選密度
挑戰杯、互聯網+、創業比賽、專案答辯roadshow-cn單主題;賽事偏商業時,金色調亮,再加科技青塞滿(七成以上)
課程期末彙報、讀書報告、小組研究展示course-report人文社科選 paper;理工、設計、數據選 swiss可以留白,字號反差要大
班會、期中期末回顧、運動會、社團、畢業school-event回憶、感謝選 handbook;比賽、動員選 pop可以留白,每頁有一個「實物」
需要凸顯設計感、個人風格:作品集講解、求職或保研面試的自我介紹、設計類分享、個人主題演講curve-minimal想要克制、理性、像設計稿,或者要發檔案、列印,選 pen(淺底);想要更有表現力、更有個人氣質,現場投屏講,選 ribbon(深底)極少,大量留白;每頁只有一處重點
都不合適新建主題或分支,見下文——

沒有合適的分支時,不要硬套最接近的那個。 按「氣質 → 字體 → 形狀語言 → 顏色」的順序派生一套新的 tokens.css。必需的變數和按需變數的劃分寫在 styles/roadshow-cn/tokens.css 開頭。字體先用 scripts/fontcheck.py 確認 Chrome 確實用上了。

主色優先從用戶材料裡取,比如學校標準色、班旗色、課題相關的顏色。

01 整理素材

列出用戶材料裡的照片、關鍵數字、原話引文、證書檔案。照片的多少會直接影響版式:照片少於 3 張時,不要做照片牆。目前這一步靠手工整理,還沒有腳本。

02 大綱

先定章節,再給每頁分配角色:封面、章節頁、內容頁、數據頁、結尾。各分支的典型頁型見 styles/<分支>/style.md。

03 每頁選形狀

每一頁先認出它的資訊關係(層級、順序、對比、排序、佔比、關鍵數字、並列、現場照片……),再到 guide/shapes.md 找對應的候選形狀,按選擇標準和當前分支挑一個。說不出「為什麼用這個形狀」,就是選錯了。裝飾最後加,按構圖作用挑(同一份文件第 4 節)。

04 渲染

  1. 參照所選分支 exemplar/deck.html 的檔案結構來寫,不要照搬它的構圖:
    • <head> 第一行放主題腳本 <script>{const t=new URLSearchParams(location.search).get('theme');if(t)document.documentElement.dataset.theme=t}</script>。漏掉它,render.py 傳了主題名也會靜默渲染成預設主題;
    • 然後依次引用 tokens.css、lib/base.css、分支的 components.css。roadshow-cn 是單主題分支,也沒有接入 lib/base.css,按它自己的樣板來寫;
    • 頁面末尾引用 lib/shapes.js;
    • 每頁一個 `<section class=

相關技能