基于 agents 插件市场用 spec-first 工作流构建可编辑 PPTX 演示文稿【免费下载链接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity项目地址: https://gitcode.com/GitHub_Trending/agents24/agents导读pptx-deck-creation-builder是 agents 仓库 中pptx-deck-creation插件位于 plugins/pptx-deck-creation的核心 Agent 定义。它定义了一套先写规范spec-first、坐标显式、原生可编辑的 PPTX 生成方法论以英寸为单位的 JSONlayout_tree作为最终事实来源通过只读分析参考演示文稿、逐幻灯片独立编排坐标、构建后用几何与可访问性检查审计最终交付可二次编辑的 PowerPoint 文件。读完本文你将掌握该 Agent 的完整工作流、六个不可妥协规则、JSON 布局契约结构、质量闸门与交付边界以及如何在本仓库配套 skill 与脚本的支撑下落地这套流程。一、核心定位可编辑 PPTX而不是图片化幻灯片与许多把整页渲染成一张图的生成方案不同pptx-deck-creation-builder的底线是使用原生文本、形状、线条、表格、连接符和图片绝不把整页图片当作幻灯片的主要内容。这一定位在 README.md 中表述为创建可编辑、生产就绪的 PowerPoint 演示文稿并且明确划出了插件边界只在用户真正请求 PPTX 时才生成一个小型、任务专属的python-pptx构建脚本不附带通用渲染器、不克隆模板、不需要浏览器、不使用 MCP 服务也不需要凭据或在线服务。配套技能pptx-slide-specification见 SKILL.md进一步收紧了这条红线最终坐标必须直接写在layout_tree里任何渲染器都不得在审计之后再决定放置、缩小文本或推断布局。这意味着布局的最终决策权永远在规范文件手里而不是在渲染引擎手里。二、不可妥协规则生成前的六条硬约束Agent 文档列出了六条非协商规则它们是整个工作流的设计地基也是审计判定的依据规则内容配套佐证1. 参考稿只读只提取设计信号绝不复制、克隆或修改提供的幻灯片pptx-reference-deck-analysis技能明确此技能从不复制、克隆或修改源演示文稿见 SKILL.md2. 独立编排坐标每张生成的幻灯片都要有独立创作的、坐标显式的布局布局契约要求为每个目标幻灯片独立创作每个坐标3. 按需构建仅在用户请求 PPTX 时使用小型任务专属python-pptx构建器不捆绑渲染器或辅助框架见 README.md 的 Boundaries 一节4. 原生对象标题、说明、标签、指标、表格、图表、图示一律用原生对象图片仅作辅助视觉pptx-quality-gates通过有意义的幻灯片内容必须保持原生可编辑对象这一通过标准落实5. 不虚构事实品牌、来源、许可、无障碍等缺失信息不得臆造须指出缺口并请求决策pptx-deck-context规则要求记录来源清单、许可证据6. 生产工件齐备规范、构建记录、来源清单、审计报告与 PPTX 一并交付见下文交付物一节其中第 5 条在pptx-deck-contextSKILL.md中被展开为没有记录许可证据就不复制外部字体、图片、图标或 Logo也不得把长篇幅原始资料原样塞进幻灯片规范而应请求摘要或与决策相关的摘录。三、六步工作流从简报到大纲再到可编辑文件Agent 文档给出六步流程下面结合各配套 skill 展开每一步的实际做法。第 1 步确定受众、决策、素材、页数、语言与品牌方向这是pptx-deck-context技能的决策序列第一步确认受众、决策、幻灯片数量、语言、来源与品牌要求。若用户没有提供叙事框架该技能提供一组可选框架供用户选择且不得静默替用户做决定mckinsey、scqa、pyramid、mece、action-title、assertion-evidence、exec-summary-first、custom。第 2 步准备叙事、来源清单与设计上下文为每个指标、引述、图表数值和事实性主张分配稳定来源 ID并规划source_refpptx-deck-context第 3 条选择有文档记录的设计方向优先用户品牌手册其次只读参考稿证据再次可复用设计档案见下文设计档案在动笔之前把框架、假设、来源清单、调色板、字体、间距与签名元素记录到summary中。设计档案速查详见 design-profiles.mdProfile适用场景设计信号fluent-ui-design-tokens企业及微软生态对齐的演示文稿克制的中性色、清晰的层级、基于 token 的间距、适度的圆角primer-primitivesGitHub 及开发者向演示文稿利落表面、强文本对比、功能性强调色、紧凑标签editorial-minimal高管叙事与研究型演示文稿充足留白、高对比字体、有限调色板、单一视觉母题档案只是设计证据选定后必须把调色板、字体、间距、签名元素锁定进summary.design_context再转换为显式的layout_tree颜色、填充、字体、规则线、卡片外壳与 bbox。第 3 步只读分析参考演示文稿如果提供了参考稿将其作为设计证据只读分析仅当高层级提取无法确立所需事实时才深入检查其 OOXML 包。pptx-reference-deck-analysis技能给出了四种提取模式紧凑提示上下文幻灯片数量与尺寸、文本摘要、形状计数、样式、品牌信号、模板使用与布局节奏完整提取summary、幻灯片与只读layout_tree证据文件夹诊断每份演示文稿一条结果加清单样式母版分析颜色、字体、尺寸分布、母版/版式使用与流模式派生模板目录零基源索引、版式角色、可用区域、占位符、视觉结构与约束。OOXML 底层工具scripts/inspect.py、scripts/unpack.py、scripts/validate_package.py位于 scripts仅在高层提取无法覆盖主题、关系、备注、批注、动画、媒体、母版或版式时使用使用前需按 requirements.txt 安装可选本地依赖defusedxml。安全要求包括绝不在文件名上推断幻灯片顺序、必须相对.rels所有者解析关系目标、用defusedxml解析不可信 XML不启用实体扩展、DTD 加载或网络访问脚本本身也会拒绝路径穿越、符号链接、超大成员与压缩炸弹。第 4 步编写完整 JSON 布局契约这是整套方法论的心脏写出带最终英寸 bbox、z 序、样式、阅读顺序与来源引用的完整 JSON 布局契约。详见 layout-contract.md核心约束包括根 JSON 包含summary与slides每张幻灯片具有稳定id、消息导向的title、可访问性阅读顺序与完整layout_tree布局树声明幻灯片尺寸、根组、以 id 为键的组与对象、最终英寸 bbox、样式、z 索引与分类每个有意义对象具备id、kind、role、classification、content、style、bbox、z_index生产级summary含显式layout_policy安全边距、内容底部、页脚顶部、最小间距与无障碍元数据。下面是契约文档中的完整示例结构{ summary: { layout_policy: { safe_margin: 0.5, content_bottom: 6.7, footer_top: 6.85, minimum_gap: 0.12 }, accessibility: { language: en-US, presentation_title: Quarterly operating review } }, slides: [{ id: s01_overview, title: Operating margin improves after the cost reset, accessibility: { reading_order: [title] }, layout_tree: { slide_size: { width: 13.333, height: 7.5 }, root_group_id: root, groups: { root: { id: root, role: slide, layout_mode: absolute, object_ids: [title], group_ids: [], bbox: { x: 0, y: 0, width: 13.333, height: 7.5 } } }, objects: { title: { id: title, kind: text, role: title, classification: content, content: { text: Operating margin improves after the cost reset }, style: { font_size: 30, color: #111827 }, bbox: { x: 0.75, y: 0.55, width: 10.8, height: 0.65 }, z_index: 2 } } } }] }契约文档强调最终树是审计契约而不是渲染提示。 配套的创作规则还包括正常内容保持在安全边距内并位于页脚轨道之上只有背景layout_design对象允许出血到整页内容文本不小于 9 pt宁可缩短、缩放或拆分稠密内容也不降字号使用共享网格、一致间距、显式颜色、显式字号与有意的 z 序。第 5 步仅选用已批准的辅助视觉素材pptx-visual-assetsSKILL.md规定视觉素材只用于支撑幻灯片信息绝不能压平或替代可编辑内容只有能提升理解时才选择素材类型图标、图片、SVG、图示或信息图放置前确认本地路径、来源、使用权与简洁 alt 文本以最终英寸 bbox、有意的 z 索引与content或layout_design分类加入素材保持宽高比确保没有素材遮挡可读文本、也没有把关键信息锁死在图片里。细则见 asset-guidance.md标题放在图片旁侧空间而非压在图上方视觉素材在 z 序上位于可读文本之下只有干净矢量源才能算可编辑视觉——绝不允许把位图包进 SVG 然后宣称可编辑信息图只是辅助视觉其关键信息必须用原生对象重建。若权限、来源或合适素材不可得宁可省略素材并报告缺口也绝不把占位符当作成品视觉交付。第 6 步构建并审计直到通过或记录例外按需生成每份演示文稿专属的小型构建脚本然后审计演示文稿。构建契约来自pptx-slide-specification要求构建器从空白幻灯片版式出发用Inches(...)映射所有 bbox显式设置换行、禁用自动缩放、文本内边距、锚点、对齐、字体、颜色、线条设置、图片宽高比与隐藏幻灯片状态在添加对象前拒绝零值或负值几何。四、质量闸门通过标准与审计清单pptx-quality-gatesSKILL.md在交付前把关并明确把确定性失败当作修复工作而不是例外。其工作流为确认规范、构建器、PPTX、来源清单与审计路径构建前对坐标契约应用审计清单重新打开 PPTX将幻灯片数量、实际边界、隐藏幻灯片与请求几何和布局树比对生产级演示文稿运行pptx-reference-deck-analysis/scripts/validate_package.py并保存 JSON 报告检查文档语言、幻灯片标题、有意义图片的 alt 文本、阅读顺序、表头与来源引用若环境中已有兼容渲染器检查预览中的裁剪、字体回退、对比度、裁切与层级——不引入渲染器依赖修复规范或任务本地构建器重建并重跑同样的检查。通过标准零内容碰撞、零文本溢出、零不安全内容边界、零无效正几何、零包完整性错误有意义的幻灯片内容保持原生可编辑对象图片仅起辅助作用。手工审计清单详见 audit-checklist.md在构建前检查 10 项、构建后检查 4 项其中值得注意的技术细节内容碰撞判定使用精确的 bbox 相交公式A.x B.x B.w B.x A.x A.w A.y B.y B.h B.y A.y A.hCJK/全角文本按每行字符数减半来预估文本容量来源溯源要求每条有来源的主张具备可解析的来源 ID、定位符、主张类型与核验状态构建后重开包比对实际幻灯片数量、边界、隐藏状态与请求几何并运行 OOXML 包校验器修复格式错误的 XML、断裂关系、内容类型缺口与重复版式链接。修复顺序来自 layout-contract.md也值得记住先移动或缩放 bbox、调整 z 序或拆分稠密幻灯片再缩短文案或扩大文本 bbox改字号永远放在最后且内容不得低于 9 pt最后重建并与契约比对实际对象边界。五、交付物与边界Agent 文档规定当用户请求演示文稿规范时返回严格 JSON否则报告工件路径、假设、审计状态与未决决策使用直接、简洁的业务英语避免占位内容。生产级交付需把以下工件放在一起幻灯片规范spec生成的 PPTX构建记录build record几何审计、可访问性审计与包完整性 JSON 报告来源清单source manifest任何被记录的例外都必须标注幻灯片 ID、对象 ID、责任人、原因与复核日期这一要求同时出现在pptx-quality-gates与 audit-checklist.md 中。插件边界再次强调只生成任务专属的小型python-pptx构建器不附带通用渲染器、不克隆模板、不需要浏览器、不使用 MCP 服务、不需要凭据或在线服务——这保证了该工作流可以离线、可复现地运行在本地工作区中。六、在 agents 仓库中实践阅读本插件的完整说明plugins/pptx-deck-creation/README.md体验各阶段 skill上下文准备 pptx-deck-context/SKILL.md、规范创作 pptx-slide-specification/SKILL.md、参考稿分析 pptx-reference-deck-analysis/SKILL.md、视觉素材 pptx-visual-assets/SKILL.md、质量闸门 pptx-quality-gates/SKILL.md需要 OOXML 底层分析时运行 scripts/inspect.py、scripts/validate_package.py 或 scripts/unpack.py并先按 requirements.txt 安装defusedxml。一句话总结这套方法论的取舍用规范即契约 坐标即事实取代自动排版 全页图片用只读分析与严格审计换取每一张幻灯片都可编辑、可追溯、可修复的生产级质量。【免费下载链接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity项目地址: https://gitcode.com/GitHub_Trending/agents24/agents创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考