diff --git a/CHANGELOG.md b/CHANGELOG.md index 28768de..4e71e10 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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 開關、常見的坑。 diff --git a/README.md b/README.md index 567ee6e..0774744 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,8 @@ **跟 AI 說一句「做一份 HTML 簡報」，拿到能離線播、QR 驗過、還附講義 PPTX／PDF 的成品。** reveal.js 簡報製作流程，包成兩個 Agent Skill。
-Claude Code・Codex CLI・Gemini CLI・Grok Build 都能裝。 +Claude Code・Codex CLI・Gemini CLI・Grok Build 都能裝。
+安裝後的 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) @@ -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） diff --git a/docs/html-slides-tips-from-x-2026-10-17.md b/docs/html-slides-tips-from-x-2026-10-17.md index f95e9e1..c237157 100644 --- a/docs/html-slides-tips-from-x-2026-10-17.md +++ b/docs/html-slides-tips-from-x-2026-10-17.md @@ -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」 - 課程簡報不得刪頁，只能同數或增加 - 醫療內容避免絕對療效宣稱；解剖名詞、左右側、縮寫自我檢查，存疑標（待確認） diff --git a/skills/html-slide-deck/SKILL.md b/skills/html-slide-deck/SKILL.md index 3fa29f7..d133d0f 100644 --- a/skills/html-slide-deck/SKILL.md +++ b/skills/html-slide-deck/SKILL.md @@ -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. 先問三件事（一次問完） diff --git a/skills/html-slide-deck/references/fixed-rules.md b/skills/html-slide-deck/references/fixed-rules.md new file mode 100644 index 0000000..17cd912 --- /dev/null +++ b/skills/html-slide-deck/references/fixed-rules.md @@ -0,0 +1,8 @@ +# Keanu 的固定規則 + +製作或修改簡報時一律遵守（來源：repo `docs/html-slides-tips-from-x-2026-10-17.md`，兩個 skill 各附一份相同內容）。 + +- 社群輪播圖頁尾：「運動醫學科 吳易澄醫師製作 sportsmedicine.tw」 +- 課程簡報不得刪頁，只能同數或增加 +- 醫療內容避免絕對療效宣稱；解剖名詞、左右側、縮寫自我檢查，存疑標（待確認） +- 文獻預設引用近五年並標年份 diff --git a/skills/html-slide-effects/SKILL.md b/skills/html-slide-effects/SKILL.md index b446154..ee49067 100644 --- a/skills/html-slide-effects/SKILL.md +++ b/skills/html-slide-effects/SKILL.md @@ -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 個關鍵時刻**：封面、章節轉折、核心概念圖、收尾。其他頁保持乾淨。 diff --git a/skills/html-slide-effects/references/fixed-rules.md b/skills/html-slide-effects/references/fixed-rules.md new file mode 100644 index 0000000..17cd912 --- /dev/null +++ b/skills/html-slide-effects/references/fixed-rules.md @@ -0,0 +1,8 @@ +# Keanu 的固定規則 + +製作或修改簡報時一律遵守（來源：repo `docs/html-slides-tips-from-x-2026-10-17.md`，兩個 skill 各附一份相同內容）。 + +- 社群輪播圖頁尾：「運動醫學科 吳易澄醫師製作 sportsmedicine.tw」 +- 課程簡報不得刪頁，只能同數或增加 +- 醫療內容避免絕對療效宣稱；解剖名詞、左右側、縮寫自我檢查，存疑標（待確認） +- 文獻預設引用近五年並標年份