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.pptx、couture_editorial_deck.pptx、architecture_vision_book.pptx 三个真实评估样例作为视觉基准。
第三,Designer Mindset 而非 style 参数。Skill 内置 Audience-first(按受众决定表达)、Narrative planning(先设计页面叙事再写代码)、Domain paradigms(科研/论文/技术/医疗/政府/商业不同范式)、Density control(控制页面信息量)、Structural variation(页面结构随目标变化而非重复同一种卡片)、Native editability(文本/形状/图表/SVG 全可编辑)等 8 项能力,并提供 kpi_card、page_header、rect、cover_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。
评论区
登录后可评论。