Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@
## Unreleased

- 新增 `docs/html-slides-tips-from-x-2026-10-17.md`:整理自 X 使用者分享的 HTML 簡報流程原則、現成 Skill/工具與本專案固定規則(含來源連結);README 目錄樹補連結。
- 修正:固定規則原本只在 `docs/`,`install.sh` 不會安裝、skill 也沒引用。改為在兩個 skill 各附 `references/fixed-rules.md`(規則文字照抄),並在各自 `SKILL.md` 要求先讀並遵守;README 開頭簡介補上這兩點。

## 1.2.0 — 2026-09-30
- 新增 `docs/TECHNIQUES.md`:播放快捷鍵、換場設定、逐步出現/Auto-Animate/3D 翻卡/卡片牆飛入/GSAP 逐字/Three.js 粒子/Spotlight/計時條/lightbox/頁內測驗的可複製程式碼、STATIC 開關、常見的坑。
Expand Down
8 changes: 6 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,8 @@
**跟 AI 說一句「做一份 HTML 簡報」,拿到能離線播、QR 驗過、還附講義 PPTX/PDF 的成品。**

reveal.js 簡報製作流程,包成兩個 Agent Skill。<br>
Claude Code・Codex CLI・Gemini CLI・Grok Build 都能裝。
Claude Code・Codex CLI・Gemini CLI・Grok Build 都能裝。<br>
安裝後的 skill 內建作者的固定規則(`references/fixed-rules.md`);X 上分享的簡報技巧整理見 [docs/html-slides-tips-from-x-2026-10-17.md](docs/html-slides-tips-from-x-2026-10-17.md)。

[![CI](https://github.com/keanu77/htmlpptskill/actions/workflows/ci.yml/badge.svg)](https://github.com/keanu77/htmlpptskill/actions)
[![License: MIT](https://img.shields.io/badge/License-MIT-teal.svg)](LICENSE)
Expand Down Expand Up @@ -575,7 +576,10 @@ skills/
offline-build-template/ 做法 B:content.js+build.js+check.mjs+PLAN.md+角色檔
pptxgenjs-helpers.mjs 原生 PPTX 的 theme 與 helper(+ native-pptx-example.mjs)
pitfalls.md 踩過的雷與可複用片段
html-slide-effects/SKILL.md
fixed-rules.md Keanu 的固定規則(SKILL.md 要求遵守)
html-slide-effects/
SKILL.md
references/fixed-rules.md 同上一份固定規則
examples/
workshop-2026/content.js 50 頁工作坊完整內容
pptx-edits-back-to-html.py 講者在 PPTX 手改後回灌 HTML+全部效果的實例(見 examples/README.md)
Expand Down
2 changes: 2 additions & 0 deletions docs/html-slides-tips-from-x-2026-10-17.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,8 @@
- DeckFlow:PPTX 轉 HTML 簡報,輸出分頁 HTML 與素材,可再交給 Agent 修改。來源:https://x.com/DeckFlowHQ/status/2101962124063134205

## Keanu 的固定規則(套用到本專案)
> 已隨 skill 安裝:`skills/html-slide-deck/references/fixed-rules.md`、`skills/html-slide-effects/references/fixed-rules.md`;修改時三處一起改。

- 社群輪播圖頁尾:「運動醫學科 吳易澄醫師製作 sportsmedicine.tw」
- 課程簡報不得刪頁,只能同數或增加
- 醫療內容避免絕對療效宣稱;解剖名詞、左右側、縮寫自我檢查,存疑標(待確認)
Expand Down
1 change: 1 addition & 0 deletions skills/html-slide-deck/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@ description: 用 reveal.js 製作或修改 HTML 簡報(單檔、可離線、

`$SKILL` 代表本檔所在目錄(Claude Code:`~/.claude/skills/html-slide-deck`;Codex:`~/.codex/skills/…`;Gemini:`~/.gemini/skills/…`;Grok:`~/.grok/skills/…`)。腳本在 `$SKILL/scripts/`,範本在 `$SKILL/references/`。
腳本需要 Node 18+、`playwright`(+Chromium)、`pptxgenjs`、Python 3(`segno`、`pillow`、`python-pptx`);套件從**執行目錄往上**找 `node_modules`,找不到再找 npm 全域(可設 `SKILL_PKG_ROOT`)。依賴請使用者在終端機先裝好,不要在對話中代裝。
**固定規則**:開始前先讀 `$SKILL/references/fixed-rules.md`,全程遵守(頁尾署名、課程簡報不得刪頁、醫療用語與文獻引用)。

## 0. 先問三件事(一次問完)

Expand Down
8 changes: 8 additions & 0 deletions skills/html-slide-deck/references/fixed-rules.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# Keanu 的固定規則

製作或修改簡報時一律遵守(來源:repo `docs/html-slides-tips-from-x-2026-10-17.md`,兩個 skill 各附一份相同內容)。

- 社群輪播圖頁尾:「運動醫學科 吳易澄醫師製作 sportsmedicine.tw」
- 課程簡報不得刪頁,只能同數或增加
- 醫療內容避免絕對療效宣稱;解剖名詞、左右側、縮寫自我檢查,存疑標(待確認)
- 文獻預設引用近五年並標年份
2 changes: 2 additions & 0 deletions skills/html-slide-effects/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,8 @@ description: 為既有的 reveal.js HTML 簡報加入效果:逐步出現(fra

使用時機:使用者想讓 HTML 簡報更生動、更好講、更適合現場互動,或問「有什麼特效或技巧可以加」。簡報本體的製作流程(版型、圖片、QA、轉 PPTX)在 `html-slide-deck`;本 skill 只管加在其上的效果。加完效果一律回頭跑 `html-slide-deck` 的 `qa-screenshots.mjs`。

**固定規則**:開始前先讀本 skill 目錄下的 `references/fixed-rules.md`,全程遵守(加效果也不得刪頁)。

## 使用原則(先讀)

1. **只放在 4~5 個關鍵時刻**:封面、章節轉折、核心概念圖、收尾。其他頁保持乾淨。
Expand Down
8 changes: 8 additions & 0 deletions skills/html-slide-effects/references/fixed-rules.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# Keanu 的固定規則

製作或修改簡報時一律遵守(來源:repo `docs/html-slides-tips-from-x-2026-10-17.md`,兩個 skill 各附一份相同內容)。

- 社群輪播圖頁尾:「運動醫學科 吳易澄醫師製作 sportsmedicine.tw」
- 課程簡報不得刪頁,只能同數或增加
- 醫療內容避免絕對療效宣稱;解剖名詞、左右側、縮寫自我檢查,存疑標(待確認)
- 文獻預設引用近五年並標年份
Loading