无障碍 PowerPoint 演示文稿生成工具 (Create Accessible PowerPoint Decks)

技能简介

dnyoussef-when-creating-presentations-use-pptx-generation 是一款专注于生成无障碍（Accessible） PowerPoint 演示文稿的 Agent Skill，解决手动制作 PPT 时格式不规范、无障碍属性缺失、内容结构混乱等常见问题。它在生成流程中内置了颜色对比度检查、图片替代文本（Alt Text）验证、阅读顺序校验和数据完整性审查，并在输出 PPTX 的同时附带一份无障碍审查报告，帮助用户制作既专业又包容的演示材料。

该 Skill 由 DNYoussef 开发，采用 MIT 许可证，支持 Claude、Codex 和 Claude Code，通过 pptxgenjs 库实现 PowerPoint 程序化生成，无需本地安装 Microsoft Office。

核心能力

• 结构化元数据定义：在生成前明确演示文稿的受众、目的、大纲和幻灯片分区，确保内容结构清晰、逻辑连贯。
• 品牌与无障碍约束配置：统一声明可复用的颜色、字体、间距、布局规范以及无障碍要求（对比度最低 4.5:1、图片必须含 Alt Text 等）。
• 多类型幻灯片内容生成：通过 pptxgenjs 模式生成包含标题、正文、图表、演讲者备注的各类幻灯片，支持条形图、饼图、折线图等常用数据可视化。
• 五维无障碍校验：生成后自动执行对比度检查、Alt Text 完整性、阅读顺序、数据一致性和文件大小五项校验，输出结构化审查报告。
• 配套文档输出：除 PPTX 外，同步输出无障碍报告和演示文稿说明文档，便于存档和外部审阅。
• 可扩展验证规则：用户可补充自定义验证规则（如特定品牌色使用、禁止动画效果等），Skill 将其纳入校验流程。

安装配置

1. 安装命令

   npx skillstore add dnyoussef/when-creating-presentations-use-pptx-generation

2. 安装依赖 确保执行环境中已安装 Node.js（建议 v18 及以上），Skill 使用 pptxgenjs 作为核心生成库：

   npm install pptxgenjs

3. 定义品牌无障碍约束文件 在项目目录创建 a11y-config.json，声明以下内容：

   • 品牌主色与辅助色（需满足 WCAG AA 对比度要求）
   • 指定字体系列（建议使用系统自带字体以提高跨平台兼容性）
   • 最小字号要求（正文不低于 18pt）
   • 必须为所有非文本图片提供 Alt Text
   • 禁止使用的动画效果（如自动播放闪烁动画）

4. 配置输出目录 在 a11y-config.json 中指定 outputDir 路径，Skill 将在该目录下生成 PPTX 文件及配套报告。

使用步骤

1. 明确演示目标与受众 向 AI 描述演示文稿的类型（业务汇报、产品提案、培训课件等）、目标受众和核心信息，Skill 将据此确定幻灯片结构、内容密度和视觉风格。

2. 提供结构化大纲 列出幻灯片标题、每页核心要点和需要的数据图表类型（如「Q3 业绩总结，需要柱状图展示各区域销售额」），Skill 据此生成完整大纲。

3. 应用品牌与无障碍规则 将 a11y-config.json 中的颜色、字体和无障碍约束作为前置条件告知 AI，确保生成过程中遵守品牌规范。

4. 生成 PPTX 文件 AI 调用 pptxgenjs 按顺序生成每张幻灯片，包含标题页、议程页、内容页、数据图表页、总结页和演讲者备注。生成完成后 Skill 自动执行五维无障碍校验。

5. 审阅无障碍报告 Skill 输出的报告包含：颜色对比度不达标的位置（附替代色建议）、缺失 Alt Text 的图片列表、阅读顺序异常页面和文件大小超限警告。逐一修复后重新生成。

6. 生成配套文档 确认 PPTX 内容无误后，Skill 生成结构化的演示文稿说明文档（Markdown 格式），记录每页主题、关键数据和演讲注意事项。

适用场景

• 企业对外演示：制作符合无障碍标准的企业介绍、融资计划和产品提案，避免因格式问题在评审中失分。
• 政府与公共机构材料：满足 WCAG 无障碍规范的公共部门演示文稿，确保残障人士可借助屏幕阅读器获取信息。
• 教育与培训课件：确保教学材料对视觉障碍学生友好，所有图表配有完整 Alt Text 说明。
• 跨国企业合规材料：满足欧美市场无障碍法规（如 Section 508、EN 301 549）要求的企业演示，降低法律合规风险。
• 内容创作者标准化输出：YouTuber、播客主和在线课程制作者利用 Skill 生成结构化演示大纲和配套文档，提高内容生产效率。

适用人群

• 需要制作无障碍演示文稿的内容创作者和培训师
• 在跨国企业中负责对外演示的公共关系与市场团队
• 需要满足合规要求（WCAG、Section 508）的政府与公共机构材料负责人
• 希望提升 PPT 专业度和结构化程度的职场人士

工作原理

dnyoussef-when-creating-presentations-use-pptx-generation 的核心依赖是 pptxgenjs，一个纯 JavaScript 编写的 PowerPoint 文件生成库，无需 OLE/COM 交互，可在任何有 Node.js 运行时的环境中执行。生成流程分为两个阶段：结构化生成阶段和自动化校验阶段。在生成阶段，Skill 读取用户提供的演示目标、受众和大纲数据，按预设模板逐页生成幻灯片对象（Slide），每页包含背景、文本框、图表和备注，生成完毕后写入 .pptx 文件（实质为 zip 压缩的 XML 文件）。在校验阶段，Skill 调用无障碍规则引擎，对 PPTX XML 内容进行解析：提取所有图片的替代文本属性、计算文本与背景颜色的对比度（基于 WCAG 2.1 算法）、验证阅读顺序（即幻灯片中元素在 XML 中的顺序）以及检查数据图表的数据源完整性，最终输出结构化报告。

官方链接

• Skill 页面：https://skillstore.io/skills/dnyoussef-when-creating-presentations-use-pptx-generation
• GitHub 仓库：https://github.com/DNYoussef/ai-chrome-extension