关于 ppt-image-first
PPT Image First 是将模糊的演示文稿需求转为图像优先制作流程的 Skill,适用于需要规划并审阅完整幻灯片的人。它通过内容梳理、风格预览、页面规划和确认关卡,获批后再导出 PPT。
主要功能
- 01梳理内容并建立内容依据
- 02生成多种风格的页面预览
- 03按页面编写设计规格与蓝图
- 04通过 HTML 界面审阅和修改页面
- 05审批后导出最终 PPT
适用场景
- 01从主题或零散材料规划演示文稿
- 02先比较页面风格预览再确定方向
- 03逐页检查并修订生成的幻灯片
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ nyxtides/ ppt-image-first --skill ppt-image-first安装后在 Claude Code 中输入/ppt-image-first确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
.gitignoreREADME.en.mdREADME.mdLICENSEassets/candidate_picker_shell/index.htmlbuild_candidate_picker_html.pyassets/preview_shell/build_preview_html.pyindex.htmlassets/review_shell/build_review_html.pyindex.htmlreferences/conversation_framework.mdstyle-system.mdpreview-flow.mdworkflow.mdscripts/render_review_markup.pytemplates/content_report_reference.mdspec_lock_reference.mddesign_spec_reference.mdslide_blueprint_reference.md详细介绍
PPT 图片优先
使用此技能,将模糊的 PPT 需求转化为可直接用于生成的图片优先型演示文稿规划。
输入/输出约定
- 输入:PPT 主题、初步目标、现有笔记/材料,或完整的报告式叙述。
- 可选锚点:受众、页数或时长、学校/公司/实验室/课程/品牌标识、使用场景、源文件和风格约束。
- 输出:经确认的内容依据、视觉风格预览、演示文稿规格、生成的页面视觉稿、审阅界面,以及审批后的最终 PPT。
- 确认关卡:
需求确认、风格确认、生成前确认和最终审阅批准。 - 默认宽高比:除非用户明确要求其他比例,否则生成
16:9的预览图和最终页面视觉稿。
工作流阶段
按顺序执行以下阶段,不得跳过确认关卡:
- 需求收集:适度澄清需求,识别锚点,给出简短的初步判断,然后取得
需求确认。 - 内容依据:创建或提取
content_report.md;如果用户已提供完整的报告式内容,则无需创建;默认展示综合判断,而非原始文件。 - 风格预览:对齐风格边界,提出风格方向,为每个方向生成
首页 / 目录页 / 正文页预览,支持优化,然后取得风格确认。 - 规划锁定:执行
风格反演确认,随后按顺序编写design_spec.md、slide_blueprint.md和spec_lock.md;总结并取得生成前确认。 - 生成与审阅:生成页面视觉稿,可选择执行候选方案筛选;打开审阅 HTML,按需润色,并仅在获批后导出最终 PPT。
按阶段执行的详细说明请参阅 references/workflow.md。
渐进式加载
- 需求收集与初步判断:仅在需要以对话为先的需求收集模式时,阅读
references/conversation_framework.md。 - 风格提案:制作提案卡片或在内部解读 V1-V8 时,阅读
references/style-system.md。 - 预览/审阅界面:制作风格预览、候选方案选择页面或审阅页面前,阅读
references/preview-flow.md。 - 内容依据:编写
content_report.md前,阅读templates/content_report_reference.md。 - 规划文件:编写这些文件前,立即阅读
templates/design_spec_reference.md、templates/slide_blueprint_reference.md和templates/spec_lock_reference.md。
工作原则
- 将用户视为客户,并以提案设计 Agent 的身份提供服务。
- 不要强迫用户手动配置设计参数;应将其自然语言意图转化为设计决策。
- 相关时询问现实世界中的身份锚点,但将其作为背景信息,而非风格问题。
- 需求收集应保持轻量;不要将内容依据或风格对齐变成长篇问卷。
- 在内部使用风格向量,但面向用户时,应以简洁的提案卡片和图片预览呈现选项。
- 依据内容基础制作预览和规划,而不是使用通用占位结构。
- 谨慎标记推断内容;不要将缺乏依据的精确数据、实验结果、引文或机构结论说成是用户提供的事实。
- 默认展示摘要、提案卡片、预览和审阅界面;仅在有用或用户提出要求时展示原始规划文件。
硬性规则
- 预览优先:最终风格确认应基于生成的
首页 / 目录页 / 正文页预览,而不是仅凭文字选择。 - 必须使用基础 UI:各阶段必须使用
assets/preview_shell/index.html、assets/candidate_picker_shell/index.html和assets/review_shell/index.html作为基础 UI。 - 在本地预览、候选选择器、评审界面和最终 PPT 文件生成后,立即打开它们;如果无法打开,请说明阻碍并提供路径。
- 在风格方向和
风格反演确认完成之前,不要编写slide_blueprint.md。 - 如果已确认的方向依赖生成的页面视觉效果,就要坚持以图像生成为先;不要悄悄退回到逐个形状构建 PPT 或手绘代码替代方案。
- 默认将用户要求的编辑(例如添加、替换、纠正或补充可见文字)视为图像生成/编辑任务。除非用户明确要求使用代码/PPT 叠加层方案,否则不要使用 PIL、Pillow、canvas、SVG、HTML 截图、PPT 原生文本框或确定性叠加层来修补最终页面视觉效果。
- 默认将生成的页面视觉效果视为完整;除非叠加层可追溯至已批准的蓝图字段,否则默认不添加任何生成后叠加层。
- 将幻灯片标识符、候选代码、文件名和生成批次标签放在图像生成提示词正文之外。它们可以出现在规划文件、文件名、映射表、评审 UI 和聊天指令中,但发送给图像模型的提示词只能包含面向受众的内容和视觉方向。
- 评审载荷应包含轻量级坐标标记,而不是 base64 预览图像。用户粘贴带有标记的评审 JSON 时,先使用
scripts/render_review_markup.py在本地渲染带标记的评审图像,再将标记图像和单独的文字评论用作润色/重新生成的参考。 - 在完整生成之前,询问用户希望每张幻灯片生成一张最终图像,还是多张最终候选图像。
- 首轮生成后不要立即导出最终 PPT;仅在评审页面获批后导出。
输出层级
始终一致地使用以下层级:
content_report.md= 用户未提供完整的报告类材料时,上游内容依据。design_spec.md= 全局演示文稿设计依据和已确认的视觉系统。slide_blueprint.md= 逐页设计意图和内容规划。spec_lock.md= 执行约束和最终生成护栏。
content_report.md 为 3 个核心规划文件提供支持,但不能取代它们。spec_lock.md 始终是最后一个核心规划文件。
评论
支持 Markdown