SuperAPI AI 工具集

slides-full

办公与效率

查看项目

更新于 10-16 01:28

技能介绍

用途:slides-full 是面向演示文稿生产的端到端流水线,按“提取—预检—构建—审计—评审—润色”顺序串联各项 slides 技能,一条命令从模板和简报产出完整且经过打磨的演示文稿。适合用户想要从零生成完整 deck、提供简报与模板并期望得到成品,或不想逐个手动调用各技能的场景。

前置条件:需要一个 .pptx 模板文件,或已提取好契约的现有项目目录,以及用户提供的简报、主题或内容大纲。可选参数包括模板路径、目标页数(默认按简报复杂度推断)和项目名(默认按简报推断)。

主要流程:采用动态状态机而非固定线性流程,状态依次为 EXTRACT_OR_REUSE、PREFLIGHT、BUILD_OR_UPDATE、GLOBAL_CONTENT_CHECK、LOCAL_VISUAL_CHECK、APPLY_FIXES、RECHECK、DONE;任一检查失败即回到 APPLY_FIXES 再 RECHECK。先用 find . -name "design-profile.json" -maxdepth 3 定位项目目录,再执行提取,命令示例为 uvx --from agent-slides slides extract <template.pptx> --output-dir output/<project> --base-template-out output/<project>/base_template.pptx --compact。提取后需通过理解关卡,读取 resolved_manifest.json 确认主题强调色、已解析布局、分栏布局与各颜色区域的 text_color。预检命令为 uvx --from agent-slides slides preflight --project-dir output/<project> --profile output/<project>/design-profile.json --compact;预检报告缺失契约、路径错误、缺少图标包或依赖错误时不得进入渲染。构建设计档案并生成 slides.json 后,先用 render --dry-run 试运行,再正式输出 output.pptx。审计阶段用 plan-inspect 做全局内容检查,用 lint 和 qa 做技术与视觉检查,必要时用 inspect --page-size 1 --page-token <n> 逐页查看。

修复与循环:修复按类别区分,story.* 来自全局检查,visual.* 来自局部检查,contract.* 来自 lint/qa 硬失败,通过 uvx --from agent-slides slides apply 应用小且可逆的补丁。全局循环最多 3 次,局部每页最多 2 次,问题数量不再改善时提前停止。

限制与策略:所有命令默认加 --compact,输出写入文件,用 --summary-only、--content-only 或分页控制上下文,仅在调试时使用 --verbose。qa.ok == false 且属契约或数据错误时阻止发布;仅视觉或叙事警告可在迭代预算耗尽后继续,但须报告剩余风险。不要跳过提取后的理解关卡,不要在未阅读 resolved_manifest.json 时生成操作,不要无限迭代,不要用视觉补丁修叙事问题或反之,避免读取完整 slides.json 或完整 inspect 输出。

验收标准:output.pptx 存在且可打开;qa.json 在发布模式下报告 “ok”: true;全局内容检查通过或明确豁免;视觉检查低于警告阈值或明确豁免;所有修复可通过小操作补丁追溯;设计档案包含正确的 template_path 与 primary_color_hex;渲染前 slides preflight 报告 “ok”: true;所有内容页均有完整句子的行动标题。