PPTX Deck Context 技能实战如何为可编辑演示文稿锁定叙事、来源与设计上下文【免费下载链接】agentsMulti-harness agentic plugin marketplace for Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Google Antigravity项目地址: https://gitcode.com/GitHub_Trending/agents24/agents在生成任何 PPTX 坐标或幻灯片对象之前先完成叙事、来源与设计上下文的准备工作是保证演示文稿可审计、可编辑、可复用的关键一步。本指南以 plugins/pptx-deck-creation/skills/pptx-deck-context/SKILL.md 为骨架结合仓库内pptx-deck-creation插件的其余技能与源码深入讲解该技能的决策序列、五类规则以及summary上下文记录的落地方式。读完本文你将掌握一套完整的坐标前准备工作流确认需求、选定叙事框架、规划来源 ID、确定设计方向并把所有假设固化进可审计的上下文契约中。一、技能定位在坐标绘制之前完成的三件事pptx-deck-context是pptx-deck-creation插件工作流中的前置阶段技能。其职责用一句话概括Prepare the deck before coordinates or PPTX objects are authored. This skill owns the business narrative, source lineage, and design lock.即它拥有并管理三样东西——商业叙事business narrative、来源血统source lineage与设计锁定design lock。任何 slide 的坐标bbox、样式style、分组group都必须在叙事、来源、设计这三个上下文确定之后才能开始创作。在仓库的pptx-deck-creation插件中本技能处于整条流水线的第一环。参照 pptx-deck-creation-builder.md 的工作流后续环节依次是建立受众、决策、素材、页数、语言与品牌方向即本技能的输入准备叙事、来源清单与设计上下文本技能主体若提供了参考 deck则以只读方式分析它见pptx-reference-deck-analysis编写完整的 JSONlayout_tree坐标契约见pptx-slide-specification选择经批准的辅助视觉素材见pptx-visual-assets按需构建 PPTX 并审计见pptx-quality-gates。因此本技能的输出将直接决定后续summary与layout_tree中的design_context、来源引用source_ref与内容文本是整个可审计工作流的源头。二、决策序列Decision sequence五步准备法SKILL.md 定义了严格有序的五步决策序列每一步都有明确的产出物步骤 1确认受众、决策、页数、语言、来源与品牌要求确认项说明audience受众是谁决定叙事粒度与术语密度decision本 deck 要推动的关键决策决定论据结构slide count页数约束决定信息密度上限language文档语言影响后续 accessibility 元数据与 CJK 排版判断sources可用素材清单决定来源清单source manifest的构成brand requirements品牌指南或品牌约束决定设计方向的优先级这一步骤与 pptx-slide-specification/SKILL.md 中 生产环境summary必须包含明确的layout_policy与 accessibility 元数据 的要求相衔接——语言与演示文稿标题会在summary.accessibility中被正式记录。步骤 2选择叙事框架且不得静默选择规则很硬如果用户没有指定叙事框架必须主动提供选项供用户选择不能自行悄悄决定。SKILL.md 明确列出的可选框架为mckinsey麦肯锡式金字塔原则驱动的自上而下论证scqaSituation-Complication-Question-Answer情境-冲突-问题-答案pyramid金字塔原理先结论后论据meceMutually Exclusive, Collectively Exhaustive相互独立、完全穷尽的结构化分组action-title行动式标题每页标题直接陈述行动或结论assertion-evidence论断-证据标题为论断正文为证据图表exec-summary-first执行摘要优先先给结论摘要再展开custom自定义框架之所以不允许静默选择是因为框架决定了标题写法例如action-title框架要求行动式标题而pptx-slide-specification中规定每个 slide 都要有 message-led title、论据排布与分页逻辑属于必须在坐标前定死的叙事锁定。步骤 3为每个指标、引述、图表数值与事实性论断分配稳定的来源 ID 与source_ref这一步是来源血统source lineage的落点。要求在创作任何幻灯片之前为每个指标metric每条引述quotation每个图表数值chart value每个事实性论断factual claim分配稳定的来源 IDstable source ID并规划source_ref。其验收标准与 pptx-quality-gates/references/audit-checklist.md 的第 9 条一致被引用的论断必须有可解析的来源 ID、定位符locator、论断类型claim type与验证状态verification status。也就是说此处规划的source_ref会在后续质量门禁中被逐一校验无法解析的来源引用会被判为审计失败。步骤 4确定有据可依的设计方向设计方向的优先级是明确的递进关系优先使用用户品牌指南user brand guide——最权威的设计证据其次使用只读参考 deck 证据——通过pptx-reference-deck-analysis技能对参考 deck 提取设计信号再次使用references/design-profiles.md中的可复用设计档案。SKILL.md 末尾给出指引Seereferences/design-profiles.mdfor reusable profile guidance。步骤 5在summary中记录框架、假设、来源清单、调色板、排版、间距与标志性元素最后一步把所有上下文固化到summary中覆盖framework叙事框架assumptions假设source manifest来源清单palette调色板typography排版spacing间距signature elements标志性元素这一步与layout-contract.md中summary的结构直接对应summary含layout_policysafe_margin、content_bottom、footer_top、minimum_gap与accessibilitylanguage、presentation_title而设计锁定则记录在summary.design_context中见下文。三、五条核心规则解读规则 1一页一信息按框架要求使用行动式标题One slide should communicate one message, with an action-style title where the framework calls for it.这一条在后续layout-contract.md中有具体体现示例中 title 对象的内容是 Operating margin improves after the cost reset就是一个结论式/行动式的标题。而pptx-slide-specification要求每个 slide 有 message-ledtitle正是本规则的契约化。规则 2设计参考只是设计证据不是内容或素材来源Treat design references as design evidence, not content or asset sources.参考 deck 提取出来的是布局节奏、色彩、排版信号而不是可以直接搬用的文案、图片或数据。这与pptx-reference-deck-analysis技能的核心理念一致它never copies, clones, or mutates a source deck且independently author every target-slide coordinate。规则 3没有记录许可证据不得复制外部字体、图片、图标或 LogoDo not copy external fonts, images, icons, or logos without recorded licensing evidence.版权与许可问题在设计上下文中被前置处理。pptx-visual-assets/SKILL.md 同样要求Confirm the local asset path, source, usage rights ... before placement若权利、来源或合适素材不可用则省略该素材并报告缺口gap绝不用占位图冒充成品视觉。规则 4把设计信号翻译成显式的填充、排版、间距与 bbox不依赖自动布局引擎Translate design signals into explicit fills, typography, spacing, and bboxes; do not rely on an automatic layout engine.这是整个插件spec-first哲学的基石。pptx-slide-specification中明言No renderer may decide placement, shrink text, or infer layout after the auditlayout-contract.md也称最终树是an audit contract, not a rendering hint。任何设计意图都必须成为显式的数值颜色color、字号font_size、间距minimum_gap、坐标bbox。规则 5长素材要压缩索要摘要或与决策相关的节选Keep long source material concise. Ask for a summary or decision-relevant excerpt instead of turning a deck spec into a document dump.这是对信息来源的瘦身原则deck 规格是决策工具不是文档转储。长文档应提炼为摘要或与决策直接相关的摘录否则会污染summary与后续内容创作。四、设计档案references/design-profiles.md详解SKILL.md 明确指向的references/design-profiles.md提供了三个可复用的设计档案均作为设计证据使用并在坐标创作前将调色板、排版、间距与标志性元素锁定进summary.design_contextProfile最佳适用场景设计信号fluent-ui-design-tokens企业级与 Microsoft 对齐的 deck克制的中性色、清晰的层级、基于 token 的间距、适度的圆角primer-primitivesGitHub 与开发者向 deck利落的表面、强文本对比、功能性强调色、紧凑标签editorial-minimal高管叙事与研究型 deck大量留白、高对比字型、克制的调色板、单一视觉母题使用档案的规则优先级优先显式用户品牌指南其次只读参考 deck 证据最后才是档案记录要求记录档案 ID、适用时的来源 URL、已知许可信息以及由此产生的样式锁定style lock灵感边界公开设计信号仅作灵感不得复制专有图片、Logo、字体、截图或幻灯片内容落地要求将锁定翻译为layout_tree中显式的颜色、填充、排版、规则线、卡片外壳与 bbox。这里体现了设计上下文design context从抽象信号到具体数值的完整翻译路径也呼应了pptx-quality-gates审计清单第 4 条summary.design_context必须命名一个样式锁定或经批准来源除非用户显式要求否则拒绝默认主题的纯标题-要点输出。五、上下文如何在后续流水线中被消费本技能的产出并非孤立文档而是会被整条链路持续校验与消费summary契约layout-contract.md定义了 JSON 根节点包含summary与slides。其中summary.layout_policy的示例值safe_margin: 0.5、content_bottom: 6.7、footer_top: 6.85、minimum_gap: 0.12即本技能步骤 5 中间距上下文的正式数值化形态summary.accessibility.language对应步骤 1 确认的语言。来源引用校验本技能规划的source_ref会在pptx-quality-gates中按 audit-checklist.md 第 9 条被逐条解析验证。设计锁定校验审计清单第 4 条会检查summary.design_context是否存在样式锁定第 5 条检查内容是否落在安全边距内、是否在页脚轨道之上只有layout_design分类对象可以出血铺满。叙事框架约束步骤 2 选定的框架会约束每个 slide 的 message-led title 写法而标题质量属于审计范围内slide 标题、可访问标题均被检查。六、实战工作流小结将本技能嵌入一次完整的 deck 生成一个可落地的调用序列是1. 向用户确认受众、决策、页数、语言、素材与品牌要求 2. 若用户未指定叙事框架列出 8 种框架选项请用户选择 3. 遍历素材为每个指标/引述/数值/论断分配 source ID 并规划 source_ref 4. 按品牌指南 只读参考 deck 证据 design-profiles 档案的优先级确定设计方向 5. 将 framework、assumptions、source manifest、palette、typography、spacing、 signature elements 全部写入 summary含 design_context 样式锁定 6. 进入 pptx-slide-specification 编写 layout_tree 坐标契约 7. 进入 pptx-quality-gates 执行构建前后双重审计其中summary.design_context中锁定风格时应记录档案 ID、适用来源 URL如适用、已知许可信息与最终样式锁定依据见 design-profiles.md。七、关键结论与可继续深入的文件pptx-deck-context技能的最终价值在于把讲故事、引证据、定风格这些易被跳过或模糊化的前置决策变成有明确顺序、明确产出与可审计验收标准的工程步骤。它通过summary契约把叙事框架、来源血统与设计锁定传递给下游的规格编写、构建与质量审计从而保证生成的 PPTX 是可编辑、可审计、可复用的生产级产物而非一次性渲染结果。想深入理解上下游衔接可以继续阅读仓库中的以下文件SKILL.md本技能 与 design-profiles.md设计档案pptx-deck-creation-builder.mdBuilder Agent 完整工作流layout-contract.mdsummary 与 layout_tree 的 JSON 契约与修复顺序audit-checklist.md构建前/构建后完整审计清单pptx-reference-deck-analysis参考 deck 只读分析即设计证据的来源工具pptx-visual-assets辅助视觉素材的许可与放置约束插件 README插件边界与依赖说明【免费下载链接】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），仅供参考
