Menu
为 `markdown-flow-ui` 的 `Slide` / `Element` 数据结构新增、调整或补充字段契约时使用本技能，尤其适用于需要同步公共类型导出、story 文档摘要与可选字段约束的场景。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | slide-element-contract-sync |
| description | 为 `markdown-flow-ui` 的 `Slide` / `Element` 数据结构新增、调整或补充字段契约时使用本技能，尤其适用于需要同步公共类型导出、story 文档摘要与可选字段约束的场景。 |
当 Slide 的 element 数据结构新增字段时，优先从单一类型源头补齐定义，并同步所有公共导出入口，避免业务侧只能传字段却拿不到对应类型。
src/components/Slide/types.ts 中新增或扩展字段类型，保持 Element 作为唯一契约源头。ElementSubtitleCue），避免在多个文件内联重复声明。src/components/Slide/Slide.tsx 与 src/components/Slide/index.ts 一并对外导出，保持主入口与 slide 子入口一致。elementList 的类型摘要，同步补充新字段，避免文档与真实契约脱节。subtitle_cues 由独立字幕组件接收 currentTimeMs + cues 计算展示结果，而不是把字幕判断逻辑散落在 Player 事件分支里。Element 子结构类型。subtitle_cues 这类时间轴字段需要配合音频播放时，播放器负责提供统一的全局播放毫秒值，字幕组件保持纯展示职责，不直接持有音频元素引用。... 截断时，应移除省略号策略，改为在最大可用宽度内自动换行，并保持文本居中展示。当调整 `markdown-flow-ui` 的 `Slide` 移动端播放器控制栏，尤其涉及 `playerCustomActions` 的桥接型节点、占位空槽和 more icon 入口时使用本技能。
当 `markdown-flow-ui` 中新增用于复现问题的本地测试数据文件，但这些文件扩展名与真实内容格式不一致、导致 pre-commit 或 Prettier 校验失败时使用本技能。
保持 `markdown-flow-ui` 中基于 iframe 的幻灯片（`Slide`）步骤常驻挂载，通过 CSS `display` 切换可见性。当幻灯片导航需要降低 iframe 重载耗时、要把 `is_renderable` 驱动的卸载渲染改为“隐藏但已挂载”策略、或在预加载改造中保持 `is_new`、`diff`、交互步骤语义不变时使用本技能。
修复或排查 `markdown-flow-ui` 的 `ContentRender` 在关闭打字机效果时首屏空白、helper 行先于正文出现等首次渲染时序问题时使用本技能。
为 `markdown-flow-ui` 的 `ContentRender` 新增或更新“后端整句到达、前端按固定节奏做打字机输出”的 story 时使用本技能。
修改 `markdown-flow-ui` 的 `MarkdownFlowEditor` 国际化语言时使用本技能，尤其适用于新增 locale、补充编辑器文案资源、以及让上游项目传入的语言配置安全落到编辑器内部的场景。