用途:当用户要求从零开始制作一份演示文稿时,使用本技能完成第一阶段规划,产出经用户批准的 slide-outline.md,之后才进入幻灯片 HTML 生成。
输入:主题与意图、受众、语气与约束,以及可选的研究结果。
输出:slide-outline.md,其 meta 部分必须包含 style: <id>。
工作流程:先分析用户目标与受众;随后必须进行风格选择,按优先级接受三种路径:一是内置风格,运行 slides-grab list-styles,筛选 2–3 个风格并取得用户明确批准,可选提供 slides-grab preview-styles 做可视化预览,记录为 style: <id>;二是自定义 DESIGN.md 路径,若存在本地 DESIGN.md(直接提供或通过 slides-grab import-design <https-url> 获取),用 slides-grab show-design ./DESIGN.md 检查并与用户确认;三是自由自定义方向,若前两者都不合适,提出书面自定义方向并取得批准。
选择路径二时必须做 DESIGN.md → DESIGN.slides.md 转换:从 voltagent/awesome-design-md 等来源导入的 DESIGN.md 描述的是营销网站(顶部导航、hero 区、CTA 按钮、定价卡、页脚带),而幻灯片是 720pt × 405pt 的单帧、无滚动、无导航、无点击,直接照搬网页组件会让页面像落地页。需阅读 references/design-md-to-slides-conversion.md,将 ./DESIGN.md 转换为同目录的 ./DESIGN.slides.md,保持原文件不动,并遵循该参考中的输出契约与 web → slide 映射表(顶部导航→eyebrow 条、hero 区→封面布局、CTA 按钮→kicker 文本、页脚带→细页脚条、定价网格→丢弃等)。向用户展示 5–10 行转换摘要并等待明确批准,之后运行 slides-grab show-design ./DESIGN.slides.md 确认解析正常。
随后创建或修订 slide-outline.md,列出有序幻灯片与关键信息,并在 meta 中记录已批准风格:内置风格写 style: <id>;转换后的 DESIGN.slides.md 写 style: ./DESIGN.slides.md;自由自定义方向则用一段 style: 块描述。向用户展示简要摘要,反复修订直到明确批准。
规则:用户批准风格前不得撰写大纲,风格选择优先;本阶段不得生成幻灯片 HTML(<slides-dir>/slide-*.html);范围限于结构、叙事与风格选择;进入设计前需取得批准;假定后续阶段通过打包的 slides-grab CLI 运行;仅使用打包 CLI 与内置参考,不依赖未发布的特定 agent 文件。
参考:references/outline-format.md、references/plan-workflow-reference.md、references/design-md-to-slides-conversion.md。