演示文稿技能（Presentation Skill）

演示文稿技能 (Presentation Skill)

基于仓库的 PowerPoint 技能，用于生成可编辑、对齐且经过质量检查的 .pptx 演示文稿。模型负责规划故事和视觉策略；脚本处理脆弱的渲染、暂存和验证工作。

何时调用此技能

在以下情况下触发此技能：

• 根据单次提示（快速创建模式，无需工作空间）构建一次性 PowerPoint .pptx、幻灯片组或演示文稿
• 根据结构化的 outline.json 生成 .pptx
• 重新设计、重建或扩展现有的演示文稿
• 创建实验室、临床、科学、董事会、投资者或编辑类演示文稿
• 对生成的演示文稿进行布局、设计或可读性 QA
• 创建或更新可复用的演示文稿工作空间
• 将 CSV/TSV/XLSX/JSON 数据转换为可直接放入幻灯片的图表和表格

快速创建模式适用于一次性生成 5-10 张幻灯片的场景。工作空间模式适用于需要后期迭代、审计或重建的演示文稿。详情请参阅下方工作流部分的 ### Quick Deck 和 ### Saved Workspace。

请勿在仅需纯文本头脑风暴（不需要生成演示文稿产出物）时调用它，也不要在拥有可用的工作空间源文件时直接编辑生成的 .pptx（应修复源文件）。

技能名称：presentation-skill。用于模糊技能匹配的兼容别名：powerpoint-deck-builder、pptx-skill、PowerPoint skill、PPTX skill、slide-deck generator、slides generator、deck builder、presentation generator、presentation maker、PowerPoint generator、Codex presentation skill、ChatGPT presentation skill、OpenAI agent presentation skill。

不可妥协的原则

• 禁止编写临时的内联 python-pptx 或 pptxgenjs 演示文稿代码。应编写 outline.json 并运行仓库脚本。
• 在生成演示文稿期间不要重新安装依赖项。如果缺少依赖项，请报告并停止。
• 对于需要交付的演示文稿，不可跳过 QA。如果 LibreOffice 不可用，请使用无渲染 QA。
• 对于可复用/报告的演示文稿，将 validate_planning.py 中关于缺少成品注册表、过时的生成产出物、图形重建命令、可读性合同、速度合同、QA 合同、验收证据或执行阶段的警告视为源规划反馈，需要在最终交付前修复。
• 修复源文件（outline.json、规划文件、资产、渲染器代码），而不是修改后的 .pptx 成品。
• 对于新的主题，请从头搭建。不要克隆另一个演示文稿的结构作为固定风格。

首先阅读的文件

• DESIGN.md：简洁的设计合同、颜色、层次结构、对齐规则、生成图像的披露声明。
• references/outline_schema.md：接受的 outline.json 字段及其变体。
• references/planning_schema.md：design_brief.json、content_plan.json 和 evidence_plan.json 的结构。
• references/deck_workspace_mode.md：工作空间模式的保存工作流。
• references/agent_picker.md：供智能体和用户使用的简洁选择指南。
• references/reference_script_patterns.md：来自更强大的一次性脚本的可复用 PPTX/DOCX/图形模式；在改进路由、科学演示文稿或配套文档工作流时阅读。
• references/style_reference_catalog.md：安全的样式引用策略，用于使用公共演示文稿、截图、PPTX 语料库和合成重建，而无需打包专有材料。
• references/dynamic_design_and_subagents.md：有边界的动态设计调节，以及何时使用内容、数据、路由、批评和 QA 子智能体。
• references/visual_qa_prompt.md：视觉审查包和新视角检查提示。
• scripts/emit_deck_start_packet.py：可复用演示文稿的首选第一个回合数据包；打包了一个简洁的用户问题负载、可重现的设计合同提示和分阶段子智能体交接命令。
• scripts/emit_deck_intake_prompt.py：可选的面向用户的输入收集提示，用于收集受众、风格、调色板、密度、背景、资产、来源和约束条件，当个性化信息不明确时使用。
• scripts/apply_deck_intake_answers.py：从 Codex 问答卡片答案到 design_brief.user_intake、style_seed、笔记和规划文件源策略/资产配置的决定性桥梁。
• scripts/run_deck_start_intake_smoke.py：针对第一个回合的启动数据包、版本化智能体启动简报、持久的输入收集答案、预答案就绪 record_deck_intake_answers 触发器、确定性应用、幂等性和 deck_intake 摘要的就绪状态进行重点快速冒烟测试。
• scripts/emit_design_contract_prompt.py：在用户请求或输入收集答案之后，创建 outline.json 之前要立即运行的可重现样式/结构合同提示。
• scripts/apply_design_contract.py：从返回的 deck_design_contract_v1 JSON 数据包到 design_brief.json、content_plan.json、evidence_plan.json、asset_plan.json 和 notes.md 的决定性桥梁。
• scripts/run_design_contract_apply_smoke.py：针对设计合同提示、输入收集种子选择丰富化、确定性合同应用、幂等性、规划验证和 design_contract 就绪摘要的重点快速冒烟测试。
• scripts/emit_outline_authoring_prompt.py：在 design_contract.json 应用后，用于用创作好的幻灯片替换起始 outline.json 并同步对齐内容/证据/资产计划编辑的合同感知交接提示。
• scripts/apply_outline_authoring_handoff.py：从返回的 outline_authoring_handoff_v1 JSON 数据包到 outline.json、content_plan.json、evidence_plan.json、asset_plan.json 和 notes.md 的决定性桥梁。
• scripts/run_outline_authoring_handoff_smoke.py：针对合同感知的大纲提示、确定性交接应用、源计划对齐、就绪摘要、PPTX 构建和大纲感知的无渲染 QA 的重点快速冒烟测试。
• scripts/run_reproducible_workflow_smoke.py：针对演示文稿启动、输入收集、设计合同、大纲交接、严格的无渲染 QA 和交付就绪交接路径的端到端快速冒烟测试。
• scripts/run_focused_workflow_checks.py：针对可重现工作流、风格混合、布局优化、源页脚和生成数据通道的聚合快速冒烟运行器；可以并发独立运行检查，同时写入一份紧凑的 JSON 报告，其中包含每次检查的持续时间和失败详情。
• scripts/extract_pptx_style.py：仅基于源的 PPTX/语料库样式提取器，输出观察到的页眉/页脚/颜色/可读性信号以及用于模板启发式演示文稿的可复用 design_brief.json 片段。
• scripts/apply_pptx_style_fragment.py：从提取的 PPTX 样式片段到 design_brief.json、renderer_treatments、style_import 和 notes.md 的决定性桥梁。
• scripts/style_reference_catalog.py：合成安全的样式 DNA 和内容处理参考，适用于每个预设，包括标题、比较、图表、表格、图形、仪表板、决策和参考文献行为，以及 style_reference_mix_plan_v1 提示匹配器、style_reference_layout_playbook_v1 变体映射、style_reference_structural_motif_library_v1 主题语法、style_reference_metric_profile_v1 密度/空白/对象偏差指标以及 style_reference_content_recipe_library_v1 内容槽配方，这些用于设计合同和大纲创作提示。
• references/style_reference_sources.json 和 scripts/style_reference_sources.py：用于公共演示文稿、截图、PPTX 语料库和模板集锦灵感的发布安全源输入清单和验证器。在添加或引用外部样式参考之前使用；它会记录许可证说明、源验证证据、允许的提取模式、禁止的材料、通用样式观察、可复用的幻灯片模式提取、归属声明以及每个预设的合成重建路径。
• references/style_inspiration_corpus.json 和 scripts/style_inspiration_corpus.py：用于公共设计系统、演示工具、模板索引和幻灯片设计启发法的纯描述性灵感语料库。将其用作可扩展的源索引层，用于提示到风格的映射和子智能体探索；它存储权利状态、提取限制、布局/调色板/排版描述符、每个预设的路径以及安全规则，即不打包原始演示文稿、截图、标志、专有文本或独特的复制几何图形。
• references/large_style_corpus_sources.json、references/large_style_corpus_catalog.json 和 scripts/large_style_corpus.py：用于真实世界风格发现的纯描述性大型公共演示文稿语料库层。用它来索引 2,000 多个公共/开源的类似演示文稿的记录，平衡重叠，优先选择 AI 代理/工具示例，输出紧凑的 LLM 上下文，并用原始的合成结构替换看起来重复的预设处理。它只存储公共 URL、仓库/路径元数据、推断出的样式系列和描述符；绝不存储原始演示文稿、截图、复制的幻灯片文本、标志或独特的源几何图形。
• references/style_token_atlas.json、references/style_grammar_index.json、scripts/style_atom_router.py、scripts/apply_atom_composition.py 和 scripts/workflow_atom_context.py：动态语料库-原子语法层。当演示文稿需要语料库来影响结构、处理池、密度和叙事弧线，同时仍然让当前/未来的 LLM 自由做出适合主题的选择时使用它。正常的演示文稿启动、设计合同和样式/内容路由提示现在会收到一个 normal_workflow_atom_context_v1 种子，可以接受、通过严格的 JSON 进行细化，或记录原因后跳过。仅应用支持渲染器字段。
• scripts/run_large_style_corpus_smoke.py：重点快速冒烟测试，证明大型语料库源清单、描述符模式、系列覆盖、紧凑上下文和摘要编写器在无需网络访问的情况下保持可用。
• scripts/run_style_atom_router_smoke.py：重点快速冒烟测试，证明原子图谱、语法模板、确定性回退、主题感知排名、严格的 JSON 原子提示和应用器重放分类账保持可用。
• scripts/build_large_style_corpus_contact_sheets.py：从大型语料库描述符生成的发布安全视觉联系表。它仅从目录元数据中绘制合成的系列和源记录卡片；它不获取、渲染或截图源演示文稿。
• scripts/run_large_style_corpus_leverage_smoke.py：重点冒烟测试，证明 2,000 条记录的语料库确实被路由提示和联系表证据使用，同时保留了精选的样式参考提示令牌。
• scripts/design_catalog_selector.py：可复用的 v0.5 设计目录选择层，将提示映射到主题案例、语料库系列、处理 DNA、生成数据配方和可重现的发布证据范围。
• scripts/build_random_topic_comparison_decks.py：发布证据构建器，用于八个随机合成主题，每个主题都构建为基线演示文稿和经过描述符语料库引导的演示文稿，跨越八种明显不同的语料库系列，以及渲染的联系表、画廊演示文稿、生成的数据/图表/表格成品、清单指标、结构差异签名和简洁的发布说明。
• scripts/run_random_topic_comparison_smoke.py：可重现性冒烟测试，在临时目录中重建随机主题比较证据，如果缺少 16 个演示文稿、画廊、清单、发布说明、非空联系表、语料库上下文指标、八个系列覆盖、三个生成的数据示例、结构 QA 门控、零视觉/可读性警告或基线对比语料库结构差异，则测试失败。
• scripts/build_style_reference_gallery.py：生成的参考画廊演示文稿，将合成样式目录转换为实际的标题、仪表板、比较、图表、表格、图形、决策和参考文献幻灯片，而无需打包外部模板资产。画廊摘要记录每个预设的变体序列、结构玩法签名、结构主题签名、内容配方签名、渲染器处理签名、处理桶、渲染的联系表路径、每种处理的联系表路径、每个预设的联系表集合（overview、data_evidence 和 decision_sources）以及用于发布证据的 QA 总计。
• scripts/run_style_reference_gallery_smoke.py：重点快速冒烟测试，证明所有预设的样式参考画廊演示文稿保持唯一的内容签名、所需的处理覆盖、发布安全元数据和干净的无渲染 QA。
• scripts/run_style_reference_resolution_smoke.py：所有预设的构建时解析器冒烟测试，证明相同的通用证据幻灯片可以解析为预设特定的 build/outline_resolved.json 变体，并具有唯一的处理签名。
• scripts/run_style_content_router_smoke.py：重点快速冒烟测试，证明样式/内容路由提示包含排名的样式参考匹配、混合计划上下文、布局玩法、内容配方、渲染器处理池，以及可选的用于提示到参考路由的一级原子组合路径。
• scripts/run_style_reference_release_evidence_smoke.py：可选的渲染发布证据冒烟测试，证明全预设画廊具有干净的 QA、唯一的内容签名、视觉多样性哈希、指纹联系表、每个必需处理键的渲染幻灯片证据，以及每种处理的渲染缩略图和粗略布局签名，使得看起来重复的处理系列在发布证据中可见并被阻止。
• scripts/run_style_reference_starter_smoke.py：所有预设的启动冒烟测试，证明初始化的 style_reference_starter_outline_v1 工作空间保持不同的脚手架签名、发布安全的源元数据、启动资产和干净的无渲染 QA。
• scripts/style_treatment_profiles.py：所有可加载预设的支持标题/强调色、页脚、图表以及图形/表格池的可复用预设处理配置文件。配置文件包含一个 style_reference_catalog_v1 参考，以便智能体获得...