CodeBuddy Skills 生成和编辑 PPT：安装、工作流与 PPTX 实现机制

https://copilot.tencent.com/ide

npm install -g @tencent-ai/codebuddy-code
codebuddy update

codebuddy

https://github.com/anthropics/skills

# 用户级 Skills
mkdir -p ~/.codebuddy/skills

# 项目级 Skills
mkdir -p .codebuddy/skills

git clone https://github.com/anthropics/skills.git

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

面向非专业开发者，基于 https://copilot.tencent.com 网站内容，写一份 CodeBuddy 介绍 PPT。
要求：
1. 背景色使用腾讯蓝 #0161FF；
2. 页面风格简洁、偏商务科技；
3. 受众是第一次了解 CodeBuddy 的用户；
4. 输出文件命名为：CodeBuddy-腾讯蓝版本.pptx。

请使用 document-skills 生成一份 PPTX。

主题：
<要汇报的主题>

受众：
<CEO / 技术评审 / 晋升委员会 / 新用户 / 客户>

目标：
<希望听众理解什么、做出什么判断或采取什么行动>

输入材料：
<网页、Word、Markdown、数据、已有 PPT、模板文件路径>

结构要求：
1. 封面
2. 背景与问题
3. 解决方案
4. 核心能力或关键成果
5. 数据证明
6. 风险与后续计划
7. 总结页

视觉要求：
1. 主色：<品牌色>
2. 风格：<科技 / 商务 / 极简 / 活泼 / 产品原型>
3. 每页只突出 1~2 个重点
4. 需要可编辑 PPTX，不要只输出图片

质量要求：
1. 检查文字是否溢出；
2. 检查标题层级是否统一；
3. 检查页面配色和字体是否一致；
4. 生成完成后说明输出文件位置。

我想开发一个酷炫的音乐 App，需要用 document-skills 输出高保真原型，并最终生成 PPTX。

请完成这些任务：

1. 用户体验分析
   - 分析目标用户、主要功能和核心交互路径；
   - 明确首页、发现页、播放页、歌单页、个人中心等关键页面。

2. 产品界面规划
   - 定义每个页面的信息架构；
   - 说明页面之间的跳转关系。

3. 高保真 UI 设计
   - 尽量贴近 iOS / Android 常见设计规范；
   - 使用现代化 UI 元素；
   - 模拟 iPhone 16 Pro 尺寸；
   - 添加状态栏、导航栏和底部 Tab Bar。

4. HTML 原型实现
   - 使用 HTML + Tailwind CSS；
   - 每个页面独立成一个 HTML 文件，例如 home.html、player.html、profile.html；
   - index.html 作为总入口，通过 iframe 平铺展示所有页面；
   - 使用真实图片资源，不使用纯占位符。

5. PPTX 输出
   - 把关键页面整理进 PPT；
   - 每页展示一个界面，并附简短设计说明；
   - 输出文件命名为：音乐APP原型设计.pptx。

请基于当前目录中的 CodeBuddy介绍.pptx 进行编辑。

任务：
在第 7 页后面新增一页，主题是“CodeBuddy 在腾讯内部的落地情况”。

新增页内容：
- 腾讯云代码助手 Tencent Cloud CodeBuddy，简称 CodeBuddy；
- 覆盖多款主流 IDE、编程语言和框架；
- 超 90% 的腾讯程序员使用；
- 微信、QQ、元宝、腾讯会议、王者荣耀、和平精英、腾讯云等产品团队均有使用；
- 2025 年腾讯新增代码中，50% 由 CodeBuddy 生成；
- 整体研发效率提升超过 20%。

要求：
1. 新增页必须延续原 PPT 的背景、字体、配色和版式风格；
2. 不要修改其他页面；
3. 生成一个新文件，不覆盖原文件；
4. 输出前检查页面是否有文字溢出。

请使用当前目录中的 CEO汇报模板.pptx，生成一份面向 CEO 的 CodeBuddy 汇报 PPT。

已知数据：
- 周活跃用户数：5 万+
- AI 代码生成占比：超过 50%
- 人均编码时间：缩短 40%
- 人均千行 Bug 率：降低 31.5%

要求：
1. 使用模板中的封面、目录页、数据页和总结页风格；
2. 内容结构需要适合 CEO 阅读，突出业务价值、投入产出和规模化落地；
3. 数据页需要用图表或大数字呈现，不要堆长段文字；
4. 每页标题必须直接表达结论；
5. 输出文件命名为：CodeBuddy-CEO-Report.pptx。

请使用 document-skills 读取当前目录中的 技术分享.docx，并生成一份培训 PPTX。

要求：
1. 不要逐段搬运文档内容；
2. 将长段落拆成适合演示的页面；
3. 每页只保留关键观点、关键数据和必要解释；
4. 对流程、架构、对比内容优先转成图表；
5. 风格采用简洁技术培训风；
6. 输出文件命名为：技术分享培训版.pptx。

当前目录中有 14 个 HTML 页面，分别对应一次技术分享的不同章节。
请把这些 HTML 页面整理成一份 PPTX。

要求：
1. 按章节顺序合并；
2. 每个 HTML 页面生成一页或多页 PPT；
3. 页面内容要可读，避免直接截图导致文字模糊；
4. 删除重复页；
5. 添加封面、目录和总结页；
6. 输出文件命名为：团队AI研发流程分享.pptx。

帮我做一个好看的汇报 PPT。

请基于 项目复盘.md 生成一份 12 页以内的项目复盘 PPT。

受众：技术管理者。
目标：说明项目为什么延期、采取了哪些修复措施、后续如何避免。
结构：
1. 项目背景
2. 目标与实际结果对比
3. 延期原因分析
4. 关键技术问题
5. 修复措施
6. 经验沉淀
7. 后续计划

视觉要求：
- 使用深蓝 + 白色科技风；
- 数据页使用柱状图；
- 每页标题使用结论句；
- 输出 PPTX 文件。

只修改第 3 页：
把这一页从长段文字改成“三个关键问题 + 三个解决动作”的左右结构。
不要修改其他页面。

约束：
1. DAU 表示日活跃用户数，不能写成下载量；
2. “提效 20%”指端到端研发周期缩短，不是单纯编码时间；
3. 所有页面不要使用红色作为主色，因为红色在内部汇报中表示风险；
4. 第 5 页必须保留原模板中的四象限布局。

git init
git add .
git commit -m "初始化 PPT 项目"

# AI 完成一轮修改后
git add .
git commit -m "生成 CodeBuddy 汇报初稿"

# 查看提交记录
git log --oneline

git checkout <commit_id> -- .

关键指标 + 可视化图表 + 对比维度 + 结论解释

周活 5 万+，AI 代码生成占比 50%，编码时间缩短 40%，Bug 率降低 31.5%。

CodeBuddy 已进入规模化使用阶段：
- 使用规模：周活跃用户数 5 万+；
- 生产贡献：新增代码中超过 50% 由 AI 生成；
- 效率收益：人均编码时间缩短 40%；
- 质量收益：人均千行 Bug 率降低 31.5%。

结论：AI 编码能力已经从辅助尝试进入研发流程主链路。

1 px = 0.75 pt
1 inch = 96 px
1 inch = 72 pt
1 inch = 914400 EMU

const PT_PER_PX = 0.75;
const PX_PER_IN = 96;

function pxToPt(px) {
  return px * PT_PER_PX;
}

function pxToInch(px) {
  return px / PX_PER_IN;
}

function rgbToHex(rgbStr) {
  // "rgb(255, 0, 0)" -> "FF0000"
  const match = rgbStr.match(/rgb\((\d+),\s*(\d+),\s*(\d+)\)/);
  if (!match) return null;

  return match
    .slice(1)
    .map((n) => parseInt(n, 10).toString(16).padStart(2, "0"))
    .join("")
    .toUpperCase();
}

const bodyDimensions = await page.evaluate(() => {
  const body = document.body;
  const style = window.getComputedStyle(body);

  return {
    width: parseFloat(style.width),
    height: parseFloat(style.height),
    scrollWidth: body.scrollWidth,
    scrollHeight: body.scrollHeight,
  };
});

const hasOverflow =
  bodyDimensions.scrollWidth > bodyDimensions.width ||
  bodyDimensions.scrollHeight > bodyDimensions.height;

presentation.pptx
├── [Content_Types].xml
├── _rels/
│   └── .rels
├── docProps/
│   ├── app.xml
│   └── core.xml
└── ppt/
    ├── presentation.xml
    ├── _rels/
    │   └── presentation.xml.rels
    ├── slides/
    │   ├── slide1.xml
    │   ├── slide2.xml
    │   └── _rels/
    │       ├── slide1.xml.rels
    │       └── slide2.xml.rels
    ├── slideLayouts/
    ├── slideMasters/
    ├── theme/
    │   └── theme1.xml
    ├── media/
    │   ├── image1.png
    │   └── image2.jpg
    └── notesSlides/

import zipfile
from pathlib import Path

def unpack_document(office_file, output_dir):
    output_dir = Path(output_dir)
    output_dir.mkdir(parents=True, exist_ok=True)

    with zipfile.ZipFile(office_file, "r") as zf:
        zf.extractall(output_dir)

unpack_document("presentation.pptx", "unpacked")

from pathlib import Path
from lxml import etree

def validate_xml_files(xml_files, xsd_path):
    schema_doc = etree.parse(str(xsd_path))
    schema = etree.XMLSchema(schema_doc)

    errors = []

    for xml_file in xml_files:
        doc = etree.parse(str(xml_file))
        if not schema.validate(doc):
            for error in schema.error_log:
                errors.append(f"{xml_file}:{error.line} {error.message}")

    return errors

from dataclasses import dataclass
from typing import Optional, List

@dataclass
class ParagraphData:
    text: str
    bullet: bool = False
    level: Optional[int] = None
    alignment: Optional[str] = None
    font_name: Optional[str] = None
    font_size: Optional[float] = None
    bold: Optional[bool] = None
    italic: Optional[bool] = None
    color: Optional[str] = None
    line_spacing: Optional[float] = None

@dataclass
class ShapeData:
    left: float
    top: float
    width: float
    height: float
    placeholder_type: Optional[str]
    paragraphs: List[ParagraphData]
    overflow: Optional[dict] = None

def sort_shapes_by_position(shapes):
    if not shapes:
        return shapes

    shapes = sorted(shapes, key=lambda s: (s.top, s.left))

    result = []
    row = [shapes[0]]
    row_top = shapes[0].top

    for shape in shapes[1:]:
        if abs(shape.top - row_top) <= 0.5:
            row.append(shape)
        else:
            result.extend(sorted(row, key=lambda s: s.left))
            row = [shape]
            row_top = shape.top

    result.extend(sorted(row, key=lambda s: s.left))
    return result

def collect_shapes_with_absolute_positions(shape, parent_left=0, parent_top=0):
    if hasattr(shape, "shapes"):
        abs_left = parent_left + shape.left
        abs_top = parent_top + shape.top

        result = []
        for child in shape.shapes:
            result.extend(
                collect_shapes_with_absolute_positions(child, abs_left, abs_top)
            )
        return result

    if is_valid_shape(shape):
        return [{
            "shape": shape,
            "absolute_left": parent_left + shape.left,
            "absolute_top": parent_top + shape.top,
        }]

    return []

slide-0 / shape-0
slide-0 / shape-1
slide-1 / shape-0
...

def generate_thumbnail_grid(pptx_path, output_prefix, cols=5):
    try:
        pdf_path = convert_pptx_to_pdf(pptx_path)
        images = convert_pdf_to_images(pdf_path)
        grid = create_image_grid(images, cols)

        output_filename = f"{output_prefix}.jpg"
        grid.save(output_filename, quality=85)

    except Exception as e:
        raise RuntimeError(f"thumbnail generation failed: {e}")

async function processSlidesParallel(htmlFiles, pptx) {
  const concurrency = 3;
  const chunks = chunkArray(htmlFiles, concurrency);

  for (let i = 0; i < chunks.length; i++) {
    const chunk = chunks[i];

    const promises = chunk.map((htmlFile) =>
      html2pptx(htmlFile, pptx)
        .then((res) => ({
          ...(typeof res === "object" && res !== null ? res : { result: res }),
          file: htmlFile,
        }))
        .catch((error) => ({
          error: error.message,
          file: htmlFile,
        }))
    );

    const results = await Promise.all(promises);
    handleProcessingResults(results);
  }
}

阶段 1：只生成目录和每页标题，不生成 PPT。
阶段 2：基于确认后的目录生成 PPTX 初稿。
阶段 3：只优化第 4 页的数据表达。
阶段 4：统一所有页面的标题格式和主色。
阶段 5：检查是否存在文字溢出、错别字和术语不一致。