메뉴
生成、编辑与读取 PowerPoint 演示文稿。若当前环境提供 ppt_write、ppt_refine、ppt_read、ppt_template_read 等 PPT 生成工具，必须优先使用工具生成和精修；无工具时再基于 PptxGenJS 或 python-pptx 从零创建，也可通过 XML 工作流编辑现有 PPTX，或用 markitdown 提取文本。触发词：PPT、PPTX、PowerPoint、演示文稿、幻灯片、Deck。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | PPTX生成器 |
| description | 生成、编辑与读取 PowerPoint 演示文稿。若当前环境提供 ppt_write、ppt_refine、ppt_read、ppt_template_read 等 PPT 生成工具，必须优先使用工具生成和精修；无工具时再基于 PptxGenJS 或 python-pptx 从零创建，也可通过 XML 工作流编辑现有 PPTX，或用 markitdown 提取文本。触发词：PPT、PPTX、PowerPoint、演示文稿、幻灯片、Deck。 |
本技能覆盖 PowerPoint 全流程任务：优先通过可用 PPT 生成工具创建、读取、精修演示文稿；无工具时读取/分析已有演示文稿、通过 XML 改写模板型 PPTX，或基于 PptxGenJS 从零生成演示文稿。技能内置设计系统（配色、字体、样式配方）和各页面类型的实现规范。
| 任务 | 推荐方式 |
|---|---|
有 ppt_write 等 PPT 生成工具 | 优先走 PPT 生成工具优先流程 |
| 读取/分析内容 | python -m markitdown presentation.pptx |
| 编辑模板或现有文稿 | 见 编辑演示文稿 |
| 无 PPT 生成工具时从零创建 | 见下方 从零创建工作流 |
| 项目 | 约定值 |
|---|---|
| 尺寸 | 10" x 5.625"（LAYOUT_16x9） |
| 颜色格式 | 6 位十六进制，不带 #（如 "FF0000"） |
| 英文字体 | Arial（默认）或已批准替代字体 |
| 中文字体 | Microsoft YaHei |
| 页码徽标位置 | x: 9.3"，y: 5.1" |
| 主题键 | primary、secondary、accent、light、bg |
| 基础形状 | RECTANGLE、OVAL、LINE、ROUNDED_RECTANGLE |
| 图表类型 | BAR、LINE、PIE、DOUGHNUT、SCATTER、BUBBLE、RADAR |
| 文件 | 内容 |
|---|---|
| slide-types.md | 5 种页面类型（封面/目录/章节分隔/内容/总结）及扩展布局模式 |
| design-system.md | 配色、字体、样式配方（Sharp/Soft/Rounded/Pill）、排版与间距规范 |
| editing.md | 基于模板编辑流程、XML 修改方法、格式规则与常见问题 |
| pitfalls.md | QA 流程、常见错误、PptxGenJS 关键陷阱 |
| pptxgenjs.md | PptxGenJS API 速查 |
| pptxgenjs-fallback.md | 没有 PPT 生成工具时的 PptxGenJS / python-pptx 脚本兜底流程 |
如果当前环境、MCP、函数调用或工具列表中存在 ppt_write、ppt_refine、ppt_read、ppt_template_read、ppt_delete 之一，默认使用这些工具完成 PPT 任务；不要先手写 PptxGenJS / python-pptx 脚本。只有确认没有可用 PPT 工具，或工具无法满足用户明确要求时，才进入后文脚本工作流。
推荐流程：
ppt_template_read 空参数，查看可用内置模板和真实 PPTX 母版模板包。需要统一字体和母版复用时优先选择母版模板包，例如 black_times_default、top_title_section 或用户自定义 config/ppt_templates/<template_id>/；用户要求封面页、顶部全宽大标题、顶部左侧一级标题、下方正文/图片内容区时，优先使用 top_title_section。使用 top_title_section 时，第一页写 type=cover 并只表达封面标题/副标题；第二页开始的 title 是顶部大标题，subtitle 是左上一级标题，body、bullet、item 和 image 放入下方内容区。type、layout 或 template_slide_id 选择版式。ppt_write，优先传结构化 XML：<slides>
<slide>
<type>cover</type>
<title>标题</title>
<subtitle>副标题</subtitle>
<prompt>封面页设计要求</prompt>
</slide>
<slide>
<type>content_image</type>
<title>图文页标题</title>
<body>正文要点</body>
<image src="/workspaces/.../image.png" />
<prompt>图文页设计要求</prompt>
</slide>
</slides>
output_path 优先使用当前工作区下的导出路径，例如 /workspaces/<workspace_id>/pptx/output/presentation.pptx。不要把最终产物写到技能目录或临时目录。ppt_read 检查页数、标题、页面摘要和 slide_id，确认结构完整。ppt_refine，传入目标 slide_id 和修改后的结构化内容；需要整体换风格时传新的 template_id。删除页面用 ppt_delete。<image src="..." /> 或 JSON images 数组传给工具；不要在 PPT 内容里直接嵌远程 URL 或 base64 大块数据。.pptx 路径；只有用户要求时再提供 PDF、预览图、生成过程或修改清单。pip install / npm install / apt-get）。temp_dir、技能目录或其他系统目录。pwd 获取实际工作区根（通常为 /workspaces/<workspace_id>）后再拼接；不要手写 /workspaces/{user_id}。pptx/input/。pptx/output/。slides/、imgs/、编译脚本等细节只在 pptxgenjs-fallback.md 中说明。# 文本提取
python -m markitdown presentation.pptx
适用场景：确认没有可用 PPT 生成工具，且没有模板或参考演示文稿，需从头生成。
此时读取 pptxgenjs-fallback.md，再按其中的 PptxGenJS / python-pptx 脚本兜底流程执行。不要把脚本兜底流程作为默认路径。
markitdown[docx,pptx,xlsx]、python-pptx、pptxgenjs、react-icons、react、react-dom、sharp。