"明天有个汇报，今晚必须交最终稿 PPT…"这场景熟悉吗？

年底到了，又到了写 PPT 的"煎熬季"，也许你正在为写 PPT 而绞尽脑汁、通宵达旦。

这一次，你可以给 CodeBuddy 一个写 PPT 的机会，本文将手把手带你实操，助力大家写好 PPT。

1. 写 PPT 的痛点与需求

1.1. 四大痛点，你中了几个？

作为职场人免不了要写 PPT，下面的痛点你中了几个？

• 突然通知"明天汇报"，你却连模板都没有，缺模板

  1. 没有统一模板，或缺乏各种思维模型的表达结构，每次从零开始
  2. 网上免费的太丑，付费的太贵（99-299 元/套）
  3. 想要简洁大气？自己设计不来

• 知道要说什么，但不知道怎么说，缺思路

  1. 业务背景、技术难点、解决方案…该怎么排序？
  2. 数据一堆，不知道强调哪个
  3. 想突出亮点，逻辑却一团乱

• 好模板收费，专业 PPT 美化师更昂贵，缺资源

  1. 专业模板网站：99-299 元/套
  2. 设计师定制：费用昂贵，高达 500-2000 元
  3. 买了还要学怎么用

• 本来就忙，哪来时间慢慢磨 PPT？没时间

  1. 白天忙业务，晚上赶 PPT
  2. 改来改去，还是不满意
  3. 想要精美图表？没时间一点点调

面对上面的痛点，你花了 2 小时找模板，最后还是选择"职场土味商务风"；写了 50 页晋升 PPT，评委一句"所以你做了啥？"

PPT 美化要么花钱，要么凑合用，晚上熬夜到凌晨 3 点，第二天顶着黑眼圈去汇报，心惊胆战，如履薄冰。这一切都别担心，CodeBuddy 来帮你！

1.2. CodeBuddy 解决方案：Skills

当前，CodeBuddy Skills 为大家提供了一个优雅的 AI 解决方案——用 document-skills 中的 pptx 技能帮你搞定写 PPT。

Skills 一句话理解就是给 AI Agent 配备人类现实世界所需的「技能包」，Skills 提前封装好工作流、工具、脚本等依赖信息，专注处理具体任务，并给出确定的结果，就像我们学习一门技术的时候，不会就去参加培训，直到具备从业的专业能力。

考虑到写 PPT 的受众有很多非专业开发者，我知道大家非常痛、很需要帮助，CodeBuddy 也没有忘记，今天将以手把手实操的方式，助力大家写好 PPT，希望给到大家一些帮助，也希望大家汇报顺利、晋升成功。

2. 快速入门

2.1. 安装 CodeBuddy

目前 CodeBuddy IDE & CodeBuddy Code 均支持 Skills（内网版插件近期迭代上线），在使用之前，需安装 CodeBuddy IDE 或 CodeBuddy Code，两者任选其一。非专业开发者，建议使用 CodeBuddy IDE；专业开发者、DevOps、运维工程师以及 Claude Code 用户建议使用 CodeBuddy Code。

• 安装 CodeBuddy IDE，下载安装包

  • 官网地址：https://copilot.tencent.com/ide

• 安装 CodeBuddy Code，打开终端 & 执行，一行命令搞定

  • 安装方式：npm install -g @tencent-ai/codebuddy-code && codebuddy update

2.2. 技能包安装与初次体验

由于我们需要写的是 PPT，因此需要安装具有 PPT 演示文稿创建、编辑和分析能力的 Skills 技能包。

目前在 GitHub 上已经有了 Anthropic 官方出品的 Skills 技能包，仓库地址：anthropics/skills，我们只需要在 CodeBuddy 中进行应用配置即可使用，其中 document-skills 技能包包含 docx、pptx、pdf、xlsx 4 种 Skill 配置，满足 Word、PPT、PDF、Excel 文件类型的创建、编辑和分析，接下来我们进行安装体验。

2.2.1. 在 CodeBuddy IDE 中装 document-skills 技能包

非专业开发者，适合纯技术小白

第 1 步：下载安装包到本地并进行双击解压：document-skills.zip

第 2 步：打开 CodeBuddy IDE，创建好本地文件夹

第 3 步：进入配置页，找到 Skill 配置路径

其中用户级 Skill 是全局配置，一次配置、任意文件夹都可用，建议选择；项目级 Skill 配置则仅在当前项目文件夹中可用。

第 4 步：进行导入，这里导入用户级 Skill

第 5 步：检查是否配置成功，成功后有如下列表

第 6 步（可选）：考虑到 PPT 场景，建议导入 xlsx、pdf、docx Skills 进行安装，操作方式如上，这些 Skills 完全覆盖了办公场景的 Excel、Word、PPT、PDF 等类型的数据处理。

第 7 步：初步体验 Skills，输入 Prompt

在 CodeBuddy 对话框中选择 Agent 模式，选择模型，输入以下 Prompt：

面向非专业开发者，基于 https://copilot.tencent.com 网站内容，写一份介绍 PPT，背景色采用 腾讯蓝 #0161FF，PPT 命名为腾讯蓝版本

第 8 步：查看 Skills 执行进度

第 9 步：查看 PPT 效果图，完整 PPT 见CodeBuddy-腾讯蓝版本.pptx

专业开发者

专业开发者可以通过在 CodeBuddy IDE/Code 中配置 Skills 目录：

一、选择配置级别
#1.在项目中配置项目 Skills
.codebuddy/skills/
#2.在本地配置用户级 Skills
~/.codebuddy/skills/
#3.例如在用户级配置 Skills
mkdir -p ~/.codebuddy && cd ~/.codebuddy
二、克隆代码到用户级目录
git clone https://github.com/anthropics/skills.git

2.2.2. 在 CodeBuddy Code 中装 document-skills 技能包

在 CodeBuddy Code 中安装 document-skills 可按照上述 CodeBuddy IDE 中专业开发者的方式，也可以按照如下方式安装。

第 1 步：打开终端 & 输入 codebuddy

第 2 步：安装 document-skills，分别执行如下两条命令

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

第 3 步：初次体验 Skills，输入 Prompt

面向非专业开发者，基于 https://copilot.tencent.com 网站内容，写一份介绍 PPT，背景色采用 腾讯蓝 #0161FF，PPT 命名为腾讯蓝版本

第 4 步：效果图。待运行完 todo 事项，可以直接执行 open 打开文件所在目录预览 PPT。

3. 场景实战

3.1. 无模板场景下的 PPT 实战

3.1.1. 输入 Prompt

我想开发一个酷炫的音乐 APP，现在需要采用 skill 输出高保真的原型图，最终需要保留为 PPT，请通过以下方式帮我完成所有界面的原型设计，并确保这些原型界面可以直接用于开发：
1、用户体验分析：先分析这个 App 的主要功能和用户需求，确定核心交互逻辑。
2、产品界面规划：作为产品经理，定义关键界面，确保信息架构合理。
3、高保真 UI 设计：作为 UI 设计师，设计贴近真实 iOS/Android 设计规范的界面，使用现代化的 UI 元素，使其具有良好的视觉体验。
4、HTML 原型实现：使用 HTML + Tailwind CSS（或 Bootstrap）生成所有原型界面，并使用 FontAwesome（或其他开源 UI 组件）让界面更加精美、接近真实的 App 设计。
5、拆分代码文件，保持结构清晰：每个界面应作为独立的 HTML 文件存放，例如 home.html、profile.html、settings.html 等。
index.html 作为主入口，不直接写入所有界面的 HTML 代码，而是使用 iframe 的方式嵌入这些 HTML 片段，并将所有页面直接平铺展示在 index 页面中，而不是跳转链接。
真实感增强：
界面尺寸应模拟 iPhone 16 Pro，并让界面圆角化，使其更像真实的手机界面。
使用真实的 UI 图片，而非占位符图片（可从 Unsplash、Pexels、Apple 官方 UI 资源中选择）。
添加顶部状态栏（模拟 iOS 状态栏），并包含 App 导航栏（类似 iOS 底部 Tab Bar）。
请按照以上要求生成完整的 HTML 代码，并确保其可用于实际开发。

3.1.2. 检验效果

以下为 CodeBuddy PPT Skill 运行生成 HTML & PPT 图，详见音乐 APP 原型设计_终版.pptx。

通过上述 Prompt 生成的 HTML 和 PPT 基本达到可用状态，对于 MVP 产品场景而言，HTML 原型已经满足需求。

3.2. 基于现有 PPT 编辑实战

3.2.1. 输入 Prompt

# 前提条件，下载好 PPT 在本地，并放在 IDE 文件夹之中，方便添加到对话中
基于该 PPT 版本，在第 7 页后面补充一页，介绍 CodeBuddy 在腾讯内部落地的情况，信息如下：
腾讯云代码助手（Tencent Cloud CodeBuddy，简称 CodeBuddy），支持多款主流 IDE 和主流编程语言及框架，超 90% 的腾讯程序员都在使用，多款国民级产品都选择了我们，例如微信、QQ、元宝、腾讯会议、王者荣耀、和平精英、腾讯云等，2025 年腾讯新增代码 50% 由 CodeBuddy 生成，整体提效超 20%。

3.2.2. 检验效果

从背景上看，AI 做到了和模板完全一致；字体上没有完全对齐，比如"缩短 40%""降低 31.5%"两处数字的字号被放大了，可能和我的 Prompt 写法有关系；此外，顶部标题因为我没有在 Prompt 中提供，所以没有生成。

总体来说满足需求，手工稍微改动即可使用。

3.3. 有模板场景下的 PPT 实战

3.3.1. 输入 Prompt

采用 Skills，按照该模板，帮我做一份面向 CEO 的汇报 CodeBuddy 的 PPT，数据就用这几个指标：周活跃用户数 5 万+、AI 代码生成占比超 50%、人均编码时间缩短 40%、人均千行 bug 率降低 31.5%，其他内容你来推荐写。

3.3.2. 检验效果

这一次，坦白说，我真的看不出来是 AI 写的，令我感到惊讶！完整文件见CodeBuddy-CEO-Report.pptx。

3.4. 基于非 PPT 文档输出 PPT 实战

在 PPT 实战场景中，除了上述两种类型，还有一种类型：Word、Markdown、HTML 等形式的文档，最终需要以 PPT 的方式进行对外呈现。

3.4.1. 基于现有 Word 文章直接生成 PPT

以我上次在腾讯学堂分享的这份 PPT 来说，总共 53 页，其中 27 页（占比 51%）是借助 CodeBuddy 生成的，整个制作时间合计不到 4 个小时：CodeBuddy 重磅升级功能详解+AI 编程实战秘籍。

对我而言，这不仅仅是一份 PPT，更是一次实战和对使用 AI 的充分信心。当时我的做法很简单，就一步：将我写的 Word 文档导出到 IDE 文件夹中，然后输入"采用文档 skills 帮我进行读取该文件并进行生成一份 PPT"的 Prompt。

同样，基于 Hooks、Spec、CodeBuddy Code 以及最新功能的实践分享，都是基于上述方法生成，最终再进行人工整合。

3.4.2. 基于现有 HTML 直接生成 PPT

如下为我基于《CodeBuddy AI 编程在企业团队中的落地实践与思考》文章进行拆解，生成了 14 张 HTML 介绍页，最终由 12 张 HTML 合成一份 PPT，详见：CodeBuddy AI 编程在企业团队中的落地实践与思考.pptx，总体来说对我而言，超出预期。

4. 实践技巧

通过上面的场景以及日常使用 CodeBuddy 和写 PPT 的经验，总结了一些技巧，一并分享给大家。

4.1. 使用 CodeBuddy 的技巧

4.1.1. 清晰表达需求，将任务拆解得足够正交（互不干扰、独立完整）

明确和清楚地表达你的需求，这其实是一件比较难的事情。

人与人之间的交流大多数是有背景的，但是在和 AI 打交道时，AI 并不一定知道背景，只有我们清楚地表达需求，并且把任务拆解得足够正交（Orthogonal），即：每个任务可以单独完成，不依赖其他任务的细节；每个任务有明确的输入、处理、输出，任务之间职责清晰，互不干扰或冲突；最后每个任务都能独立进行测试。

4.1.2. 一次只改一个小目标，要聚焦

同上述一样，不要期望 AI 一次帮你实现一个大需求，尝试小步慢跑，遇到问题进行定位，持续迭代，也能让你在使用 CodeBuddy 过程中有参与感和成就感，而不是无脑地接受 AI 的输入。

4.1.3. 把 AI 当导师一样看待，多轮对话进行交流

遇到不知道的地方、不认识的地方或者有疑虑，一张图丢进去问 AI，多问"为什么"“怎么做”“有什么坑要避免”“有什么风险”，把 AI 当做 7×24 小时的导师一样看待，循序渐进，多轮对话交流，让 AI 协助你定位问题、分析问题、解决问题和获得新知识。

4.1.4. 频繁做好备份和版本管理，改崩了就回退

每次大改动前建议做好版本管理，无论是使用 Git、网盘快照还是本地备份，确保可以随时回退到之前正确的状态，这样用 AI 写代码才更安心、更高效。

4.2. 使用 Skills 的技巧

4.2.1. 掌握 Prompt 工程，写出高质量指令

• 角色设定：明确 AI 的角色，如"你是一个资深 PPT 设计师"
• 任务拆解：将复杂任务拆成多个小任务
• 输出格式：指定期望的输出格式，如"生成一份 10 页的 PPT，包含封面、目录、内容页和结尾页"
• 风格定义：明确 PPT 的风格、配色、字体等要求
• 参考示例：提供参考模板或示例，帮助 AI 理解需求

4.2.2. 善用上下文窗口，合理控制输入长度

• 关键信息前置：将最重要的需求放在 Prompt 开头
• 避免冗余信息：只提供与任务相关的必要信息
• 分批处理：对于超长内容，可以分批输入和处理

4.2.3. 利用 Skills 的批量处理能力

Skills 支持批量处理多个文件或任务，充分利用这一特性可以大幅提升效率：

• 批量生成：一次生成多页 PPT 或多个文件
• 批量修改：对现有 PPT 进行批量调整
• 批量转换：将多个 HTML 文件转换为 PPT

4.3. PPT 内容组织技巧

4.3.1. 结构化思维

• 金字塔原理：结论先行，以上统下，归类分组，逻辑递进
• SCQA 框架：Situation（背景）、Complication（冲突）、Question（问题）、Answer（答案）
• STAR 法则：Situation（情境）、Task（任务）、Action（行动）、Result（结果）

4.3.2. 内容精炼原则

• 一页一主题：每页 PPT 只表达一个核心观点
• 少即是多：用最少的文字传递最多的信息
• 可视化优先：能用图表就不用文字，能用图示就不用列表

4.3.3. 数据呈现技巧

• 突出关键数据：用大字体、醒目颜色标注核心数据
• 数据对比：通过对比突出变化和增长
• 图表选择：根据数据类型选择合适的图表（柱状图、折线图、饼图等）

4.4. 常见问题与解决方案

4.4.1. 问题 1：生成的 PPT 样式不符合预期

解决方案：

• 在 Prompt 中明确定义样式要求，包括颜色、字体、布局等
• 提供参考模板或示例 PPT
• 分步生成，先确定整体框架再细化样式
• 使用 Skills 的样式覆盖功能进行微调

4.4.2. 问题 2：内容与预期有偏差

解决方案：

• 增加背景信息输入，帮助 AI 更好地理解上下文
• 明确目标受众和汇报对象
• 对生成的内容进行人工审核和修改
• 使用迭代方式，逐步调整和优化

4.4.3. 问题 3：大文件处理慢或超时

解决方案：

• 将大文件拆分成多个小文件分别处理
• 减少同时处理的任务数量
• 优化 Prompt，去除不必要的复杂要求
• 使用批量处理功能，分批提交任务

4.4.4. 问题 4：格式转换丢失样式

解决方案：

• 使用简单的 CSS 样式，避免复杂的嵌套
• 优先使用 Web 安全字体
• 将复杂样式转换为内联样式
• 转换后进行人工检查和调整

4.5. 技术原理与架构

4.5.1. PPT 生成核心流程

HTML 转 PPT 的核心技术流程：

1. HTML 解析：解析 HTML 结构，提取内容和样式信息
2. 样式提取：提取 CSS 样式，转换为 PPT 格式支持的形式
3. 元素映射：将 HTML 元素映射为 PPT 元素（文本框、图片、形状等）
4. 布局计算：根据 HTML 布局计算 PPT 中的位置和尺寸
5. 内容生成：在 PPT 中创建对应的元素并填充内容
6. 样式应用：将提取的样式应用到 PPT 元素上

4.5.2. 布局优化算法

/*
 * 优化布局函数 - 根据内容智能选择最佳布局
 * @param {Object} content - 需要布局的内容
 * @returns {Object} - 布局配置对象
 */
function optimizeLayout(content) {
    if (hasChartOrTable(content)) {
        // 使用两列布局：文本 + 图表
        return {
            type: 'two-column',
            ratio: isTextHeavy(content) ? '40/60' : '60/40',
            text_column: extractTextContent(content),
            visual_column: extractVisualContent(content)
        };
    } else {
        // 使用单列布局
        return {
            type: 'single-column',
            content: structuredContent(content)
        };
    }
}

4.5.3. 基本要求约束

✅ 在编写代码之前说明你基于内容的设计方法
✅ 仅使用网页安全字体：Arial、Helvetica、Times New Roman、Georgia、Courier New、Verdana、Tahoma、Trebuchet MS、Impact
✅ 通过大小、粗细和颜色创建清晰的视觉层次
✅ 确保可读性：强对比度、适当大小的文本、清晰的对齐
✅ 保持一致性：在幻灯片之间重复模式、间距和视觉语言

4.6. 性能优化与错误处理

并发处理机制以及错误恢复策略：

• 渐进式降级：HTML 转换失败时创建基础幻灯片
• 批量验证：一次报告所有验证错误，避免多次反复
• 备份机制：编辑前自动创建备份文件
• 回滚能力：操作失败时恢复原始状态

并发处理机制算法

async function processSlidesParallel(htmlFiles, pptx) {
    const concurrency = 3; // 并发数量限制
    console.log(`🚀 Starting parallel processing of ${htmlFiles.length} slides (Concurrency: ${concurrency})`);
    const chunks = chunkArray(htmlFiles, concurrency);
    for (let i = 0; i < chunks.length; i++) {
        const chunk = chunks[i];
        console.log(`📦 Processing batch ${i + 1}/${chunks.length} (${chunk.length} files)`);
        const promises = chunk.map(htmlFile =>
            html2pptx(htmlFile, pptx)
            // 成功回调：注入文件名以便日志记录
            .then(res => {
                // 如果返回值是对象，合并 file 属性；否则返回包含 result 和 file 的新对象
                return (typeof res === 'object' && res !== null)
                    ? { ...res, file: htmlFile }
                    : { result: res, file: htmlFile };
            })
            // 失败回调：捕获错误，防止 Promise.all 整体失败
            .catch(error => ({
                error: error.message,
                file: htmlFile
            }))
        );
        const results = await Promise.all(promises);
        handleProcessingResults(results);
    }
    console.log('\n✨ All processing completed.');
}

4.7. 质量保证系统

多层验证机制：

• HTML 验证：检查标签嵌套、CSS 合规性、尺寸限制
• 布局验证：检查元素位置、边距要求、对齐规范
• 内容验证：检查文本溢出、字体兼容性、颜色对比度
• 输出验证：检查 PPT 文件完整性、可读性

视觉质量检查算法

def generate_thumbnail_grid(pptx_path, output_prefix, cols=5):
    """生成缩略图网格用于质量检查"""
    try:
        # 1. 转换 PPT 为 PDF
        pdf_path = convert_pptx_to_pdf(pptx_path)
        # 2. 将 PDF 转换为图片
        images = convert_pdf_to_images(pdf_path)
        # 3. 创建网格布局
        grid = create_image_grid(images, cols)
        # 4. 保存检查结果
        output_filename = f"{output_prefix}.jpg"
        grid.save(output_filename, quality=85)
        print(f"✅ 检查结果已保存: {output_filename}")
    except Exception as e:
        print(f"❌ 流程中断: {e}")
        sys.exit(1)

4.8. 优势与局限性

4.8.1. 技术优势

1. 灵活的多模式支持：提供三种开发模式，满足不同场景需求：

   • HTML 模板渲染：所见即所得，开发效率高
   • OOXML 底层操作：精细控制文档结构，适合深度定制
   • 存量模板复用：基于现有 PPT 资产快速生成，降低设计成本

2. 像素级高精度转换：内置高精度坐标计算引擎，确保从 Web 布局到 PPT 元素的像素级对齐，最大程度保持视觉一致性

3. 企业级批量处理：架构专为高并发场景优化，能够稳定支撑大规模幻灯片的自动化生成与批量修改任务

4. 稳健的架构设计：

   • 模块化扩展：松耦合设计，便于快速集成新功能
   • 质量门禁：引入多层验证机制，确保最终输出文件的格式合规与内容准确

4.8.2. 技术局限

1. 渲染能力边界：

   • 样式限制：暂不支持 CSS 渐变、复杂动画特效及部分极度复杂的 HTML 嵌套布局
   • 还原损耗：极个别特殊的 Web 布局在转换为静态 PPT 时可能存在细微差异

2. 资源与性能约束：

   • 字体依赖：主要支持 Web 安全字体，对非标字体的兼容性受限
   • 性能开销：在处理超大规模（如千页级）文档时，生成耗时会显著增加，需预留计算资源

5. 总结

最后，希望大家确实摆脱 PPT 之痛，每一场汇报、晋升、培训都能很顺利，也期待大家能够使用 CodeBuddy Skills 做出自己精美的原型、作品和 PPT。

如果在实践过程中遇到各种疑难问题，欢迎留言交流。