Presentation Structure

• 您需要一个代理来添加、删除或重新排序 HTML 演示文稿中的幻灯片，并正确地重新编号每个 data-slide 属性和 goToSlide() 目录引用。
• 您希望代理创建新的分节符，并附带正确的 section-slide 类、data-level 属性和 section-desc 文本内容。
• 您需要代理推断进度条状态——了解哪些幻灯片显示空进度条、哪些幻灯片继承某个层级，以及哪些幻灯片触发层级过渡。
• 您正在审查或审计演示文稿结构，并希望代理检测 goToSlide() 调用中存在的缺失、重复或不匹配问题。

• 您正在使用其他框架构建演示文稿（例如 Reveal.js、PowerPoint、Google Slides）—— 本技能专针对 presentation/index.html 单文件格式。
• 您只需编辑幻灯片内容（文字、图片、图表），而无需调整幻灯片编号或结构 —— 在这种情况下，本技能的结构规则只会带来不必要的额外负担。

该技能对三种幻灯片类型进行了编码——普通幻灯片、层级过渡章节幻灯片以及标题幻灯片——并涵盖所需的 HTML 属性（data-slide、data-level、CSS 类）。代理了解哪些属性是必填项、哪些是可选项，以及哪些元素（如 .level-badge）不得在 HTML 中硬编码。

与累积百分比不同，该演示文稿使用四个离散级别（low、medium、high、pro），分别对应 25 / 50 / 75 / 100% 的进度条填充量。Presentation Structure 会精确捕捉哪些幻灯片范围触发各个级别、哪些幻灯片继承上一级别，以及进度条在第 1 张幻灯片上隐藏、在首次出现 data-level 过渡之前保持为空的规则。

在任何结构性编辑之后，智能体必须将所有 data-slide 属性从 1 开始按顺序重新编号，更新目录/旅程地图幻灯片中每个 goToSlide() 的调用，并验证不存在间隔或重复。Presentation Structure 技能文档说明 totalSlides 由 DOM 自动计算，无需手动更新。

该技能涵盖用于目录链接的 goToSlide(n) 函数、自动计算的 totalSlides 值，以及所支持的输入方式：方向键、空格键和触摸滑动。这使代理能够在重新编号后验证目录链接是否保持一致。

章节分隔符遵循精确的格式：section-slide 类、可选的 data-level、一个 section-number 段落、一个 <h1> 标题，以及一个命名层级的 section-desc 段落。Presentation Structure 使代理了解完整的预期标记结构，从而确保新生成的章节立即符合规范。

用户要求代理在第 46 张幻灯片之后插入一个新的"第七部分"章节。Presentation Structure 技能指示代理创建一个带有下一个连续 data-slide 编号的 section-slide div，添加适当的 data-level，对所有后续幻灯片重新编号，并更新目录幻灯片中的每个 goToSlide() 调用。

该代理扫描 presentation/index.html，检查 data-slide 值中是否存在间隔或重复，并将每个 goToSlide() 调用与实际幻灯片编号进行交叉核对，报告任何不匹配之处——此任务完全由 Presentation Structure 技能中编码的重新编号规则提供支持。

用户希望获取一份关于哪些幻灯片属于哪个旅程级别的摘要。代理利用 Presentation Structure 技能中的级别转换表，生成幻灯片范围、data-level 值及对应进度条填充百分比的精确映射，而无需读取整个 HTML 文件。

当被要求搭建新幻灯片时，代理会使用 Presentation Structure 技能中的精确 HTML 模板——选择正确的类（title-slide、section-slide 或普通 slide），放置正确的属性，并了解需在源 HTML 中省略 .level-badge，因为它会在运行时由 JS 动态注入。