Skill intro / 功能概览
frontend-slides
editable
把发现式选风格、可编辑 runtime 与单文件交付绑在一起。A single workflow for style discovery, in-browser editing, and portable HTML delivery.
19 presets`STYLE_PRESETS.md` 现有 19 套风格规格,含 7 套扩展画廊。
Full editorDrag, resize, Ctrl+click, Pages, Undo / Redo 都内建。
Zero buildInline CSS + JS,`Ctrl+S` 保存结构,`Export HTML` 清理导出。
01 / What it is
它不是另一个模板库,而是一套生成后还能继续改的 deck workflow
README 把它定义为 frontend-slides 的 editable fork:保留 style discovery、viewport discipline 与 PPT conversion,再加上完整浏览器编辑层。The point is not “more themes”; it is “generate, then keep refining.”
Fork保留父 skill 的骨架延续 discovery、PPT 路径和视口规则,而不是另起炉灶。Same workflow spine, new runtime layer.
Runtime把编辑权留在浏览器Move, resize, rich text, add element, Pages, save/export 都在文件里。The deck stays modifiable after generation.
Preset预设仍按规格实现Edit mode 不是把所有风格压成同一种标题页。Preset identity stays intact.
Delivery单文件既能交付也能迭代可以直接发给别人,也能在浏览器里继续修最后一轮。Portable output, editable draft.
02 / Discovery gate
生成之前,先问对问题
`SKILL.md` 的 hard rule 很明确:brief 不完整时,只补问缺失项,不能擅自猜页数、outline、preset 或语言。Phase 1 completes before Phase 2; Phase 2 completes before generation.
01问清用途与篇幅Pitch / teaching / internal? 5–10、10–20 还是 20+?
02锁定内容来源README、SKILL,还是指定某几节;内容范围不能只给主题。
03确认风格与编辑范围先定 style direction,再确认要完整 editable runtime 还是父 skill。
04图片与语言独立确认Images: no / yes / unsure;语言可选 monolingual 或 bilingual。
Don’t guess / 不要猜 brief如果第一轮信息不完整,下一条消息只追问缺失项。Discovery is a gate, not a courtesy.
PurposeLengthLocaleImages
03 / Style discovery
Show, don’t tell
Phase 2 不是抽象问卷,而是根据风格偏好先推荐 2–4 个 preset,再让用户直选、看 3 张预览或混合方向。The preview step is part of the workflow, not just a flourish.
Recommend先给强匹配 preset`Clean / Professional` 常从 Swiss Modern、Electric Studio、Bold Signal 开始。
Direct pick知道 preset 就直接锁定用户若已给出 preset 名称,可直接进入 Phase 3。
Preview不确定就给 3 张 HTMLSingle-slide previews 比抽象形容词更快缩小审美范围。
Current deck / 本稿我们选择了 Swiss Modern:它更适合双语信息和产品规格感叙述。
Swiss ModernElectric StudioBold Signal
04 / Phase 3
代码生成之前,要先把“行为来源”和“视觉来源”分清
参考文件给的是 runtime 行为;preset spec 给的是布局与签名元素。The editable reference is not a frozen layout template.
STYLE_PRESETS风格身份Layout prose、signature elements、字体与颜色都在这里。
editor-runtime契约与交互DOM contract、snap rules、history types、generator checklist。
Reference HTMLruntime 来源Chrome、sidebar、persistence、export 逻辑从参考实现复制或改写。
Viewport base视口安全底座`100vh / 100dvh`、`clamp()`、breakpoints、reduced motion 必须完整带上。
Merge order / 合成顺序先贴 `viewport-base.css`,再放 preset tokens,再映射 `--deck-chrome-*`,最后接 runtime CSS/JS。Behavior and identity are merged, not substituted.
05 / Edit runtime
交付后的 deck 仍然像一个小型编辑器
这也是它比父 skill 更重的原因:文件里不仅有内容,还有完整编辑机制。The deck itself becomes the editing environment.
Objects拖拽、缩放、多选用 ⠿ 拖动对象,角点或边缘缩放,`Ctrl+click` 多选。
TextB / I + Font / Scale / Px富文本工具栏支持字体族、相对字号、固定 px 与选区保留。
Pages缩略图导航与重排Pages 侧栏负责 thumbnails、drag reorder 与 delete slide。
Add + ship插入媒体,保存,再导出`Add element` 可加 Text / Image / Video;`Ctrl+S` 保存,`Export HTML` 交付。
Key controls / 常用键
ECtrl+clickCtrl+ZCtrl+SExport HTML
06 / DOM contract
能改得稳,靠的是 runtime contract,而不是侥幸
运行时可以帮你修复一些 control,但不会替你发明结构。Stable persistence depends on stable DOM markers.
Slide root每页都要有稳定 id`section.slide#slide-N` 是保存、导航与排序的锚点。
Edit layer可移动内容住在这里`.slide-edit-layer` 包住所有可选、可拖、可缩放的内容块。
Object id`data-oid` 要全局唯一Selection、history 与 persistence 都靠它追踪对象。
Query scope只枚举真实 deck slides不能把 filmstrip clones 算进导航和排序逻辑。
Persistence / 持久化`Ctrl+S` 保存的是整棵 `.slides-offset` 结构,不只是文本内容。That is why DOM stability matters.
07 / Preset fidelity
可编辑 runtime 是附加层,不是风格压平器
`editable-deck-reference.html` 给的是 JS/CSS runtime patterns,不是通用 slide 布局;`examples/generated/presets/*.html` 也只是 smoke tests。A preset is a spec, not a palette swap.
19 specs`STYLE_PRESETS.md` 现有 19 套 curated presets。
7 gallery扩展画廊七套均已写入规格并接入构建。
1 rule不要复用一个 generic title-slide geometry 去假装多风格。
Spec先读 layout prose每个 preset 都有独立布局和 signature elements,要照规格实现。
Chrome静态装饰可在 edit layer 外Movable copy 在 `[data-slide-object]` 内;static chrome 可独立实现。
Swiss Modern here / 本稿为何像 Swiss Modern可见网格、红色竖条、非对称信息区块和几何面块都来自 preset identity,而不是运行时默认样式。The editor sits on top; it does not flatten the preset.
08 / Viewport rules
没有页内滚动;放不下,就拆页
这不是审美偏好,而是 non-negotiable invariant。If content exceeds density limits, split the slide instead of hiding overflow.
100vh每页锁定视口高度`.slide` 必须有 `height: 100vh; height: 100dvh; overflow: hidden;`。
clamp()字号与间距全部自适应标题、正文、padding、gap 都要用 viewport-safe `clamp()`。
Density每类 slide 都有限额标题页、内容页、feature grid、quote slide 都有内容上限。
Breakpoints700 / 600 / 500 都要考虑同时还要支持 `prefers-reduced-motion`,保证低风险播放。
Respect the viewport / 拆页,不挤页
1 heading4–6 bullets6 cards maxNo in-slide scroll
09 / When to choose it
适合那些“生成不是终点”的演示稿
当你预期 deck 还会经历评审、反馈、或 PPT-to-web 改稿时,它比 read-only parent 更合适。Use it when “generated” is a draft, not the finish line.
Review loops评审后还会继续修布局适合团队 review、客户反馈和多轮改稿。
PPT to web转网页后仍能继续编辑提取出文字、图片和备注后,还能继续收拢版式与内容。
Zero build单文件 handoff 更轻松不用 npm、不靠框架,几年后打开仍然能跑。
Command从这里开始使用 /frontend-slides-editable,成组回答 discovery,再选 preset。
Edit after generate / 生成后继续改按 E 进入编辑,打开 Pages 管页面,用 Ctrl+S 保存结构,再用 Export HTML 导出干净成品。That is the core promise of this skill.