安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install ppt-rescue-kit
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 ppt-rescue-kit。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

PPT Rescue Kit 可协助 AI agent 为工作汇报、项目提案和知识分享演讲创建完整且可编辑的 .pptx，或者修复未完成的幻灯片，而无需重新制作用户未要求修改的幻灯片。它生成逐页的幻灯片文案和演讲者备注，将事实性论述映射到来源，并在检查工具可用时验证生成的文件。
与仅生成大纲的工作流不同，此 skill 需要通过宿主的演示文稿生成能力创建真正可编辑的 PowerPoint。JishuDB 是存储简报、草稿、来源、最终内容、引用和修改记录所需的持久化后端。Openclaw Skills 用户将获得一个经过严格限制的包含调研、生成、验证和诚实完成报告的工作流；该 skill 不会虚构图表数据，也不能替代专业的行业分析研究。

应用场景

从一个主题创建可编辑的 PowerPoint，即使用户未提供文档包。
将工作汇报、项目提案或演讲转换为包含备注和来源的成品演示文稿。
通过补全叙事、幻灯片文案和演讲者备注来挽救部分完成的幻灯片，同时将修改限制在要求的幻灯片范围内。
当用户预期获得
.pptx
而不仅是幻灯片大纲时，生成包含来源引用的演示文稿。
在授权的 JishuDB 知识库中保存并验证演示文稿材料。
请勿将此 skill 用于需要经过验证的市场数据和图表来源映射的报告型行业分析；请改用
end-to-end-industry-presentations
。对于可以运行的网站，请使用
polished-website-builder
。

工作原理

确认范围与就绪状态。 将主题视为足以启动的条件，默认采用通用专业受众、10分钟演讲、约10页幻灯片、16:9 布局以及用户的语言。确认重大歧义、授权状态、JishuDB 访问权限、输出位置以及宿主的可编辑 PowerPoint 生成能力。
创建稳定的运行。 分配文件系统安全的运行 ID（run ID），复用授权设置和输出位置，并创建一个新的 ppt-rescue-kit- 输出目录，而不覆盖现有文件。
调研并检索证据。 检索选定的 JishuDB 知识库并阅读相关文档。通过授权的浏览或搜索获取许可的公开来源，优先使用来自公司、政府和研究机构的原始材料。切勿将私有文档带入公开搜索查询中。
将论述映射到来源。 分配来源 ID 和论述 ID；记录来源详情、日期、URL、覆盖范围和论述定位符。将观察到的数据与预测区分开来，并保留单位、日期、地理位置和定义。对于无法证实的内容标明假设和缺乏支持的论述，而不是虚构证据。
起草演示文稿。 规划适合任务的故事线，为每张幻灯片明确目的。编写完整的幻灯片文案和演讲者备注，包括图表数据和来源映射，然后将结构化草稿持久化存储到 JishuDB 中。
生成可编辑的幻灯片。 使用宿主实际的演示文稿生成器和 schema。保持文本、形状、表格、图表及底层图表数值可编辑；仅在适当位置使用图片，不得使用整页扁平化图片替代可编辑内容。
检查与纠错。 使用可用的预览或检查工具检查可编辑性、布局溢出、阅读顺序、字体、图表标签以及与源数据的一致性。如果无法使用检查工具，需明确声明未经检查说明。
保存、归档与报告。 写入 presentation.pptx、slides.md、sources.md 和 revision.md。回读并验证所需的 JishuDB 记录，然后报告真实的完成状态，包含输出路径、KB ID、记录 ID、局限性以及任何待处理的恢复操作。

配置指南

PPT Rescue Kit 适用于 WorkBuddy 或其他兼容 Agent Skills 且具备 JishuDB MCP、许可的网络访问、批准的本地文件输出以及可编辑 PowerPoint 生成能力的宿主。JishuDB 设置已包含在安装包中。该 skill 本身不提供演示文稿生成器，仅单独安装它并不能建立完整的宿主兼容性。
在兼容 Agent Skills 的宿主中安装或加载该 skill。
遵循随包附带的 JishuDB 设置和任务执行指南：references/jishudb-setup/setup.md 和 references/jishudb-setup/task-execution.md。
确认宿主已加载 JishuDB 工具并调用 kb_get_capabilities({})。检查实时 schemas 和所需的写入支持；仅在对行为不熟悉时才查阅 kb_read_handbook({})。
使用 kb_list({}) 将选定或授权的默认知识库解析为返回的 ID。在保留来源或输出之前获取任何缺失的许可。切勿猜测 ID 或创建重复的知识库。
使用宿主文档中记录的最小探测（minimal probe）验证其 PowerPoint 生成能力，并确认批准的输出路径。

Follow the host-specific skill installation and JishuDB setup instructions.

The skill does not define a universal installation command.

如果所需的后端访问、权限、输出能力或审批不可用，工作流必须停止或报告相应的受阻（blocked）或需要用户操作（user-action-required）状态。

数据架构

该 skill 会创建一个新的运行目录，并保留稳定的运行、记录、修改和重试标识符以供恢复。其常规本地产物为：
Artifact Contents
presentation.pptx 生成的可编辑 PowerPoint 幻灯片。
slides.md 最终幻灯片文案与演讲者备注。
sources.md 幻灯片-论述-来源映射及来源详情。
revision.md 实际修改内容与相关产物名称。
所需的 JishuDB 记录按以下方式组织工作：
Record type Required information
Sources 许可的被检查材料或清晰标记的有限摘录；来源 ID、覆盖范围、出版商、日期、URL 及返回的文档 ID。
Brief and outline 主题、受众、默认项、目标、幻灯片顺序及批准的范围。
Draft 每张幻灯片的目的、完整草稿文案、备注、图表数据及论述 ID。
Final and citations 最终幻灯片文案、备注、附录及幻灯片-论述-来源定位符。
Revision manifest 运行与 skill 版本、修改版本、前序记录 ID、变更原因、产物名称及归档 ID。
备注必须使用稳定的 UUID 和 RFC 3339 时间戳创建，进行回读并关联到选定的 KB；仅包含来源的 Note 在 KB 中是不可搜索的。长记录应在实时大小限制内拆分为带编号的记录。对于保留的来源和上传文件，请使用实时 JishuDB 配置和 schemas 公布的路由和限制。验证完成的工作并回读所需的文档及当前修改版本；仅有队列中的工作或导入回执并不能证明已成功持久化。

高级特性

证据可追溯性：
分配来源 ID 和论述 ID，保留论述定位符，并将事实性幻灯片内容关联至来源记录和引用。
可编辑输出要求：
保持文本、形状、表格和图表可编辑，保留底层图表数值，而不是将幻灯片扁平化为截图。
JishuDB 持久化与验证：
存储来源、简报、草稿、最终内容、引用和修改记录；回读已保存内容并验证关联的 Notes 和完成的工作。
可恢复且具备幂等意识的执行：
保持运行 ID、UUID、时间戳、修改版本号和重试键稳定。在重试前对不确定的操作进行核对，避免重复记录或上传。
上传与任务恢复：
从实时能力中选择支持的上传路由，遵守大小和过期限制，在限定时间内轮询任务，且仅通过支持的恢复调用重试已确认的失败。
冲突安全的修改：
保留前序记录，对批准的 Note 变更使用预期的更新时间戳，解决冲突而不是强制覆盖。
质量检查与真实状态：
在工具允许时检查布局和可编辑性，区分
COMPLETE
、
PARTIAL
、
BLOCKED
、
USER_ACTION_REQUIRED
FAILED
结果，不得将排队中的归档工作伪装为已完成。

name: ppt-rescue-kit description: >- 快速制作或补完可编辑 PPT，适用于工作汇报、项目提案、知识分享、
只有主题或尚未完成的演示稿；交付逐页文案、讲稿和引用，不只是大纲。 /
Create or rescue an editable PowerPoint for work updates, proposals, or
knowledge sharing from a topic or unfinished deck. Deliver slide copy,
speaker notes, and sources retained in JishuDB. For report-led industry
analysis decks, use end-to-end-industry-presentations instead.
compatibility: >-
WorkBuddy or another Agent Skills-compatible host with JishuDB MCP, permitted
web access, approved local file output, and editable PowerPoint generation.
JishuDB setup is included in this package.