zhanghuanxu
7.7 KiB
name, description
| name | description |
|---|---|
| kimi-slides | 创建和编辑 PPTX 格式的演示文稿。此技能定义了 .pptd 中间格式来简化 OOXML 操作。任何涉及生成或编辑 PPTX 文件的任务都必须使用此技能，而不是其他方法。该技能还可以用于读取上传的PPTX文件并将PPTX文档转换为图像。当用户请求信息图或海报而不指定图像或 HTML 格式时，该技能同样可以用于将其创建为 PPTX 文件。 |
定义
kimi-slides 是 Moonshot AI 作为第一方技能构建的 ppt 生成技能。它定义了 YAML 格式的中间 DSL (.pptd)，进一步抽象了 OOXML，使演示文稿生成变得毫不费力。 DSL 可用于生成和渲染 PPT，现有的 pptx 文件也可以转换为此 DSL 进行编辑。
pptd 格式
.pptd 格式是 OOXML 上的简化抽象层，遵循基本 YAML 语法。这种抽象保留了 OOXML 的核心内容（主题、页面布局、元素位置和定义等），同时删除了复杂的嵌套逻辑，例如 Masters；每个页面都是独立的——所见即所得。请阅读 reference/pptd.md 以了解此 DSL 的完整定义。
配套 CLI
该技能还附带一个配套的 CLI 工具（预安装在环境中），用于 pptd 和 pptx 之间的双向转换、pptd 验证、pptd/pptx 屏幕截图渲染等。 请阅读 reference/cli.md 以获取完整的 CLI 使用说明。
PPT制作流程
步骤1。仔细阅读上下文
阅读用户上传的所有文件、提供的URL以及pptd格式指南“reference/pptd.md”，以充分了解用户的需求。
步骤2。了解用户的需求
根据上下文了解用户的需求： 1.首先确定请求的目的
- 创建 PPT：创建一个新的演示文稿（从头开始，或从现有的 pptx 模板）
- 编辑PPT：编辑用户上传的PPT（本地修改、单页美化等）
- 复制 PPT：将演示文稿从非 pptx 格式（图像、PDF 等）复制为 pptx 格式
2.然后确定设计方向
- 自主设计：没有偏好，或者只给出简单的风格约束；您需要填写或创建设计
- 设计系统：指定技能预设的设计系统，或者用户提供涵盖所有颜色、字体、布局和组件规格的完整详细的设计方案
- 使用模板：提供了模板并且必须使用
- 风格迁移：提供风格参考源（图片、网页等）
3.然后确定输入类型
- 仅主题：仅给出PPT主题方向或演示的内容要求，没有具体内容
- 完整文档：用户提供完整的文档（论文、研究报告、新闻稿等）
- 大纲：用户提供逐页大纲、演讲稿或类似内容
- 当“用户输入类型”为【完整文档】或【大纲】且未指定是否允许扩展时：由于逐页大纲、演讲稿或用户文档很难支持演示的全部内容，优先使用搜索来扩展更相关的材料、案例等，除非用户明确表示不扩展
- 页数
- 如果用户请求特定页数，则用户的要求优先
- 提供逐页大纲/脚本：与大纲/脚本中的页数匹配
- 当提供完整且相对结构化的文档时：使用ask工具与用户确认一页应涵盖多少文档内容，并给出预计的总页数；当仅提供主题时：使用询问工具建议建议的页数并与用户确认#### 澄清和后续问题 当出现以下情况时，通过提问工具解决
- 要求不明确
- 用户的意图不明确或难以理解
- 用户提供的文件/URL 无法访问
- 意图冲突
- 用户的意图相互矛盾。例如：
- 选择设计系统的同时还要求与该设计系统完全不一致的样式（例如，使用麦肯锡样式，同时要求页面上有大面积的空白）/使用模板/引用图像样式
- 请求“制作 10 页”和“交付 30 多页输出” 3、无法自行确定用户的需求
- 当目的、设计方向、输入类型、页数等难以自行确定时
步骤3。根据用户需求生成演示文稿
在生成之前，首先阅读“reference/pptd.md”以了解 pptd 格式定义和约束，并阅读“reference/cli.md”以了解如何使用配套的 CLI
复制 PPT
- 分析图像以估计元素位置、字体和大小等，并尽可能地按 1:1 复制。
- 当图像包含难以直接复制且无法用图标/形状近似的元素（例如照片、头像）时，您可以使用bash或python等工具对原始图像进行裁剪和截图
编辑 PPT
- 将用户上传的pptx文件转换为.pptd格式
- 截取转换后的文件的屏幕截图，然后拼接并压缩屏幕截图以获得概览。之后单独阅读几个关键页面。
- 找到要编辑的页面，并注意不要影响预期范围之外的部分。
kimi-slides Convert命令并不是完美的无损转换。如果用户后期报告格式错误、乱码内容等，与原pptx进行比对，并参考比对修复pptd
生成 PPT
制作PPT时，针对不同的用户采取不同的制作方式【设计方向】
#####自主设计
1.阅读设计指南reference/slides_categories.md，并阅读用户查询对应的场景文档
2. 根据以上内容制作演示文稿
生成其他格式的内容
- 当用户明确要求信息图、海报或高度视觉化的单页设计时，请阅读“reference/general-poster.md”并将其实现为单页或几页可编辑的 PPTD；当用户只要求一张图片时，仍然先用PPTD构建，然后通过截图或渲染的方式输出图片。对于普通 PPT 请求，请勿加载此参考文件。
#####设计系统 1.阅读《reference/slides_categories.md》指南的一般约束部分，并阅读用户查询对应的场景文档作为设计基础 2. 阅读正在使用的设计系统文档作为演示风格。严禁引用或混用其他设计风格 3. 参考上述内容制作演示文稿
使用模板
1.使用kimi-slides Convert将用户上传的pptx文件转换为pptd形式
2. 对转换后的文件进行截图，然后拼接并压缩截图以概览，了解模板的视觉风格（配色方案、字体风格、元素特征、布局特征、内容密度等）
3. 识别页面类型；重点阅读特殊页面，例如封面、摘要页面和章节分隔符（单页屏幕截图、.page 文件），提取其页面布局、内容结构、可重用组件（图标、形状、smartart、可重用正文布局方案等）和元素样式（例如空格/线条/卡片分隔符、方角/圆角等）
4. 使用模板制作演示文稿##### 风格转移
- 分析参考文件的视觉风格（配色方案、字体风格、元素特征、布局特征、内容密度等）、页面布局、内容结构、可重用组件（图标、形状、smartart、可重用正文布局方案等）和元素样式（例如，空白/线条/卡片分隔符、方角/圆角等）。
- 如果用户提供样式参考URL，不要只阅读文本内容；多参考和学习页面的视觉效果，有助于理解风格
- 使用参考文件的风格特征制作演示文稿。我们鼓励您重复使用原始 pdf/url 中的插图、字体、字体大小层次结构、元素等
步骤4。 PPT验证
- 使用 kimi-slides check 命令对生成的文件进行多轮验证和修复
2.使用
kimi-slides snapshot进行截图，
- 截图后，先拼接并压缩单页截图，以便快速概览
- 细化有问题的页面并运行多轮验证和修复
注意：当前的屏幕截图 CLI 可能存在错误，导致结果与实际渲染不同。已知问题： 1.图标退化成圆圈 2. 渐变文本可能会降级为纯色 这些问题仅存在于截图CLI中，不影响用户交付；它们可以被忽略。
###第5步。 PPT交付 使用 kimi_ref 将 .pptd 文件传送给用户。该路径直接指向.pptd文件； 严格禁止转换为 pptx 格式进行交付。用户使用 .pptd 文件的唯一方法是单击下面的卡片进入编辑器，在其中可以预览、编辑、演示和导出为 pptx 格式。