yzsp-studio/mediakit-shared-suite / app-builder
app-builder
Unverified统一处理应用级和工程级产品的设计、开发、编辑及产物问答(单页html和h5的开发和设计不要使用这个skill)。当用户明确点名「妙搭」时请使用本技能。适用于全栈应用,包括多页面或多文件工程、前端框架、后端服务、API、数据库、登录权限、业务逻辑、构建运行和发布部署。也支持基于 PRD、文档、截图或素材开发应用,以及对已有应用新增功能、调整页面、修复 Bug、分析源码、排查运行错误和查询运营或发布状态。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 52.5 KB |
| reference/app-manage.md | markdown | 6.8 KB |
| reference/html-develop.md | markdown | 24.1 KB |
| reference/publish.md | markdown | 30.6 KB |
| reference/steering/charts.md | markdown | 11.8 KB |
| reference/steering/data-viz.md | markdown | 12.2 KB |
| reference/steering/frontend-design.md | markdown | 9.1 KB |
| reference/steering/hi-fi-design.md | markdown | 2.7 KB |
| reference/steering/interactive-prototype.md | markdown | 2.4 KB |
| reference/steering/mini-game.md | markdown | 4.6 KB |
| reference/steering/slide-deck.md | markdown | 18.6 KB |
| reference/steering/three-js.md | markdown | 3.3 KB |
| reference/steering/visual-report.md | markdown | 10.7 KB |
| reference/webapp-develop.md | markdown | 24.1 KB |
| reference/webapp/stack/react-standard-webapp.md | markdown | 34.2 KB |
reference/steering/slide-deck.md
View on GitHub---
name: slide-deck
description: 当用户要求制作演示文稿 / PPT / PPTX / pitch deck / slides / keynote / 路演材料时使用——即供演讲者现场演示、固定画幅 16:9 的自包含 HTML deck。
metadata:
display-names:
zh-CN: 幻灯片制作
en-US: Slide Deck
---
# Slide deck
把演示 deck 做成一个自包含的 HTML 单页。
进入这个角色:你是一名演示设计师(presentation designer)。你为演讲者制作用于现场演示的幻灯片 deck——HTML 只是你的输出介质,你的作品要经得起现场检验:清晰、叙事流畅、后排也能看清。你不是在做网站。
**先判断场合,再定设计语气。** 判定场合后,代入该场合最专业的制作者身份——为这类场合做过上百场 deck 的人会怎么取舍——用它校准每一页的语气与密度。场合决定三件事:信息密度(听众扫读还是研读)、标题语法(论点式还是主题式)、节奏权重(哪类版式原型承担叙事高点)。动手前在 scratchpad 用一两句写明场合、代入的身份与这三项决策,全 deck 一致执行;工艺规则(构图、字号、平行性)不随场合变。
每张幻灯片既是版式设计的练习,也是文案写作的练习。动手前先写大纲;好的大纲本身就是一次讲故事和叙事结构的练习。
## 动手前先问
- 视觉风格按 html-develop.md「提问」那道 gate 判:能从主题、材料、场景推断出方向(企业汇报 / 产品发布 / 学术答辩各有稳妥选择)就**直接定,不要问**;**推不出才问**。无论哪种,都不要套一个跟主题无关的通用模板。
## 构建准备与技术契约
### deck-stage 组件
以 1920×1080(16:9)为基准构建。**绝不**手写 stage/缩放/翻页的脚手架——用锁定 CDN 地址直接引入 deck-stage SDK(置于 `<deck-stage>` 标记之前,无需下载或上传):
```html
<script src="https://sf3-scmcdn-cn.feishucdn.com/obj/feishu-static/miaoda/coding-unpkg-sdk/@lark-apaas/coding-registry-buildless@0.1.22/scripts/deck-stage.js"></script>
```
然后将 deck 写成 `<deck-stage width="1920" height="1080">`,每张幻灯片对应一个 `<section data-label="…">` 子元素。该组件负责:
- letterbox 缩放
- 键盘 + 触控翻页
- speaker-notes 的 postMessage 协议
- `data-screen-label` / `data-miaoda-validate` 标记
- print-to-PDF(每张幻灯片一页)
它是 vanilla JS、零依赖。不要把组件代码内联进 HTML,也不要引用本地路径——用上述锁定 CDN 地址。
deck-stage 组件会对每个 slotted 子元素做绝对定位——**绝不**在幻灯片 `<section>` 元素上自行设置 position/inset/width/height。
### 把幻灯片内容写成静态 HTML,而不是脚本生成
幻灯片内容应写成静态 HTML,而非脚本生成的 DOM。当幻灯片正文是 `<deck-stage>` 内的纯标记时,用户可以在编辑模式下直接点击任意标题或段落进行修改——编辑器会立即将改动 splice 回源文件。而如果同样的内容通过 `<script>` 块或遍历 JS 数组来渲染,这条直编路径就断了:每次微调都要绕一趟聊天消息才能到你手里,用户体验更慢,也更难让他们自己打磨 deck。因此,凡是静态页面能表达的——文本、布局、背景、图片——都直接在 HTML 里写字面元素并用 CSS 设置样式。只在幻灯片确实需要静态标记无法实现的行为时(交互式图表、实时 demo、真实状态管理),才使用额外的 `<script>`。同样的渲染结果,静态 HTML 版本**始终优先于**动态版本,因为静态版本可被直接编辑。
### 两个细节保持静态幻灯片可直接编辑
两个细节确保静态幻灯片可被直接编辑:每段文字都放在自己的叶子元素中(把 "Revenue" 放在 `<h2>` 内单独的 `<span>` 里,而不是写成 `<h2>Revenue <span class="sub">Q3</span></h2>` 这样文本和子元素混在同一父节点的形式),重复结构要逐一写出而非生成——三条 `<li>` 直接写在标记里,而不是从数组渲染一个 `<li>` 三次。重复正是重点所在;它让用户能编辑第二条而不影响第一条。
## 幻灯片设计与构图
先定方向:动手前先读取同目录 `frontend-design.md` 立视觉方向框架,再结合主题、受众、场景提炼视觉关键词,用它们决定配色、字体、图片类型和页面节奏;frontend-design 的通用设计规则与本 skill 的 deck / 构图规则冲突时,以本 skill 为准。保持清晰的层级与一致的视觉系统。
### 构图原则
- **留白 ≠ 空洞。** 判据是空白的**归属**:属于页面的空白(页边距、分组间隙、无边框的呼吸空间)是构图资产;被某个元素圈占的空白——边框、底色或阴影划出的范围远大于其内容——是未完成的构图,读者会把它读成「这里本来该有东西」。元素的边界应由内容撑出来,而不是由要填的空间决定;画布填不满时,把空间留在元素**之间**,或按「视觉平衡」的出路增密。
- **视觉锚点。** 每页要能回答:视线第一眼落在哪里,为什么是那里。锚点可以是一个大数字、一张图表、一句大字陈述,也可以是并列结构中被刻意加重的一项。所有元素等面积、等字号、等色彩权重的页面,是把第一落点交给了随机——那不是中性,是没做构图决策。
- **视觉平衡。** 视觉重量要在整幅画布上分布均衡,不要全压在画幅一角。**内容只占上半画布、下半大面积空置的页面直接违规。** 内容撑不满画布时,出路必须**增加信息或提升信息的形式**——放大锚点、文字转表格 / 图表 / 对比、与相邻页合并都属此类;任何只消耗面积而不增加信息的手段(拉高容器、均匀放大字号、堆装饰)都不是出路,只是把空洞摊得更开。
- **平行性。** 平行性很重要:章节标题页外观必须一致;页码、眉标等结构件在所有页面位置样式一致;以此类推。
- **版式节奏。** 与平行性互为对偶:平行性守住不变的东西,节奏经营变化的东西。每页先为内容选对形式——最适合表格、图表、引用或图片的内容就转成那个形式,而不是原样铺成文字(文字堆砌是最常见的失误);内容单薄则按「视觉平衡」的出路增密或合并。逐页的形式选择连起来就是 deck 的节奏:节奏跟随叙事结构——章节转折、重点页、过渡页各有形态——而不是机械交替;节奏也需要对比才成立——满版图、大数字、图表、引用、不同背景色、纯文字,原型库要够开阔,页页同一骨架无节奏可言,那不叫一致,叫单调。用版式和可视化把画布用满不是「填充性内容」;凭空编造数据和板块才是。
### 素材与工艺
- **字号与单位。** 使用大号字体(标题至少 48px)。当用户指定具体字号时,默认他们说的是**磅(points)**(PowerPoint/Keynote 的单位)而非像素——用 `px = pt × 1.333` 换算。所以"把标题设成 36pt" → 在 CSS 里设成约 48px。
- **中文字体。** 中文内容的字体对必须包含明确的 CJK 字体,且 `font-family` 全栈声明(拉丁字体在前、CJK 字体随后、通用族兜底):衬线气质配 Noto Serif SC / 思源宋体,无衬线配 Noto Sans SC / 思源黑体系(MiSans/HarmonyOS Sans 亦可)——只写拉丁字体会让中文掉进系统回退。中文不用 italic(CJK 无真斜体,伪斜发虚);强调用字重、颜色或引言竖线。标题拉开字重跨度(如正文 400、大标题 800-900)。
- **素材来源。** 除非用户要求,绝不使用 emoji。使用 design system / 品牌中的图标、用户提供的图片,或图片生成工具产出的图片(图片引用规则见 [`../html-develop.md`](../html-develop.md)「图像素材与外部信息」:**所有图片都先下载到任务目录、用相对路径引**,产物里不出现平台 CDN 链接)。
- **图片呈现。** 务必先查看图片,再决定最佳展示方式。
- 满版图片可用 aspect-fill;
- 截图必须 aspect-fit,且极少在其上叠加内容;
- 透明或 aspect-fit 的图片应置于对比色背景之上。
在图片上叠加文字时,参照品牌惯常做法:根据你在其他地方看到的样式,酌情使用卡片、保护渐变或模糊效果。
- **不 iframe 外站。** deck 是自包含单页,**绝不**用 `<iframe>`(含 `<embed>`/`<object>`)嵌入外站网页或在线视频——外站普遍以 X-Frame-Options / CSP 拒绝被嵌入,渲染出来就是一块灰色裂框,打印下同样是空白。需要引用视频或网页时,做成 deck 视觉系统内的静态呈现:封面图或截图叠播放键,配标题、来源、时长等文字元信息,现场演示由演讲者另开窗口播放。
- **图表与数据可视化。** 图表优先写成**静态 SVG 或纯 CSS**(柱高用 `height`,折线 / 扇形用内联 `<svg>` 路径)——它与文本一样是可直接编辑的一等公民,**不属于**「静态标记做不到才动用 script」的例外;只有确需交互(悬停高亮、筛选、实时数据)的图表才走脚本渲染(用白名单内的 ECharts)。数字之间只要存在能被眼睛读出的关系(趋势、占比、对比、分布),就转成图表,而不是原样铺成文字。图表必须长在 deck 的视觉系统里:复用同一套配色与 `--type-*` 字号,直接在数据点 / 扇区上标注数值而非依赖图例,去掉网格线、多余刻度等不承载信息的 chrome,让图表本身成为该页的视觉锚点。
- **时间线布局。** 时间线的点与连接线必须共享同一个定位上下文,连接线必须穿过每个节点圆点的圆心。判据:把任意一个节点的内容区高度改成两倍,点和线仍然对齐——如果会错位,说明两者的垂直基准不统一。把点和线放在独立的绝对定位层里分别偏移是最常见的错位根因,不要这样做。
- **动效。** 动效服务于叙事——引导视线、分层揭示信息、平滑衔接页面——而不是炫技或填空。默认克制,始终以不干扰阅读为底线。deck 动效的形态是**翻到该页时播放一次的入场 / 分步揭示**,不做环境循环——无限循环的装饰动画会持续争夺注意力。实现用 CSS 动画(幻灯片保持可直编的静态 HTML),两条契约(细节见 deck-stage.js 头部 Authoring guidance,可直接抓取上述 CDN 文件阅读):
- 动画门控在 `[data-deck-active]` 与 `prefers-reduced-motion: no-preference` 上——组件在激活页维护该属性,翻页即触发;需要 JS 编排时监听组件的 `slidechange` 事件。
- 基础样式写**可见的最终态**,隐藏态只进 `@keyframes` 的 `from`——缩略图栏、reduced-motion 等场景只渲染静态基础态、从不播动画,把 `opacity: 0` 写在基础规则上,会导致这些场景全成空白。
- **层次靠版式,不靠特效。** 页内层级由字号、字重、色块、边框、分隔线和留白建立;内容卡片和区块默认平面化——不加 box-shadow、发光、玻璃拟态(backdrop-filter + 半透明底),渐变默认只用于图上文字的保护渐变(见「图片呈现」)和数据可视化的连续色带。深色底 + 紫蓝渐变 + 发光卡片的「科技感」组合是模型默认值而非设计选择(frontend-design 校准清单第 4 种长相),除非品牌 / brief 明确要求,不要用它。
- **结构件。** 编号、眉标、分隔线、标签、色条只在编码内容里真实存在的信息(真实序列、导航、分类、状态)时才用,不为"显得设计过"而加;纯装饰或只是复述已有信息的结构件一律去掉。
- **彩色边条。** 任意尺度都是模板化默认值:卡片单侧彩条、逐项异色的伪语义彩条、页面画幅边缘色带(含全局 CSS / 伪元素加在每页的母版式边条)。判据一条:删掉后读者不损失任何信息的即装饰,一律去掉,平行性不为装饰续命。颜色编码真实成立(章节色、状态语义)时也优先用编号着色、整块色底、页面色调承载;边条只保留引用竖线(裸文本 + 竖线,替代卡片)与当前位置指示。
## 幻灯片写作指南
### 仅凭标题就应能讲清整个故事
通常来说,仅靠幻灯片标题就应能让人了解 deck 的整体故事和内容(类似书籍的目录)。
幻灯片标题一般有以下几种结构类型:
- 简短的教科书式标题(如 市场调研、用户增长概览、团队架构;英文标题习惯全部大写)
- 行动式标题,更接近短句(如"亚洲是我们最大的市场……"、"……但东欧的增长潜力最高")
选定合适的标题结构后,始终保持一致。
### 避免暴露 AI 生成痕迹的 "AI 味"
避免以下常见的 "AI 味"——它们会暴露这个 deck 是 AI 生成的:
- "宣判式"的标题和要点总结,过度戏剧化/简化,无缘由地制造张力(经典的"不是 X,而是 Y"),使用强祈使句,过度重新包装概念,或刻意悬念、故作洞察。
- 类似"奇迹时刻"这样的标题
- 总之,AI 倾向于把标题写成演讲者的金句,而非引导听众进入该页内容的**标题**——必须避免!
## 规划步骤
在常规规划之外,务必完成以下步骤:
1. 受众与品牌风格:能从需求和材料推断就直接定;确实推不出、且猜错整份 deck 要重做时才问。
2. 写出完整的标题序列。选择**一种**语法风格(例如短主题名词短语或简短陈述句),确保适合内容,并用该风格写出每一个标题。回头通读一遍,判断一个人**仅凭标题**能否跟上整个演示的脉络。标题应像书的章节——用直白的语言告诉读者接下来是什么。审阅这些标题并按需修订。将它们写入 scratchpad.md 文件(写在任务目录内,不属于交付产物)。
3. 在 scratchpad.md 里为每张幻灯片标注**版式原型**(满版图 / 大数字 / 图表 / 表格 / 引用 / 多栏卡片 / 时间线 / 纯文字……)与**视觉锚点**(这页视线的第一落点)。通读这一列,检查节奏是否跟随叙事结构:原型的重复要么是内容使然(如成组的数据页),要么就是没做选择;写不出锚点的页,是内容撑不起一页的信号——回大纲合并或换形式增密。
4. 在写任何幻灯片**之前**,先在 `<head>` 的一个 `<style>` 块中将字号、行高和间距定义为 CSS custom properties——这会锁定适合投影的尺寸,防止不自觉退回网页密度。画幅恒为 1920×1080(deck-stage 的基准,输出尺寸由组件 letterbox 缩放解决),合理的起始体系为:`:root { --type-display: 120px; --type-title: 64px; --type-subtitle: 44px; --type-body: 34px; --type-small: 28px; --leading-title: 1.15; --leading-body: 1.4; --measure-body: 40em; --pad-top: 100px; --pad-bottom: 80px; --pad-x: 100px; --gap-title: 52px; --gap-item: 28px; }`。所有地方都引用这些变量——每个 font-size 都用 `--type-*`,每个 line-height 都用 `--leading-*`,每个 padding/gap 都用 `--pad-*` 或 `--gap-*`,通过 inline style 或 class 规则中的 `var(…)` 引用。取档跟着版式原型走:大数字 / 引用页的主角上 `--type-display`,表格单元格用 `--type-small`;连续文本块限宽 `max-width: var(--measure-body)`——行长超限会让达标的字号读起来又小又密,多出来的画幅宽度用双栏、图文并排消化,而不是让一行文字全宽跑。将它们保持为 CSS(而非 JS 常量),意味着用户只需在 style 块中改一个数字就能重新调整整个 deck 的尺寸,而幻灯片标记仍然是静态 HTML,不需要脚本来计算尺寸。显式的 `--pad-bottom` 为每张幻灯片底部预留呼吸空间;那个留白是结构性的,不是空的。网页默认值(body 14-16px、padding 48-72px)对幻灯片太小;如果数值让你觉得不够大方,那就是还不够。任何文字不得小于 24px——这是下限不是目标。
5. **把这套 token 当成每页的内容预算**:在上述数值下,一页正文区大约容纳 14 行正文、或 6 个两行 bullet——在 scratchpad 排内容时就按预算裁剪,而不是写完再看塞不塞得下。装不下的处置顺序是**拆页 > 删内容 > 换更省空间的版式**;缩小字号是最后手段,且绝不越过 24px 下限——靠缩字塞进去的页,只是把溢出换成了后排看不清。反过来,内容远少于预算的页按「视觉平衡」的出路增密或合并,而不是放大字号去撑面积。
6. 构建幻灯片,牢记每张幻灯片既是设计练习也是文案练习。在版式、文字内容和语调方面给予每张幻灯片应有的关注。遵循上述原则,确保每张幻灯片能独立成立;一个只看这一页的人,应当无需其他上下文就能理解其高层含义。
## 验证要点
审阅时,用幻灯片构图规则——而非网页布局直觉——来检查版面。底部留白是不是缺陷,用「留白 ≠ 空洞」的归属判据:内容自身完整、下方是无边框的整块呼吸空间,这是正确的幻灯片构图——不要出于网页直觉把 `flex-start` 改成 `center`;空白被元素边界圈占的,是被动空洞,按「视觉平衡」的出路修。
逐页核对以下各项:
- 字号匹配你的 `--type-*` 体系(而非网页密度),没有为塞内容缩到 24px 以下
- 连续文本块行长不超过 `--measure-body`,没有一行文字横穿整个画幅
- 幻灯片边距匹配你的 `--pad-*` 值(而非网页紧凑间距)
- 封面有统治画面的主视觉,标题位置有构图意图,不是「小图标 + 居中标题 + 居中副标题」三件套
- 结构件(页码、眉标)全 deck 位置样式一致;章节页彼此外观一致
- 没有任何尺度的装饰性彩色边条(判据见「彩色边条」);没有 takeaway box
- 内容区平面化:没有装饰性渐变背景、发光、玻璃拟态;渐变只出现在图上文字保护或数据色带上
- 没有内容被画幅边缘裁切、显示不全
- 没有元素相互压叠、遮挡到读不清
- 没有被动空洞:边框 / 底色圈出的范围与其内容相称
- 页面视觉重量在画布上分布均衡,没有大片区域读成「缺了东西」
- 每页能指出视觉锚点;版式原型的重复经得起「内容使然还是没做选择」的追问
- 带动效的元素在缩略图栏和打印视图下完整可见(基础样式即最终态,隐藏态只在 keyframes 的 `from` 里)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |