mcpField
P
ppt-image-first

ppt-image-first

github.com/nyxtides文档处理1.2k109 次安装25 周前更新
代码仓库

关于 ppt-image-first

PPT Image First 是将模糊的演示文稿需求转为图像优先制作流程的 Skill,适用于需要规划并审阅完整幻灯片的人。它通过内容梳理、风格预览、页面规划和确认关卡,获批后再导出 PPT。

主要功能

  1. 01梳理内容并建立内容依据
  2. 02生成多种风格的页面预览
  3. 03按页面编写设计规格与蓝图
  4. 04通过 HTML 界面审阅和修改页面
  5. 05审批后导出最终 PPT

适用场景

  1. 01从主题或零散材料规划演示文稿
  2. 02先比较页面风格预览再确定方向
  3. 03逐页检查并修订生成的幻灯片

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/nyxtides/ppt-image-first --skill ppt-image-first

安装后在 Claude Code 中输入/ppt-image-first确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

.gitignore
README.en.md
README.md
LICENSE
assets/candidate_picker_shell/
index.html
build_candidate_picker_html.py
assets/preview_shell/
build_preview_html.py
index.html
assets/review_shell/
build_review_html.py
index.html
references/
conversation_framework.md
style-system.md
preview-flow.md
workflow.md
scripts/
render_review_markup.py
templates/
content_report_reference.md
spec_lock_reference.md
design_spec_reference.md
slide_blueprint_reference.md

详细介绍

PPT 图片优先

使用此技能,将模糊的 PPT 需求转化为可直接用于生成的图片优先型演示文稿规划。

输入/输出约定

  • 输入:PPT 主题、初步目标、现有笔记/材料,或完整的报告式叙述。
  • 可选锚点:受众、页数或时长、学校/公司/实验室/课程/品牌标识、使用场景、源文件和风格约束。
  • 输出:经确认的内容依据、视觉风格预览、演示文稿规格、生成的页面视觉稿、审阅界面,以及审批后的最终 PPT。
  • 确认关卡:需求确认、风格确认、生成前确认 和最终审阅批准。
  • 默认宽高比:除非用户明确要求其他比例,否则生成 16:9 的预览图和最终页面视觉稿。

工作流阶段

按顺序执行以下阶段,不得跳过确认关卡:

  1. 需求收集:适度澄清需求,识别锚点,给出简短的初步判断,然后取得 需求确认。
  2. 内容依据:创建或提取 content_report.md;如果用户已提供完整的报告式内容,则无需创建;默认展示综合判断,而非原始文件。
  3. 风格预览:对齐风格边界,提出风格方向,为每个方向生成 首页 / 目录页 / 正文页 预览,支持优化,然后取得 风格确认。
  4. 规划锁定:执行 风格反演确认,随后按顺序编写 design_spec.md、slide_blueprint.md 和 spec_lock.md;总结并取得 生成前确认。
  5. 生成与审阅:生成页面视觉稿,可选择执行候选方案筛选;打开审阅 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