PPT-Design-Skill:把 AI 生成 PPT 推进到客户交付级的视觉设计师

AI 生成 PPT 普遍被吐槽”能用但不能交”的当下,PPT-Design-Skill 用一套「设计交付流水线」把生成器从「一段 prompt 出一堆 slide」升级成「带视觉复核的成稿交付」,并依靠 40,000+ 视觉样式库和像素级控制,硬生生在 GitHub 上一个半月冲到 931 星,成为当下 PPT 生成类 Skill 中热度最高的工程化方案。

核心功能与设计原则

该 Skill 以 pptx-designer 为底层运行时,对外提供三种生成模式,分别对应不同的交付诉求:

  • Build Mode(首选):交付级空白画布精确设计。LLM 生成普通 Python 文件,由 pptx_designer.tools.* 公共 API 控制坐标、颜色、字体、卡片和图表,所有产出均可 Git 审查、修改、重建,最后走 PPTX → PDF → PNG 视觉复核链路。
  • FreeStyle Mode:探索优先模式,通过 generate_ppt(query=...)generate_ppt(content=...) 由 LLM 自动编排,最快出方向稿。
  • VI Build Mode:模板优先模式,先用 extract_design_dna() 抽取企业模板的颜色、字体、安全边距、页脚、Logo,新增内容页必须保持品牌一致性。

整套 Skill 把”设计交付”拆成 9 个强制节点:需求确认 → 页面结构 → 视觉方向 → 设计 token 锁定 → 生成可编辑 PPTX → 导出 PNG → LLM 逐页视觉复核 → 修订重渲染 → 用户确认交付。任何”代码跑通但页面丑”的产物都会被卡在视觉复核这一关。

认可度

  • GitHub Star 数:931 ⭐(截至 2026-08-25)
  • Fork 数:148
  • 创建于 2026-07-09,一个半月达成 931 Star,平均日增 Star 约 20
  • 2026-08-25 仍在持续 commit,维护节奏活跃
  • 语言 Python;与 OpenCode、Claude Code、Codex、DeepSeek Harness 四大 Agent 平台同时兼容
  • 已在 GitHub 搜索结果中多次出现在「AI PPT」「Claude Code skills」「agent skills」等热门查询的高排名

仓库地址

完整 GitHub 仓库:https://github.com/sunchaokun/PPT-Design-Skill

原作者

sunchaokun:GitHub 用户名即作者标识,长期在 Agent Skills 生态中发布 PPT/视觉生成相关项目,主攻方向是把 LLM 从「文字生成器」推进到「视觉交付工程师」,这套 Skill 是其 pptx-designer 系列能力的封装与标准化。

项目介绍

PPT-Design-Skill 的核心目标,是让 AI 生成的 PPT 直接进入客户交付级别。传统 prompt-to-PPT 工具最大的痛点在于:能跑通、shape 数对、Python 不报错——但人眼一看就是”模板感、AI 味”。该项目用三种手段解决这一问题:

第一,强制视觉复核。Skill 在生成 PPTX 后必须执行 PPTX → PDF → PNG 导出,然后由 LLM 直接看图,检查构图、层级、可读性、密度、节奏、需求匹配度、可编辑性,记录 PASS / NEEDS_REVISION / BLOCKED 三种验收状态,不通过的页面强制回源码返工。

第二,40,000+ 视觉样式库 + Design Token。所有颜色集中在 C 字典或设计 token 中,字体、间距、网格统一配置;样式覆盖暗色香水 editorial、解构式高级定制、建筑竞赛愿景书、企业战略汇报、科研结果汇报等典型场景,配有 luxury_fragrance_lookbook.pptxcouture_editorial_deck.pptxarchitecture_vision_book.pptx 三个真实评估样例作为视觉基准。

第三,Designer Mindset 而非 style 参数。Skill 内置 Audience-first(按受众决定表达)、Narrative planning(先设计页面叙事再写代码)、Domain paradigms(科研/论文/技术/医疗/政府/商业不同范式)、Density control(控制页面信息量)、Structural variation(页面结构随目标变化而非重复同一种卡片)、Native editability(文本/形状/图表/SVG 全可编辑)等 8 项能力,并提供 kpi_cardpage_headerrectcover_image 等公共 API。

核心特点

  • 三层模式切换:Build / FreeStyle / VI Build 分别对应交付、探索、模板遵从三种使用场景,避免一刀切。
  • 像素级可控:Build Mode 下所有坐标用英寸,公共 API 控制每个元素,可逐元素修改。
  • 强制视觉复核:把 PNG 视觉检查写进交付流程,从源头消除”AI 味”模板感。
  • 样式库规模大:40,000+ 视觉样式,覆盖从产品 Lookbook 到政府汇报的完整场景。
  • 跨平台原生支持:OpenCode / Claude Code / Codex / DeepSeek Harness 四个 Agent 平台同一份 Skill 文件,无需重写。

使用方法

安装

# 克隆仓库
git clone https://github.com/sunchaokun/PPT-Design-Skill.git
cd PPT-Design-Skill

# 安装运行时
python install.py
python skill/scripts/check_runtime.py

# 安装到目标 Agent 平台
python installer/install.py --platform opencode --force
# 也可改为 claude / codex / deepseek-harness / all

Windows 用户可选 --render-deps 让 installer 用 winget 自动装依赖。完成安装后重启 IDE / Agent。

最简示例(FreeStyle Mode)

from pptx_designer import generate_ppt

result = generate_ppt(
    "AI startup investor pitch",
    style="dark cyberpunk",
    output="output/pitch.pptx",
)

精确控制(Build Mode)

from pptx_designer import Presentation
from pptx_designer.tools.cards import kpi_card
from pptx_designer.tools.layout import page_header
from pptx_designer.tools.shapes import rect

C = {
    "primary": "#1D78FA",
    "accent": "#FF6B35",
    "background": "#FFFFFF",
    "text_dark": "#172554",
    "text_body": "#475569",
}

prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[6])
page_header(slide, "Q4 Revenue Report", "Financial Summary", C=C)
kpi_card(slide, 1.0, 2.0, 3.5, 1.5, "$12.8M", "Revenue", "+23%", C=C)
rect(slide, 0.5, 6.8, 12.3, 0.08, fill="primary", C=C)
prs.save("output/report.pptx")

模板合规(VI Build Mode)

先调用 extract_design_dna("path/to/template.pptx") 抽取品牌 DNA(颜色、字体、安全边距、Logo),再基于 DNA 增加新内容页,最后通过 PPTX → PDF → PNG 路径与原模板对比验证一致性。

使用场景与人群

  • 正式提案/客户交付:需要逐元素可控、像素级还原、视觉复核签收的咨询顾问、品牌策划、4A 创意团队。
  • 企业汇报:财务、战略、产品发布会等需要保持品牌 VI 的内训/对外会议场合。
  • 科研/论文汇报:科研结果、毕业论文、学术会议,使用 Skill 内置的科研范式。
  • 建筑/设计/时尚:高定 Lookbook、建筑竞赛愿景书等强视觉叙事场景。
  • 自媒体/内容创作者:需要快速生成专业风格 PPT 但又拒绝”AI 模板味”的内容运营。

目标用户是对视觉完成度有要求、又不想被一键生成器牵着走的 Agent 重度使用者,尤其推荐给 OpenCode / Claude Code / Codex 用户在本地工作流里集成。

输入与输出案例

案例 1:投资者路演(FreeStyle → Build)

  • Input:用户给出 query “AI startup investor pitch”,指定 style=”dark cyberpunk”。
  • Output:生成 output/pitch.pptx,按暗色霓虹风格自动编排 hook / problem / solution / traction / ask 五段式叙事;LLM 校验后排版生成可编辑 PPTX,并通过 PNG 视觉复核发现并修正”首页 KPI 卡片拥挤”问题,最终交付。

案例 2:Q4 财务汇报(结构化 content)

  • Input
    python
    generate_ppt(
    content={
    "title": "Q4 Revenue Review",
    "pages": [
    {"goal": "hook", "title": "Q4 2026", "subtitle": "Record quarter"},
    {"goal": "problem", "title": "The pressure is visible",
    "bullets": ["Enterprise demand is growing", "Delivery capacity is the constraint"]},
    {"goal": "data", "title": "Key metrics",
    "bullets": ["Revenue: $12.8M", "Retention: 89%"]},
    ],
    },
    style="professional",
    output="output/review.pptx",
    )
  • Output:每页 goal(hook / problem / data)映射到不同视觉策略,自动选择对应的版式、配色与字体;最终交付视觉层级清晰、信息密度合理、可直接发往董事会的 8–10 页 PPTX。

案例 3:建筑愿景书(VI Build Mode)

  • Input:用户上传 template.pptx(事务所标准母版),需求是”用同一份模板填入新项目 Vision 内容”。
  • Output:Skill 先抽取设计 DNA,再按母版框架生成新封面、目录、章节页、内容页,通过 PPTX → PDF → PNG 验证与原模板在颜色 / 字体 / 安全边距 / 页脚 / Logo 上一致,最终交付一份可编辑、企业合规的 Vision Book。

GitHub: https://github.com/sunchaokun/PPT-Design-Skill

评论区

0 条评论

登录后可评论。

Skill超级捕获手 13 阅读