[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-900":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":32,"readmeContent":33,"aiSummary":34,"trendingCount":16,"starSnapshotCount":16,"syncStatus":15,"lastSyncTime":35,"discoverSource":36},900,"ppt-image-first","NyxTides\u002Fppt-image-first","NyxTides","PPT image-first skill for Codex\u002FClaude Code\u002FOpencode CLI","",null,"Python",1037,85,3,2,0,23,65,289,69,18.8,"Apache License 2.0",false,"master",true,[27,28,29,30,31],"office","powerpoint","ppt","slide","slides","2026-06-12 02:00:20","# ppt-image-first\n\n**中文** | [English](.\u002FREADME.en.md)\n\n一个 **conversation-first、image-first** 的 PPT 工作流 skill，用来把一个模糊的 PPT 需求，逐步推进成：内容基底、风格预览、定稿规划，以及后续可执行的生成流程。\n\n`ppt-image-first` 不是那种一上来就让用户填一堆参数，或者直接套模板拼页面的 PPT skill。它更像一个分阶段推进的提案式工作流：先理解需求、补内容基底、出真实预览、允许反复推风格，最后再进入锁定与生成。\n\n> **说明：输出方式是 image-first。** 这套 workflow 默认使用 **GPT Image 2** 生成整页视觉图，再把这些页面图放入 PPTX 容器中交付；它不是直接用 PowerPoint 对象逐个绘制文字框、形状和图表的“完全可编辑 PPT”生成器。因此，成品更接近高完成度视觉稿式演示页：适合展示、汇报和继续做图像级 retouch，但页面内的文字、图形、装饰元素通常不能像原生 PPT 元素一样逐项编辑。\n\n## 示例速览\n\n### 1. 工作流总览示意图\n\n![整体流程示意图](.\u002Fdocs\u002Fimages\u002Fworkflow-overview-slide.png)\n\n### 2. 答辩 \u002F 汇报类首页示例\n\n![气象答辩首页示例](.\u002Fdocs\u002Fimages\u002Fsample-meteorology-defense-deck.png)\n\n### 3. 校园 \u002F 红色主题类成品示例\n\n![校园红色主题 PPT 示例](.\u002Fdocs\u002Fimages\u002Fsample-red-campus-deck.png)\n\n### 4. 技术研究类正文页示例\n\n![技术研究正文页示例](.\u002Fdocs\u002Fimages\u002Fsample-tech-research-body-page.png)\n\n## 示例 PPT\n\n项目内已附一份直接用这套 workflow 做出来的介绍型演示稿，可直接下载查看：\n\n- [下载示例 PPT（ppt-image-first-demo-deck.pptx）](.\u002Fdocs\u002Fdemo\u002Fppt-image-first-demo-deck.pptx)\n\n这份文件的主题就是 `ppt-image-first` 本身，适合用来快速感受这套 skill 产出的页面风格、叙事组织和整体完成度。\n\n---\n\n## 这个 skill 是干什么的\n\n它适合处理这类请求：\n\n- “帮我做一个 PPT”\n- “把这份报告整理成演示稿”\n- “帮我做答辩 PPT”\n- “做一个产品介绍 deck”\n- “先给我几套视觉方向看看，再决定风格”\n- “我现在只有主题和一些散材料，你先帮我把它整理成能做 PPT 的东西”\n\n它的核心不是“快速出一个模板”，而是走一套完整流程：\n\n1. 轻量 intake\n2. 输出 baseline judgment\n3. 进入 **需求确认**\n4. 生成风格前内容基底 \u002F `content_report.md`\n5. 做风格边界对齐\n6. 产出多套风格方向预览\n7. 必要时继续风格 refinement\n8. 进入 **风格确认**\n9. 做 `风格反演确认`\n10. 写规划文件\n11. 进入 **生成前确认**\n12. 选择生成分支\n13. 进入 review & retouch loop\n14. 最终导出\n\n---\n\n## 为什么要做这个 skill\n\n很多 PPT 工作流会在两个方向上出问题：\n\n- **太模板化**：看起来工整，但内容和主题贴合度不够，容易泛\n- **太浅**：视觉上像 PPT，但内容没有形成真正能支撑汇报的叙事和深度\n\n`ppt-image-first` 的目标就是同时避免这两类问题。\n\n它的基本思路是：\n\n- 前台对话尽量轻，不把用户拖进长问卷\n- 如果材料偏薄，先补内容基底，再谈风格\n- 风格确认默认依赖**真实预览图**，不是文字描述\n- 最终页面视觉默认走 **image-first** 路径，不靠后期大量补 overlay 修修补补\n\n---\n\n## 核心特点\n\n### 1. Conversation-first\n\n用户被当成甲方，agent 被当成提出方向、生成方案、推进流程的设计侧。\n\n这意味着：\n\n- 首轮问题轻量\n- 不做长表单式提问\n- 用户主要对判断、方向、预览和 refinement 进行反馈\n- agent 内部可以有复杂逻辑，但前台交互尽量自然\n\n### 2. Image-first\n\n这里的 preview 默认指 **真实生成的图像预览**，而不是：\n\n- 文字 mockup\n- ASCII 草图\n- 占位壳子\n- 只描述风格、不真正出图\n\n最终生成也遵循同样逻辑：优先让 **GPT Image 2** 直接生成整页页面视觉，再封装进 PPTX；这能保持视觉完整度和风格一致性，但不承诺每个页面元素都是 PowerPoint 原生可编辑对象。\n\n### 3. 先补内容，再做风格\n\n在 `需求确认` 之后，如果用户没有给出完整的报告式材料，就先生成一个 `content_report.md` 作为上游内容基底。\n\n这样后面的：\n\n- 首页预览\n- 目录页预览\n- 正文页预览\n- `design_spec.md`\n- `slide_blueprint.md`\n- `spec_lock.md`\n\n都不是从空主题硬编，而是有真实内容来源。\n\n### 4. 先看预览，再确认风格\n\n它不会让用户直接在文字里选最终风格，而是先产出：\n\n- 首页\n- 目录页\n- 正文页\n\n这三类预览，让用户看过再决定。\n\n### 5. Review 不是可选项\n\n第一版完整结果出来后，不默认视为结束，而是进入专门的 review-and-retouch 流程。\n\n---\n\n## 工作流总览\n\n### Stage 1 — Intake and baseline judgment\n\n只收集最必要的信息：\n\n- 用途\n- 受众\n- 粗略页数 \u002F 时长\n- 手头材料\n- 学校 \u002F 公司 \u002F 实验室 \u002F 课题组 \u002F 课程 \u002F 品牌主体等真实身份锚点\n\n然后输出一个简短 baseline judgment，并停在 **需求确认**。\n\n### Stage 1.25 — 风格前内容研究与报告化基底\n\n如果用户没有直接给出完整叙述内容，就先生成 `content_report.md`。\n\n这个阶段的作用是：\n\n- 给薄主题补出可讲的内容主线\n- 把散材料整理成可展开叙事\n- 让预览页不再是空壳\n- 让后续规划文件有真实来源\n\n### Stage 1.5 — 风格边界对齐\n\n只问 3 个短问题：\n\n- 整体偏亮 \u002F 偏暗 \u002F 中间态\n- 常规专业路线 \u002F 明显风格化路线\n- 这次先看几套方向\n\n### Stage 2 — 风格提案与预览\n\n生成多套风格方向，并给出真实预览图，覆盖：\n\n- 首页\n- 目录页\n- 正文页\n\n### Stage 2.5 — 风格 refinement\n\n如果用户对某套方向基本满意但想继续调整，就从这一套继续往下推，而不是强迫立即定稿。\n\n### Stage 2.75 — 风格反演确认\n\n把用户最终选中的预览图当成“证据”，反推出用户真正喜欢的是哪些稳定特征，并区分：\n\n- 明确应延续的\n- 效果好但要确认是否整套延续的\n- 只在当前图里偶然成立、不建议锁死的\n\n### Stage 3 — 规划文件\n\n按顺序生成：\n\n1. `design_spec.md`\n2. `slide_blueprint.md`\n3. `spec_lock.md`\n\n然后进入 **生成前确认**。\n\n### Stage 4 — 生成\n\n先问用户是：\n\n- 每页先出 1 张最终图\n- 还是每页先出多张候选再选\n\n如果选多候选，就先进入 candidate picker，再进入最终 review。\n\n### Stage 5 — Review and retouch\n\n默认用 review shell 做评审。\n\n如果用户满意，就结束评审；不满意，就复制结构化反馈回对话继续返修。\n\n---\n\n## 内置工作流壳子\n\n这个 skill 自带 3 个固定工作流界面壳子：\n\n- `assets\u002Fpreview_shell\u002Findex.html`\n- `assets\u002Fcandidate_picker_shell\u002Findex.html`\n- `assets\u002Freview_shell\u002Findex.html`\n\n它们分别承担：\n\n- 风格预览比较\n- 多候选选图\n- 评审与返修\n\n这些 shell 是工作流的一部分，不建议随意换成别的自制页面。\n\n---\n\n## 规划产物\n\n这个 skill 主要围绕 4 个产物推进：\n\n### `content_report.md`\n\n风格前内容基底。用于在用户材料不完整时，先形成一个能支撑后续 PPT 的小型报告化内容稿。\n\n### `design_spec.md`\n\n整套 deck 的全局理由、方向、连续性约束。\n\n### `slide_blueprint.md`\n\n逐页定义页面意图、内容 payload、视觉策略、承载重点。\n\n### `spec_lock.md`\n\n执行约束文件。用于锁定什么能改、什么不能改、哪些内容不能乱编、后续生成允许采用什么策略。\n\n---\n\n## 它和一般 PPT skill 的差别\n\n### 不是 template-first\n\n不是从固定模板页出发。\n\n### 不是 form-first\n\n不是先让用户填一串设计参数表。\n\n### 不是 text-mockup-first\n\n不是靠文字描述代替真正的风格预览。\n\n### 不是 shallow-by-default\n\n当主题偏薄时，会先补内容基底，再出预览。\n\n### 不是 patch-overlay-driven\n\n不会默认把生图只当背景，再靠后期乱补标题、数字、标签、说明框去“救”页面。\n\n---\n\n## 目录结构\n\n```text\nppt-image-first\u002F\n├─ SKILL.md\n├─ README.md\n├─ README.en.md\n├─ references\u002F\n│  ├─ workflow.md\n│  ├─ conversation_framework.md\n│  ├─ preview-flow.md\n│  └─ ...\n├─ templates\u002F\n│  ├─ content_report_reference.md\n│  ├─ design_spec_reference.md\n│  ├─ slide_blueprint_reference.md\n│  └─ spec_lock_reference.md\n└─ assets\u002F\n   ├─ preview_shell\u002F\n   ├─ candidate_picker_shell\u002F\n   └─ review_shell\u002F\n```\n\n---\n\n\n## 适用场景\n\n这套 workflow 特别适合：\n\n- 答辩稿\n- 研究汇报\n- 项目汇报\n- 产品介绍\n- 路演 deck\n- 培训课件\n- 提案 deck\n- 内部复盘 \u002F 汇报演示\n\n尤其适合这几种情况：\n\n- 用户只有主题或零散材料\n- 需要在风格前先把内容补扎实\n- 需要先看真实预览再决定方向\n- 最终成品必须尽量继承已确认预览的视觉逻辑\n\n---\n\n## 说明\n\n- 默认比例是 `16:9`，除非用户明确要求其他比例。\n- 预览页应当是 content-bearing 的，而不是空壳或占位图。\n- 这套 workflow 有多个确认点，这是刻意设计，不是冗余。\n- review 阶段属于主流程的一部分，不是最后临时加的补充环节。\n\n---\n\n## 致谢\n\n本项目感谢 [Linux.do 社区](https:\u002F\u002Flinux.do\u002F) 对开源分享与传播的推动。\n","ppt-image-first 是一个基于对话和图像优先的PPT工作流工具，旨在将模糊的PPT需求逐步推进至内容基底、风格预览、定稿规划及最终生成。其核心功能包括轻量级的需求收集、分阶段的内容与风格确认以及基于GPT Image 2生成的高质量视觉页面。技术上，它通过Python实现，并采用image-first的方式默认生成整页视觉图，而非直接使用PowerPoint对象绘制可编辑元素。此项目适用于需要高完成度视觉稿式演示页的场景，如展示、汇报等，尤其适合那些希望先看到真实预览再决定设计方向的用户。","2026-06-11 02:40:06","CREATED_QUERY"]