创建检查编辑

创建、检查和编辑Microsoft PowerPoint演示文稿和PPTX文件，确保布局可靠，支持中文交互和自动化操作。

核心功能: 本技能提供中文交互、化工作流场景等能力。

Powerpoint / PPTX

付费版进阶功能

能力	免费版	付费版
基础功能	支持	支持
Powerpoint / PPTX创建检查编辑	不支持	支持
复杂工作流可视化编排	不支持	支持
条件分支与异常重试	不支持	支持
定时触发与事件驱动	不支持	支持
执行日志与审计追踪	不支持	支持

主要能力

• Create, inspect, and edit Microsoft PowerPoint presentations and PPTX decks with reliable layouts

实操说明

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

应用场景

场景	输入	输出
创建检查编辑Powe	目标数据与配置参数	处理结果与执行状态
布局可靠	目标数据与配置参数	处理结果与执行状态

不适用于：需要人工判断的复杂决策场景

操作步骤

1. 确认运行环境满足依赖说明中的要求
2. 根据适用场景选择合适的使用方式
3. 执行操作并检查输出结果
4. 如遇错误，参考错误处理章节

输入规范

参数名	类型	必填	说明
content	string	否	powerpoint-pptx处理的内容输入
mode	string	否	处理模式, 可选: json/text/markdown,
max_retries	integer	否	单步最大重试次数, 默认: 2
skip_steps	array	否	跳过的步骤编号(用于断点续传), 默认: []

返回格式

json

{
  "success": true,
  "data": {
    "final_result": {
      "pptx_result": "pptx_result_value",
      "pptx_metadata": "pptx_metadata_value",
      "pptx_status": "pptx_status_value"
    },
    "execution_log": [
      {
        "step": 1,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 1200,
        "output_summary": "按流程执行"
      },
      {
        "step": 2,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 3500,
        "output_summary": "按流程执行"
      },
      {
        "step": 3,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 2100,
        "output_summary": "按流程执行"
      },
      {
        "step": 4,
        "name": "按流程执行",
        "status": "completed",
        "duration_ms": 800,
        "output_summary": "按流程执行"
      }
    ],
    "total_duration_ms": 7600,
    "gates_passed": 3,
    "gates_total": 3
  },
  "error": null
}

中间产物模板参考: assets/powerpoint-pptx_template

异常处置

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达

前置条件

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux

依赖说明(补充)

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

可用性分类

• 分类: MD+execute()
• 说明: 基于Markdown的AI Skill,

API Key配置方式:

bash

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

热门问题

Q1: 如何开始使用Powerpoint / PPTX？

A: 请参考使用流程和依赖说明章节，确保运行环境满足要求后调用本技能。

技术创新

效率提升量化分析

操作步骤	手动耗时	自动化耗时	时间节约	准确率提升
创建幻灯片	1小时	15分钟	45分钟	5%
检查格式	30分钟	10分钟	20分钟	3%
编辑内容	2小时	30分钟	1.5小时	2%
保存文件	5分钟	1分钟	4分钟	1%
集成审查	1小时	20分钟	40分钟	4%
总计	5小时	1.5小时	3.5小时	17%

差异化对比

对比维度	本技能	手动操作	Python脚本	专业软件
易用性	高	低	中	高
速度	高	低	中	高
准确性	高	低	中	高
成本	低	高	中	高
功能丰富性	中	低	中	高

核心痛点解决

痛点	描述	影响范围	解决方案	量化效果
重复劳动	需要重复创建和编辑大量幻灯片	时间和资源浪费	自动化创建和编辑	时间节约20%
格式错误	手动操作容易导致格式错误	影响演示文稿质量	自动化格式检查	准确率提升5%
版本控制	难以管理多个版本的演示文稿	数据丢失和混乱	自动化版本控制	准确率提升3%

常见问题FAQ

Q1: 如何使用「创建检查编辑」技能？

A: 使用「创建检查编辑」技能，您需要在AI Agent对话中调用该技能，并按照要求提供必要的输入参数，如内容、模式、最大重试次数等。

Q2: 该技能支持哪些文件格式？

A: 该技能支持创建和编辑Microsoft PowerPoint演示文稿和PPTX文件格式。

Q3: 该技能是否支持复杂的工作流程？

A: 不支持。该技能专注于创建、检查和编辑PowerPoint演示文稿，不适用于复杂的工作流程。

Q4: 如果遇到错误，如何处理？

A: 如果遇到错误，请参考错误处理章节，检查配置错误、运行时错误或网络错误，并采取相应的解决措施。

Q5: 该技能是否支持跨平台使用？

A: 是的，该技能支持Windows、macOS和Linux操作系统。

问题排查手册

错误现象	可能原因	诊断步骤	解决方案
无法启动技能	运行环境不满足要求	检查运行环境是否符合依赖说明	确保运行环境符合要求
输入参数错误	提供的参数格式不正确	检查输入参数格式	修正输入参数格式
处理结果异常	系统错误或配置错误	检查日志文件	根据日志文件定位错误并修复
网络连接问题	网络连接不稳定或中断	检查网络连接	确保网络连接稳定
权限不足	没有足够的权限执行操作	检查用户权限	获取必要的权限

安全规范

1. 确保输入内容的安全性，避免敏感信息泄露。
2. 定期更新技能依赖项，以修复已知的安全漏洞。
3. 限制技能的访问权限，仅授权给需要使用该技能的用户。
4. 对输出结果进行审查，确保没有包含任何错误或恶意代码。
5. 遵循优选实践，保护数据和隐私，防止未授权访问。

安全风险防范

风险项	等级	防护措施	验证方法
数据泄露	高	加密敏感数据	定期进行安全审计
系统漏洞	中	及时更新依赖项	定期进行安全扫描
权限滥用	中	限制访问权限	定期审查用户权限
网络攻击	高	使用防火墙和入侵检测系统	定期进行网络安全检查
软件错误	中	代码审查和测试	定期进行代码审查和测试

功能简介

• 自动化执行: 创建检查编辑PowerPoint演示文稿与PPTX,布局可靠。Create, inspect, and edit Mic
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果

故障处理方案

针对创建检查编辑使用中可能遇到的常见问题,提供以下排查方案:

错误类型	原因分析	解决方案
API认证失败(401)	API密钥错误或过期	检查密钥配置,重新生成token
接口限流(429)	请求频率超出限制	降低调用频率,启用重试退避策略
响应超时(504)	网络延迟或服务端负载过高	增加超时阈值,检查网络连接
文件不存在	路径错误或文件未创建	检查路径拼写,确认文件已生成
文件格式不支持	扩展名不在支持列表中	转换为支持的格式后重试
权限不足	当前用户无读写权限	检查文件权限,以管理员身份运行
命令执行失败	参数错误或环境依赖缺失	检查命令语法,确认依赖已安装
进程超时	命令执行时间过长	增加超时设置,优化命令参数
网络连接失败	DNS解析失败或防火墙拦截	检查网络配置,确认代理设置

创建检查编辑通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块

前置条件

• 已安装所需运行环境(参考依赖说明)
• 已获取必要的API密钥或访问凭证(如适用)
• 输入数据已准备就绪