ppt-master 模板规划深度指南Strategist Template 模块的复用范围、场景适配与结构化锁规划【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master导读本文聚焦 ppt-master 中 strategist-template.md 这一条件触发模块它负责在 Stage 1 确认并安装 Brand/Style/Layout/Deck 工作区之后把已安装的模板转化为 Stage 2 的推荐方案与执行锁spec_lock.md。读完本文你将掌握模板应用计划的三类输出、template_reuse_scope与template_adherence的推导规则、继承设计的分段优先级以及pptx_structure: structured下 Master/Layout/Slot 锁行的完整规划语法并了解这些规则在源码与 Schema 中的落地形式。1. 模块定位何时加载、由谁触发strategist-template.md是 Strategist 角色strategist.md的条件扩展模块而不是独立工作流。它的核心职责是在 Stage 1 确认通信契约与模板选择并完成安装后指导 Stage 2 的解决方案编写与执行锁生成。触发条件非常严格strategist.md 第 1 节仅当 Stage 1 确认了某个库library或显式explicit工作区选择且确认后的应用阶段把它安装进project_path/templates/或以原地消费方式确认时才加载仅裸模板名、纯风格词、自由设计项目不触发本模块加载时机晚于 Stage 1 确认和安装交接generate-pptx.md Step 4模板检查不是用户确认。安装动作本身由 apply-template-workspace.md 阶段完成其落地工具是 apply_template.py——它一次运行完成根校验、按 kind 限定名映射 spec、解决结构所有者Layout 覆盖 Deck、拷贝所有者 roster 与每个根的images//icons/拒绝目标冲突与重复 kind并在每个拷贝 spec 的 H1 下加一行来源标记。这也解释了本模块为何只读project_path/templates/安装之后库根目录或外部根只是安装输入不再是下游消费源。2. AI 编写的模板应用计划§12.1 输入与输出清单输入每个已安装的project_path/templates/design_spec.kind.id.md都是模板设计源必须全部读取。design_spec.style.*.md标记一个活跃的 Direction / method 段。遗留或不完整的 Layout/Deck 依据 pptx-structure-interface.md §3 被拒绝且绝不修改输入。硬规则——Stage 1 不受影响绝不为了匹配工作区而修改已确认的 Stage 1Stage-1 证据边界见 generate-pptx.md Step 4。输出集中在三个位置输出形式recommendations.stage2.json顶层template_application.value一段精炼的自然语言无模板时省略design_spec.md §I- **Template Application**: prose从已确认的result.json值或精确的聊天回答持久化留空则把决定交还 Strategistspec_lock.md pptx_structure只包含下面 §3 推导出的内部值绝不写入design_spec.md、阶段文件、Confirm UI 或result.json这里的关键是双层输出分离面向人的自然语言计划进design_spec.md §I面向机器执行的结构化值进spec_lock.md。这与 design_spec_reference.md §2.1 的要求一致——design_spec.md是完整的人类可读决策spec_lock.md是其上下文选定的执行子集。2.2 两个核心内部枚举计划需要推导两个内部值均只进spec_lock.mdtemplate_reuse_scope复用哪一层值适用场景mirror工作区replication_mode: mirror计划逐字复用页面且每页只改允许的可见文本值保留视觉与文本节点拓扑layout复用 Master/Layout 系统与原型同时当前项目的内容与外观决策保持开放style仅 Style 工作区激活或只复用沟通/设计方向、颜色、字体、装饰、构图、节奏页面为扁平自由设计template_adherence结构化计划保持还是扩展 Layout 身份值适用场景strict每个结构化页面都契合现有原型契约不改变 Layout 身份或槽位拓扑mirror强制adaptive结构化复用仍有用但至少一页需要所选 Master 下的新显式 Layout这两个枚举在 spec_lock.schema.json 中有完整的机器约束pptx_structure节的template_reuse_scope取值限定style/layout/mirrortemplate_adherence限定adaptive/strict并且structured-pptx、mirror-is-strict、style-is-flat、flat-has-no-structured-mappings等 conditions 会强制模式与复用范围的组合合法性——例如mirror必须同时是mode: structuredtemplate_adherence: strict。2.3 编写流程与判定原则在撰写 Stage-2 方案之前按路径 SHA 加载每个相关资源一次每个已安装 spec 及其 Page Roster、每个完整 Slide 原型Layout 优先否则 Deckmirror 范围中关于省略来源身份的说明是证据不是页面候选清单、apply-template-workspace.md §5 解析出的 Identity/Structure/Reusable Application Context/Direction 所有者、已确认的通信契约与来源义务、每页的计划页数与内容形态以及用户的自然语言指令。然后编写一份计划不提供选项菜单决定对 Layout/Deck完整原型集、子集、还是仅设计语言有用每页从哪个原型起步哪些页跳过、重复或重排内容是直接插入、在现有结构内重组、还是在解析出的 Direction/method 下重建对 Style采纳哪个沟通方法、视觉语言、构图节奏与表达默认值而不发明原型哪些可见元素因用户明确要求而保持字面原样。原型细节不确定时重读已安装的 SVG——绝不依赖记忆、语义标签或来源 PPTX。判定原则强调模板大小是证据不是策略。短模板在内容契合时可以用满每个原型20–30 页的来源可能只贡献几页或被重组成新序列。绝不能仅因为示例内容存在就推断必须全保留或受保护。自然语言指令优先否则依据内容与安装状态决策。文中列举的以参考为驱动的重设计仅增补的冻结仅替换只是常见读法示例不是模式枚举——没有更合适时采用参考驱动。硬规则——Slide 原型驱动编写每个模板 SVG 都是解析了 Master Layout Slide 上下文的完整 Slide 原型这些文件用于page_layouts独立的 Master/Layout 定义 SVG 无效。未被选中的撰写原型仍可为pptx_layouts提供定义mirror 只暴露实际来源 Slide。两阶段边界已安装模板改变最终 Stage 2 的内容绝不改变确认序列。Confirm UI 与聊天兜底都必须按 Stage 1 → Stage 2 顺序执行模板检查不是用户确认。浏览器超时时回到同一阶段继续聊天。3. 场景适配与继承设计§23.1 必须基于 §1 检查做判断kind: deck把保留的 Template Overview 与已确认的受众、意图、结果、交付语境、后续生命周期和来源义务对比再用 Page Roster / SVG roster 与所需叙事角色、内容形态、槽位和容量对比Deck 应用是可复用上下文绝不是当前契约或覆盖项。kind: layout只比较结构角色、槽位与容量。活跃的 Style 段把其沟通方法与当前契约对比把其构图要求与选定的 Layout/Deck 结构对比。出现实质性不兼容时必须浮出水面绝不静默削弱某一段去迁就另一段。只有当资源的 path SHA 变化时才重开资源。三种内部范围的适用时机内部范围何时适用mirror产物重复已知形态字面外观与文本拓扑是需求新内容契合现有角色与槽位layout结构系统与品牌延续但结果需要重排、新强调点或自适应 Layoutstyle只复用方向仅 Style 工作区激活或结果需要不同的序列、密度或构图系统当通信契约与工作区冲突时在 Stage-2 方案中陈述最合适的计划仅在冲突实质限制结果时才浮出冲突不做模式问卷。一句话概括边界模板能力约束什么是合法的场景适配决定什么是有用的。3.2 分段优先级Precedence明确的当前用户指令与最终确认优先。已安装集合每种 kind 至多贡献一个四种可以共存Brand 覆盖 Deck 身份Layout 覆盖 Deck 结构Deck 保留未被 Brand 覆盖的应用上下文与身份无 Layout 时 Deck 拥有结构Style 只拥有 Direction / method其视觉值只是候选默认值让位于已解析的 Brand/Deck 身份其偏好的 Mode / Visual Style 作为最终锁的种子活跃原型与 Deck Signature 事实始终是兼容性约束。这与 templates/README.md 的四类模板分段所有权完全对应Brand 拥有身份、Style 拥有方向/方法、Layout 拥有品牌中立结构、Deck 拥有应用上下文 集成身份与结构。3.3 默认——模板主导的推荐默认策略可因用户或已确认契约的明确要求而覆盖三个方向遵循同一解析出的模板上下文。重复固定 Brand/Deck 调色板角色并用typography.fixed: true补全字体保持已解析的图标/图像约束只变化开放角色或尺寸。design_directions.selected标记最能表达模板拥有结构、视觉语言与应用规则的可行方向。绝不削弱模板使用也不把模板分段拆到多张卡片上制造备选方案。Style Review Focus 不会激活 visual-review.md——只有用户明确请求才会。4. 结构化锁规划§34.1 路由矩阵计划锁行仅 Style 或 Style Brandpptx_structure.mode: flattemplate_reuse_scope: style省略template_adherence与所有结构化映射节mirror/layoutpptx_structure.mode: structuredtemplate_adherence: strict\|adaptivemirror 恒为strict无遗留的baseline、template、preserve、layout_strategy或 Layout-kind 行Style 与 Layout/Deck 并存时只改变 Direction / method绝不强制 flat/structured 路由字面mirror计划仅在 Style 段不要求任何视觉或拓扑变化时才兼容。4.2 四类映射节的语法Master roster每个 Master 一行master_key: picker name从工作区 roster 复制。key 是 1–64 个 ASCII 字母/数字/点/下划线/连字符以字母或数字开头空格只属于 picker 名。Master 视觉是根级原子绝不在g内。可复用 Layout roster每个唯一 Layout 一行layout_key: master_key | PowerPoint layout name | prototype source。每个已安装template:basename都是完整 Slide 原型包括未被本套片选中的新的自适应 Layout 使用其首个生成的PNN。仅当固定原子与槽位 id/类型/索引/边界/绑定模式完全一致时才复用 key。key 按构图命名不按页面主题命名。零槽位 Layout 合法不要制造空的utilitykind 或全页假槽位。页面分配每页恰好一行page_pptx_layouts每个 key 必须存在于pptx_layouts。检查不同构图不会塌缩成仅按角色命名的 key一个骨架不会拆成主题专属 key。槽位规划每个可复用槽位是直接根g id带data-pptx-placeholder从安全区、栏、面板内边距或媒体框推导正向设计区边界绝不从示例文字墨迹推导且恰好一个兼容的直接载体。真正的复合区域只用显式objectproxy降级。自适应细化初始定义完整。若构建显示可复用框架或槽位拓扑/边界必须变化回到 Strategist 增加一个以该页为来源的定义并先更新其分配再继续执行。Executor 绝不改变契约导出只编译已声明的结构。输入原型每页一行page_layouts使用完整 Slide 原型。strict 保留该 SVG 的契约adaptive 保留其 Master 且可声明新输出 Layoutmirror 保留撰写的视觉与文本节点拓扑JSON-first 的 Chart/Table 只可再生成其派生预览子节点。可视化兼容性仅当原型外壳能承载 §IX 的实际信息模型时才把page_layouts与可选的 Chart/Tablepage_visualizations搭配使用参考不改变 Layout 身份、槽位拓扑或可视化类型。定性关系留在 §IX在 Slide 本地构图。无精确匹配时adaptive 从最接近的中性原型起步并声明输出 Layoutstrict 选择现有兼容 Layout 或修订大纲。结构化路由绝不省略page_layouts也不写遗留的page_charts。4.3 与锁 Schema 的机器级对应上述语法在 spec_lock.schema.json 中是可验证的pptx_masters/pptx_layouts/page_pptx_layouts的 key 模式均为^[A-Za-z0-9][A-Za-z0-9._-]{0,63}$pptx_layouts的值强制key | 名称 | prototype source三段template:basename或PNNpage_layouts的值模式^[A-Za-z0-9._-]$且page-input-prototype引用通过templates/{value}.svg资产路径解析——即page_layouts行必须对应一个真实存在的模板 SVG basenamepage_pptx_layouts的每个 key 必须解析到pptx_layouts中已声明的 keypage-pptx-layout引用layout-master引用把pptx_layouts的第一段约束到pptx_masters。因此本文 §3 的规划不是自由写作而是受 spec_lock_reference.md §3–4 语法约束、可由 project_manager.pyvalidate命令python3 skills/ppt-master/scripts/project_manager.py validate project_path机器校验的结构化产出。该校验会报告未知节、非法枚举、畸形页面 key、缺失目录资产和断裂的结构化 Layout 引用但不检查语义投影——那是 Gate 2 的职责。5. 与执行链的衔接模板规划的结果最终落到 Executor 的编写动作上。generate-pptx.md Step 6 明确在mirror/layout路由下页面编写从完整的page_layoutsSVG 起步保留继承视觉、根身份、原子与槽位strict 保留契约layout可在不变的槽位边界内重排载体文本adaptive 使用 Strategist 声明的 Layout。所需原子或槽位变更返回上游Executor 永不编辑spec_lock.md——这与 strategist-template.md §3 的Executor 绝不改变契约相互印证。导出端同样只编译声明结构flat导出物化一个干净的项目自有 Master 加一个 Blank Layout所有对象保持 Slide 本地structured只编译声明的根身份、原子固定层与槽位组pptx-structure-interface.md §1从不推断 Layout 家族、聚类页面或推断占位符。6. 常见误用与边界提醒模板检查 ≠ 用户确认安装模板后必须按原序列继续 Stage 1 → Stage 2绝不因已选模板跳过确认内部值不对外暴露template_reuse_scope/template_adherence只进spec_lock.md绝不出现在 Confirm UI、result.json或design_spec.md中面向用户的只有 §I 的自然语言Template Application行绝不把裸模板名当证据Stage 1 的通信契约推荐只基于用户请求、来源事实与项目初始化状态模板候选路径、索引摘要、spec/原型/资产在确认前都不是证据遗留契约不原地升级baseline|template|preserve模式、layout_strategy、data-pptx-layout-kind、distilled/utility等遗留结构是生成/导出输入之外的对象需通过 create-template.md 建立全新工作区绝不修补模板大小不是策略短模板可全用长模板可少用——保持/保护判断永远来自内容契合度与用户指令而不是存在即保留。结语strategist-template.md把用模板这一决策拆成了清晰的三层面向人的应用计划§1 输出 prose、面向场景的继承判断§2 优先级与默认推荐、面向机器的结构化锁§3 的pptx_structure映射。三者分别落在recommendations.stage2.json/design_spec.md §I与spec_lock.md中由 spec_lock.schema.json 和 project_manager.py 提供机器校验最终在 generate-pptx.md Step 6 由 Executor 依据page_layouts原型逐页落实。理解这条从安装 → 规划 → 锁 → 编写 → 导出的链路是正确使用 ppt-master 模板体系的关键。【免费下载链接】ppt-masterAI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations,>项目地址: https://gitcode.com/GitHub_Trending/ppt/ppt-master创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考