用途:从 .pptx 模板或样例演示文稿中提取结构化模板契约,让下游技能无需猜测即可生成演示文稿。适用于对某模板首次执行 /slides-build 之前、源模板变更时,或需要分析模板布局与能力时。前置条件是一个 .pptx 文件(模板或含示例幻灯片的样例演示文稿)。
主要流程:
- 创建项目目录:mkdir -p output/<project-name>
- 先验证契约再提取:uvx --from agent-slides slides docs method:extract,然后运行 uvx --from agent-slides slides extract <template_or_sample.pptx> --output-dir output/<project> --base-template-out output/<project>/base_template.pptx --compact;可选加 --layout-preview-dir 生成逐布局 PNG,或用 --*-out 指定自定义文件名。
- 核心产物包括 template_layout.json(物理布局族与占位符)、content_layout.json(原型与布局兼容映射)、archetypes.json(可用原型及约束)、resolved_manifest.json(合并契约,主题调色板与逐原型布局绑定,为 /slides-build 的主要参考)、slides_manifest.json、slide_analysis.json、slide_screenshots/、icons/ 以及不含内容幻灯片的 base_template.pptx。
- 阅读理解门:读 resolved_manifest.json,确认主题强调色十六进制值(theme.palette.accent1…accent6)、哪些原型含 resolved_layouts、哪些布局为分栏式、各色区使用的 text_color,全部答不上前不要继续。
- 编写 design-profile.json,字段有 name、template_path(必须是 base_template.pptx)、content_layout_catalog_path,以及从主题提取的 primary_color_hex、text_color_light、text_color_dark、default_font_size_pt、icon_pack_dir;该配置使用 extra=forbid,未知字段会报校验错误,完整架构见 uvx --from agent-slides slides docs schema:design-profile。
- 预检:uvx --from agent-slides slides preflight --project-dir output/<project> --profile output/<project>/design-profile.json --compact,失败需修正结构或路径。
限制与验收:产物须存在且为合法 JSON,resolved_manifest.json 至少含一个带 resolved_layouts 的原型,base_template.pptx 能正常打开,design-profile.json 引用 base_template.pptx 与 content_layout.json,preflight 报告 ok 为 true。出现错误时先运行 docs method:extract 验证当前契约再重试。资料未提供收费、价格或平台信息。