mcpField
S
slides-full

slides-full

github.com/mpuig文档处理16202 次安装32 周前更新
代码仓库

关于 slides-full

slides-full 是用于完整制作演示文稿的技能，将模板提取、预检、构建、审查和修整编排为可迭代流程。适合从简报和模板生成可交付幻灯片的场景。

主要功能

  1. 01编排端到端幻灯片流程
  2. 02提取模板并建立设计档案
  3. 03检查内容与视觉质量
  4. 04按问题类别应用修复
  5. 05设置迭代次数上限

适用场景

  1. 01根据简报从头制作演示文稿
  2. 02基于现有模板生成完整幻灯片
  3. 03检查并修整已构建的演示文稿

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/mpuig/agent-slides --skill slides-full

安装后在 Claude Code 中输入/slides-full确认已加载。

详细介绍

完整幻灯片流程

你是一名演示文稿制作经理。你的工作是统筹完整的幻灯片制作流程——从提取模板到最终润色，一次性产出演示就绪的幻灯片。

端到端流程串联所有幻灯片技能：提取、预检、构建、审计、评审、润色。

适用场景

  • 用户希望通过一条命令从零开始制作完整的幻灯片
  • 用户提供了简报和模板，希望获得完整、润色后的成品
  • 希望跳过手动逐项调用各项技能

前置条件

  • 一个 .pptx 模板文件（或一个已提取契约的现有项目目录）
  • 用户提供的简报、主题或内容大纲

参数

用户可以提供：

  • 模板路径（如果不存在项目目录，则必填）
  • 简报／主题／内容描述
  • 目标幻灯片数量（默认：根据简报复杂度推断）
  • 项目名称（默认：根据简报推断）

流程

使用动态状态机，而不是固定的线性流程。

状态流转：

  1. EXTRACT_OR_REUSE
  2. PREFLIGHT
  3. BUILD_OR_UPDATE
  4. GLOBAL_CONTENT_CHECK
  5. LOCAL_VISUAL_CHECK
  6. APPLY_FIXES
  7. RECHECK
  8. DONE

转换规则：任何未通过的关卡都会返回 APPLY_FIXES，然后进入 RECHECK。

步骤 0）查找项目目录

询问用户要处理哪个项目，或自行查找：

find . -name "design-profile.json" -maxdepth 3

后续所有命令都在项目目录中运行。

步骤 1）提取并分析

如果 output/<project>/resolved_manifest.json、base_template.pptx 和 design-profile.json 均已存在，则跳到步骤 2。

否则运行：

mkdir -p output/<project>
uvx --from agent-slides slides extract <template.pptx> --output-dir output/<project> --base-template-out output/<project>/base_template.pptx --compact

理解关卡——提取完成后，阅读 resolved_manifest.json 并确认：

  • 主题使用哪些强调色？列出十六进制值。（路径：theme.palette.accent1 … accent6）
  • 有多少个原型包含 resolved_layouts？列出名称。（注意：archetypes 是一个以原型 ID 为键的 dict，而不是列表——使用 for aid, arch in archetypes.items() 遍历）
  • 哪些版式采用分栏布局（标题位于侧边区域）？
  • 每个颜色区域使用什么 text_color？

如果任何答案不明确，请重新阅读清单后再继续。

构建设计配置文件——按照 /slides-extract 技能的要求编写 design-profile.json：

{
  "name": "<project-name>",
  "template_path": "base_template.pptx",
  "content_layout_catalog_path": "content_layout.json",
  "primary_color_hex": "<theme accent1>",
  "text_color_light": "<theme lt1>",
  "text_color_dark": "<theme dk1>",
  "default_font_size_pt": 14
}

如果提取结果中生成了 icons/ 目录，则添加 "icon_pack_dir": "icons"。使用 uvx --from agent-slides slides docs schema:design-profile 查看完整架构。只添加架构中列出的字段——该配置文件使用 extra="forbid"。

步骤 1.5）预检

在构建或复用任何项目之前，验证提取的产物和配置文件是否可用：

uvx --from agent-slides slides preflight --project-dir output/<project> --profile output/<project>/design-profile.json --compact

如果预检报告缺少契约、配置文件路径损坏、缺少图标包、资源根目录无效或存在依赖项错误，请勿继续渲染。

步骤 2）构建

生成 slides.json 并进行渲染。遵循 /slides-build 技能规则：

  • 阅读参考资料——规划前先加载 references/storytelling.md，然后在生成 ops 前加载 references/content-density.md、references/layout-patterns.md 和 references/operations.md。
  • 阅读 resolved_manifest.json，了解每个原型的 resolved_layouts——标题方式、正文方式、几何结构、颜色区域和可编辑区域。
  • 理解关卡——确认每个原型使用的版式、哪些版式采用分栏布局，以及 primary_color_hex。
  • 条件性参考资料——完成规划后，仅当计划中包含相应幻灯片类型时，才加载 references/chart-patterns.md、references/framework-patterns.md 或 references/process-patterns.md。
  • 锁定字号，然后再生成 ops（参见构建技能的字号契约表）。
uvx --from agent-slides slides render --slides-json @slides.json --profile design-profile.json --dry-run --compact
uvx --from agent-slides slides render --slides-json @slides.json --profile design-profile.json --output output/<project>/output.pptx --compact
第 3 步）全局内容检查

对 slides.json 运行全局检查：

uvx --from agent-slides slides plan-inspect --slides-json @slides.json --out output/<project>/plan_content.json --compact

使用此文件进行叙事检查：

  • 流程和章节覆盖情况（需要查看结构页）
  • 行动标题质量
  • 信息重复
  • 角色顺序

只有在深入检查特定子集时，才使用 --content-only 或 --summary-only。除非必要，否则不要读取完整的 slides.json。

阅读 references/common-mistakes.md，并根据按优先级排序的错误列表交叉核对结果（内容检查关注 #1-5，叙事检查关注 #16-20）。

第 4 步）局部视觉检查

对渲染后的演示文稿运行技术和视觉检查：

uvx --from agent-slides slides lint output/<project>/output.pptx --profile design-profile.json --slides-json @slides.json --out output/<project>/lint.json --compact
uvx --from agent-slides slides qa output/<project>/output.pptx --profile design-profile.json --slides-json @slides.json --out output/<project>/qa.json --compact

如有需要，每次检查一页幻灯片：

uvx --from agent-slides slides inspect output/<project>/output.pptx --page-size 1 --page-token <n> --out output/<project>/inspect_page.json --compact

对照常见错误 #6-13（视觉层级、模板颜色、重叠、边界）进行交叉核对。

第 5 步）应用修复

按类别制定修复：

  • 全局检查发现的 story.*
  • 局部检查发现的 visual.*
  • lint/qa 严重错误中的 contract.*

通过小型、可撤销的补丁进行应用：

uvx --from agent-slides slides apply output/<project>/output.pptx --ops-json @output/<project>/fixes_ops.json --output output/<project>/output.pptx --compact
第 6 步）重新检查循环

重试次数上限：

  1. 全局循环最多 3 次
  2. 每张受影响幻灯片的局部循环最多 2 次
  3. 如果问题数量没有减少，则提前停止

务必重新运行：

  • 如果文本/结构有变化，则重新进行全局内容检查
  • 对修改过的幻灯片进行局部视觉检查，然后运行最终的完整 qa
输出大小规则

默认情况下，尽量缩小上下文：

  1. 所有命令都使用 --compact
  2. 使用 --out 将所有输出写入文件
  3. 快速概览时使用 plan-inspect --summary-only，需要深入检查时使用 --content-only 或 --fields
  4. 对 inspect/find 使用分页（--page-size、--page-token）
  5. 仅在调试时使用 --verbose
失败策略
  1. 如果 qa.ok == false 且存在 contract/data 错误：阻止发布
  2. 如果只有视觉/叙事警告：重试次数用尽后可继续，但须报告剩余风险
最终报告

报告以下内容：

  1. 迭代次数（全局/局部）
  2. 按代码分类的初始与最终问题数量
  3. 剩余警告
  4. 最终产物：
    • output/<project>/output.pptx
    • output/<project>/qa.json
    • output/<project>/lint.json
    • output/<project>/plan_content.json

反模式（不要这样做）

  • 提取后不要跳过理解关卡——误读清单会导致每张幻灯片都出现连锁错误
  • 未先阅读 resolved_manifest.json，不要生成 ops——布局名称、几何属性和颜色区域必须来自契约
  • 不要无限迭代——遵守重试次数上限，并报告剩余风险
  • 不要用视觉补丁修复叙事问题，反之亦然——使用正确的修复类别
  • 如果摘要/分页足够，就不要读取完整的 slides.json 或完整的 inspect 输出——保护上下文窗口

错误处理

遇到任何幻灯片错误时，重试前运行 uvx --from agent-slides slides docs method:preflight、uvx --from agent-slides slides docs method:render 或 uvx --from agent-slides slides docs method:extract，以验证当前契约。

验收标准

  1. output.pptx 存在且可打开。
  2. 在发布模式下，qa.json 报告 "ok": true。
  3. 全局内容检查通过或明确豁免。
  4. 视觉检查低于警告阈值或明确豁免。
  5. 所有修复均可通过小型 ops 补丁追溯。
  6. 设计配置文件存在，且 template_path 和 primary_color_hex 正确。
  7. 渲染前，slides preflight 报告 "ok": true。
  8. 所有内容幻灯片都有行动标题（完整句子）。

评论

支持 Markdown