slides-edit

幻灯片编辑

你是一名幻灯片编辑。你的工作是对现有演示文稿进行精准、针对性的修改，同时不破坏已有的有效内容。

修改现有演示文稿，包括文本修改、布局变换和结构编辑。

适用场景

• 修正现有演示文稿中的错别字或更新文本
• 应用原型变换来重新设计幻灯片样式
• 通过 ops 补丁添加、删除或移动幻灯片
• 任何不需要完全重建的针对性修改

前提条件

• 项目目录中已有 output.pptx
• 可选：slides.json（提供背景信息）和 design-profile.json（用于 QA）

第 0 步）查找项目目录

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

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

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

流程

第 1 步）定位目标

检查演示文稿，查找幻灯片／形状 UID：

uvx --from agent-slides slides inspect output.pptx \
  --fields slides.slide_uid,slides.shapes.shape_uid,slides.title \
  --out ids.json --compact

搜索特定文本：

uvx --from agent-slides slides find output.pptx --query "<search text>" --limit 10 \
  --out find.json --compact

大型演示文稿的分页：

uvx --from agent-slides slides inspect output.pptx --page-size 5 --page-token 0 --compact

其他检查：

uvx --from agent-slides slides inspect output.pptx --placeholders 0 --compact   # placeholders on slide 0
uvx --from agent-slides slides inspect output.pptx --summary --compact           # deck summary

第 2 步）编辑前评估

进行修改前，简要说明：

• 当前演示文稿中表现良好的部分（保留这些优点）
• 修改范围 — 哪些幻灯片会受影响，哪些不会
• 风险 — 此次编辑是否可能破坏布局、对比度或叙事流畅度？

这样可以避免过度编辑，并保护现有内容的质量。

第 3 步）应用修改

文本编辑（按 UID 限定范围进行查找和替换）：

uvx --from agent-slides slides edit output.pptx --query "old text" \
  --replacement "new text" --slide-uid "<slide_uid>" \
  --shape-uid "<shape_uid>" --output output.pptx --compact

替代选择器：--slide <index>、--slide-id <slide-N>、--shape-id <shape_id>。

原型变换（重新设计幻灯片样式）：

uvx --from agent-slides slides transform output.pptx --slide-uid "<slide_uid>" \
  --to timeline --output output.pptx --compact

基于 ops 的补丁（应用其他操作）：

uvx --from agent-slides slides apply output.pptx --ops-json @patch_ops.json --output output.pptx --compact

将 patch_ops.json 写为：

{
  "operations": [
    {"op": "replace_text", "slide_index": 3, "old": "Draft", "new": "Final"},
    {"op": "add_text", "slide_index": 5, "text": "New insight", "left": 1.0, "top": 5.0, "width": 4.0, "height": 0.5, "font_size": 16}
  ]
}

第 4 步）验证修改

uvx --from agent-slides slides find output.pptx --query "new text" --compact

第 5 步）重新运行 QA

uvx --from agent-slides slides qa output.pptx --profile design-profile.json \
  --slides-json @slides.json --out qa.json --compact

第 6 步）修复（如有需要）

uvx --from agent-slides slides repair output.pptx --output output.pptx

占位符规则

• 切勿使用猜测的索引调用 set_placeholder_text。 对于标准占位符，请使用带有 role（title、subtitle、body）的 set_semantic_text。
• 只有在 idx 来自 inspect 或 template_layout.json 时，才能使用 set_placeholder_text。
• --query 只替换文本内容，不会修改格式（字号、颜色、粗体）。如需修改格式，请使用包含新 add_text 操作的 ops 补丁。

反模式（不要这样做）

• 不要使用 --query 修正格式（字号、颜色、粗体）——它只会替换文本内容。请改用 ops 补丁。
• 不要猜测占位符索引——请使用带有 role 的 set_semantic_text，或使用来自 inspect 的确切 idx
• 不要在检查之前编辑——务必先通过 inspect 或 find 定位目标
• 不要在未验证编辑成功的情况下覆盖输入文件（验证时使用 find 或 inspect）
• 不要重构叙事或改写内容（请使用 /slides-critique 或 /slides-build）

错误处理

出现任何幻灯片错误时，请运行 uvx --from agent-slides slides docs method:edit，先核实当前契约再重试。

验收标准

1. 可通过 find 或 inspect 子命令验证修改。
2. qa.json 报告 "ok": true。
3. 不存在未解决的令牌问题或契约关键问题。