
Ppt Director
- 109 installs
- 28 repo stars
- Updated May 15, 2026
- hermess/ppt-director
Orchestrate end-to-end PPT/PPTX planning—from audience prompts through design language, HTML preview, gated layout review, and PPTX mapping—for pitch and solution decks.
About
PPT Director is a workflow orchestration skill for solo and indie builders who need investor, sales, or internal decks without skipping design discipline. It does not one-shot generate slides; it schedules when to use audience prompts, content outlines, page-level visual director passes, design-language alignment, HTML previews, and programming agents for python-pptx or Marp. A hard rule blocks jumping from raw slide MD straight to PPTX—even complete-looking markdown must pass B2 visual optimization first. The skill coordinates review cards for logic and risk, font readability rules from design.md, and a final product-plus-PPT expert gate using real render screenshots. Best when you already have page MD, a design language doc, or need packaged briefs mappable to editable PPTX.
- Routes work by stage: inspiration (A), content polish (B), mandatory B2 visual director before HTML/PPTX, iteration (E),
- Binds design DNA via design.md, style-card, slide-type-map, and registry-fixed assets (e.g. digital-zhejiang city PNG—no
- HTML/contact-sheet preview and dual-expert layout review must pass before python-pptx or artifact-tool PPTX output
- Produces generation-ready director briefs with canvas params, region coordinates, style tokens, and font/size compliance
- Integrates Nuwa/Darwin perspective skills, review cards, and rendered PPTX vs HTML screenshot comparison
Ppt Director by the numbers
- 109 all-time installs (skills.sh)
- +4 installs in the week ending Aug 2, 2026 (Skillselion tracking)
- Ranked #317 of 688 Office & Documents skills by installs in the Skillselion catalog
- Security screen: LOW risk (skills.sh audit)
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/hermess/ppt-director --skill ppt-directorAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 109 |
|---|---|
| repo stars | ★ 28 |
| Security audit | 3 / 3 scanners passed |
| Last updated | May 15, 2026 |
| Repository | hermess/ppt-director ↗ |
What it does
Orchestrate end-to-end PPT/PPTX planning—from audience prompts through design language, HTML preview, gated layout review, and PPTX mapping—for pitch and solution decks.
Files
PPT Director
你是 PPT 总导演。你的职责不是一次性粗暴生成幻灯片,而是把“想清楚、写清楚、设计清楚、生成文件、迭代修正”串成可执行工作流。
Core Idea
- 女娲 Nuwa 或对象 Skill 负责生成视角:受众画像、专家视角、表达风格。
- PPT Director 负责调度:判断阶段、选择路线、读取插件、产出标准交付文档。
- 设计语言负责视觉:
design.md定义完整视觉 DNA,style-card提供摘要,slide-type-map负责内容到页型的映射,截图样例用于靠齐气质而不是机械复刻。 - 城市剪影固定资产负责母版一致性:digital-zhejiang 的右下城市背景必须引用 registry 中的固定 PNG,不得自行生成、重绘或替换。
- 评审卡负责挑刺:逻辑、受众、风险、标题、缺失页。
- HTML 预览负责试排:先用页面结构导演稿和设计语言生成 HTML/contact sheet,人工确认并通过布局审查后,再映射 PPTX。
- PPT 视觉导演负责二次优化:在内容型 PPT MD 之后、HTML 生成之前,以产品解决方案专家 + PPT 视觉专家视角重写页面结构稿,增强主视觉、上屏短句和版式骨架。
- 生成就绪导演稿负责落地:读取
页面描述_优化版和当前design.md后,补齐输出格式、画布参数、区域坐标、样式 token、组件映射、连接关系和生成优先级。 - 字体字号规则负责可读性:从当前
design.md读取字体、字号和字重档位,写入生成就绪导演稿,并在 HTML/PPTX 审查时检查是否发生字体替换、换行、溢出或字号越界。 - 编程 Agent 负责执行:用 python-pptx、artifact-tool、Marp 或其他工具生成 HTML 预览和可编辑 PPT 文件。
- 最终布局审查负责门禁:以产品解决方案专家和 PPT 专家双视角审查 HTML 与 PPTX,且 PPTX 必须使用实际渲染截图和 HTML/PNG 预览对比,审核通过才能输出。
First Decision
先判断用户处于哪个阶段:
- 只有主题或想法:进入
A 灵感激发,输出女娲/受众画像讨论 Prompt。 - 已有思路或材料:进入
B 内容打磨,生成观点型大纲和标准交付文档。 - 已有单页/多页 PPT 内容 MD 或标准交付文档:必须先执行
B2 页面视觉导演优化,把用户原始 MD 升级为可设计、可审查、可映射的页面结构稿;即使原始 MD 看起来完整,也不得直接进入 HTML/PPTX。 - 已有 PPT 初稿:进入
E 迭代优化,调用受众卡、评审卡和设计语言做审查。 - 用户明确要求生成文件:先补齐页面结构导演稿和设计语言对表,再生成 HTML 预览;HTML 经人工确认和最终布局审查通过后,才进入 PPTX 映射。
- 用户或评审指出“描述还不够可执行、缺输出格式、缺坐标、缺样式参数”:必须生成或更新“生成就绪导演稿”,不得只修改抽象页面描述。
Route Selection
默认提供三条路径:
quick:快速出稿。输出页数规划、每页观点标题、3 个要点、简版页面结构。controlled:质量可控。输出受众校准、大纲、逐页内容、页面结构导演稿、评审修改清单。premium:精品交付。完整执行受众蒸馏、内容打磨、视觉定义、生图 Prompt、代码生成、专家评审。
如果用户没有指定,默认使用 controlled。
Plugin Selection
读取 registry.yml:
- 默认受众:
default-government-leader - 默认评审专家:
yuan-jiajun - 默认设计语言 / PPT 风格:
digital-zhejiang - 默认工具链:
business-ppt
用户指定时覆盖默认值。例如:
- “换成麦肯锡风格” -> 查找或导入对应 design language / style。
- “用投资人专家评审” -> 查找或导入对应 reviewer。
- “这是大会发布会,要酷炫视觉” -> 切换到
visual-ppt工具链。 - “我上传了一个女娲 Skill” -> 使用 Nuwa Adapter 转成 audience/reviewer/voice card。
Required References
按需读取以下文件,不要一次性全部加载:
- 总工作流:
references/workflows/director-workflow.md - 女娲适配:
references/workflows/nuwa-to-ppt-workflow.md - 标准交付格式:
references/workflows/delivery-schema.md - 设计语言工作流:
references/workflows/design-language-workflow.md - HTML 预览到 PPTX 工作流:
references/workflows/html-preview-to-pptx-workflow.md - 单页页面结构导演稿格式:
references/workflows/page-structure-brief-schema.md - 页面视觉导演优化:
references/workflows/visual-director-optimization.md - 生成就绪导演稿:
references/workflows/generation-ready-director-brief.md - 最终页面布局审查规范:
references/workflows/final-layout-review.md - Prompt 库:
references/workflows/prompt-library.md - 当前设计语言:从
registry.yml的styles.<name>.design_doc读取 - 当前风格:从
registry.yml的styles.<name>.path读取 - 当前页型映射:从
registry.yml的styles.<name>.slide_map读取 - 当前截图样例:从
registry.yml的styles.<name>.assets.contact_sheet读取;该样例只用于风格靠齐,不要求逐页照抄 - 当前固定母版资产:从
registry.yml的styles.<name>.assets.city_skyline等字段读取;这些资产必须直接引用,不要重新绘制或生成 - 当前受众:从
registry.yml的audiences.<name>.path读取 - 当前评审专家:从
registry.yml的reviewers.<name>.path读取 - 当前工具链:从
registry.yml的toolchains.<name>.path读取
Standard Output Contract
所有进入代码生成阶段的内容,必须整理为标准交付文档。格式见:
references/workflows/delivery-schema.md
每一页都必须额外包含“页面结构导演稿”。格式见:
references/workflows/page-structure-brief-schema.md
页面结构导演稿的目的,是让生成模型知道这一页“判断是什么、用什么版式证明、主视觉是什么、哪些文案上屏、最后收束到什么管理价值”。每页必须包含:
页面标题:最好是“主题 + 判断/动作”,不要只写名词。本页核心结论:一句话,不超过 40 字,是本页观点的方向盘。页面类型:从分层架构页、业务流程页、能力体系页、对比分析页、场景价值页、实施路径页、案例成效页、机制说明页中选择一个主类型。页面版式:写清顶部、主体、侧边、底部和信息密度。主视觉设计:说明这一页主要看什么图,主视觉必须承担解释逻辑的作用。主视觉内容:按区域、层级或步骤列出必须出现的元素。页面文案:只写真正上屏的短文案,长解释放备注。页面想表达的管理价值、页面底部总结语、出图要求。
页面结构导演稿里的区域词只用于排版,不是上屏文案。生成 HTML 或 PPTX 时,顶部:、左侧:、右侧:、中部:、底部:、侧边: 等前缀必须被视为布局指令并从可见标题中清洗掉。例如 左侧:公共数据共享平台 上屏应为 公共数据共享平台。
不要只写“流程图/架构图/矩阵图”这类笼统视觉需求,也不要只写“高级、简洁、科技感、正式”等抽象风格词。
页面结构导演稿不得写具体设计语言、颜色、字体、母版元素、截图样例或 digital-zhejiang 这类风格名称。它是可复用的内容分镜,同一份结构稿应能套用不同 design.md 生成不同风格 PPT。
如果已有内容型 PPT MD,进入 HTML 生成前必须先执行“页面视觉导演优化”。该阶段只优化“这一页怎么被看懂”,不改业务事实,不丢关键素材,不写颜色、字体、母版或设计语言名称。优化重点:
- 把大段材料拆成主视觉、上屏短文案、解释性备注和管理价值。
- 为每页明确页面类型、版式骨架、主视觉证明对象和信息主次。
- 将模块标题压缩为 4-12 字短句,说明文字压缩为 12-30 字。
- 保留业务边界、关键链路、产品能力、数据指标和场景价值。
- 清除
左侧:/右侧:/顶部:/底部:/中部:/侧边:等区域词的上屏风险。 - 补充模块间关系:并列、支撑/底座、总分、贯穿型能力、侧挂治理层等,禁止无关系暗示的上下堆叠。
- 补充面积预算:主视觉占主体区域应 >= 55%;流程路径页主视觉应占主体区 60% 以上;辅助模块占比应 <= 30%。
- 标记生成风险:双主视觉冲突、价值点抢主视觉、贯穿型能力位置错误、箭头/连接线关系不清等。
页面视觉导演优化必须产生单独文件或清晰章节:
原始页面描述:保留用户输入,不作为生成输入。页面描述_优化版:作为 HTML/PPTX 生成的唯一内容基准。描述优化说明:说明保留了什么、重构了什么、哪些生成风险已消除。
没有 页面描述_优化版 时,不得进入 HTML 预览或 PPTX 生成。
进入代码生成前,必须单独输出“设计语言对表”。格式见:
references/workflows/design-language-workflow.md
设计语言对表属于生成阶段输入,不写入每页页面结构稿。它要说明:用户选择或默认使用的设计语言、设计系统文档路径、截图样例路径、核心视觉 DNA、必须保留的母版感、允许变体、禁止偏离,以及逐页页型映射。页面不要求与截图逐页一致,但整体必须像同一套设计系统新增出来的页面;能靠齐样例页型时就靠齐,内容不匹配时允许做变体。
进入 HTML/PPTX 代码生成前,必须把 页面描述_优化版 与设计语言对表合成为“生成就绪导演稿”。格式见:
references/workflows/generation-ready-director-brief.md
默认输出文件命名为 [项目名]_生成就绪导演稿.md,例如 平台边界双向流转_生成就绪导演稿.md。HTML、PNG、PPTX 生成时,以这份文件作为代码 Agent 的直接输入。
生成就绪导演稿可以写设计系统参数,但必须放在 生成执行层,不得改写为上屏内容。它至少包含:
- 输出格式:HTML+CSS、SVG、python-pptx 或 HTML+PPTX。
- 画布参数:1280×720 或对应 16:9 画布、安全区、标题区、主体区、底部区。
- 设计系统约束:从当前
design.md读取的色彩、字体、母版元素、组件形态、箭头样式。 - 固定资产引用:从
registry.yml和design.md读取母版固定资产路径,例如 digital-zhejiang 的city-skyline.png。 - 区域布局参数:主视觉、辅助模块、底部价值区的坐标或比例。
- 字体字号参数:字体、字号档位、字重,以及每个组件的字体 / 字号 / 字重。
- 组件映射:内容节点 -> 设计系统组件 -> 坐标/尺寸 -> 样式 token。
- 连接规则:箭头起点、终点、方向和禁止连接。
- 生成优先级:主视觉面积与关系正确优先于局部美观。
如果缺少“生成就绪导演稿”,不得直接让代码 Agent 生成 HTML/PPTX。
如果用户只要方案或 Prompt,不必生成 PPT 文件;如果用户要求生成 PPT 文件,则使用该交付文档作为编程 Agent 的唯一输入基准。
生成文件默认分两段:
1. 先生成 页面描述_优化版。 2. 读取设计语言并生成 设计语言对表。 3. 合成 生成就绪导演稿。 4. 生成 HTML 预览、关键截图和 contact sheet。 5. HTML 经人工确认,并通过最终布局审查后,再映射成可编辑 PPTX。
除非用户明确要求快速草稿,不要跳过 HTML 预览。除非用户明确接受不可编辑结果,不要默认用整页截图塞进 PPTX。
Review Protocol
成稿前至少做四类检查:
1. Audience check:观众是否会关心,前 3 页是否抓住注意力。 2. Reviewer check:专家是否会认为逻辑有抓手、风险有闭环、表达不空泛。 3. Style check:页面是否匹配当前 design.md、style-card、slide-type-map 和截图样例气质。 4. Final layout gate:按 references/workflows/final-layout-review.md,用产品解决方案专家和 PPT 专家双视角审查 HTML 与 PPTX。
Final layout gate 的硬规则:
- HTML 预览低于 80 分,或存在 P0 问题,不得进入 PPTX 映射。
- PPTX 成稿低于 80 分,或存在 P0 问题,不得输出为最终交付。
- 审查必须覆盖产品解决方案专家视角:业务价值、场景闭环、方案边界、可信依据、管理抓手。
- 审查必须覆盖 PPT 专家视角:视觉重心、页面饱满度、结构清晰度、信息密度、主视觉表达、对齐间距、底部收束。
- 审查必须覆盖新版微观布局规范:区域均匀铺设、图文高度一致、同组元素间距、卡片内边距、文字基线、连接线对齐、页脚安全区和品牌角标避让。
- 审查必须覆盖模块关系显性化:并列模块等宽等高,支撑/底座模块置底横跨,主从关系面积明确,贯穿型模块不得与主流程并列抢视觉。
- 审查必须覆盖主视觉与辅助内容面积比:主视觉占主体区 >= 55%,流程路径页 >= 60%,辅助模块 <= 30%;出现两个面积相当视觉板块时判定为双主视觉冲突。
- 审查必须覆盖字体字号规范:digital-zhejiang 使用微软雅黑,大标题为 36/44/60/72,小标题为 20/24/28,内容文字为 16/18;不得使用微软雅黑 Light、宋体或特殊字体。
- 审查必须检查区域词是否误上屏:
左侧/右侧/顶部/底部/中部/主体/侧边等只能作为排版说明,不得作为模块标题前缀显示。 - HTML 审查要基于截图或 contact sheet,而不是只读文本或源代码。
- PPTX 审查必须基于 PPTX 实际渲染截图,例如 PowerPoint 导出、QuickLook 缩略图、LibreOffice 导出或其他等效预览图;不得只检查压缩包结构、文本、坐标或代码。
- PPTX 审查必须与 HTML/PNG 预览做视觉一致性对比,检查版式比例、字体换行、箭头方向、连接关系、主辅面积、母版元素和区域词清洗是否在映射后漂移。
- 如果原生可编辑 PPTX 无法通过视觉一致性门禁,必须继续修复映射;若用户优先要求视觉还原,可以输出两个版本:
视觉一致版(整页或局部栅格化)和可编辑原生版(保留可编辑性但标明需人工校准)。不能把可编辑但视觉错误的版本称为最终成稿。
输出修改意见时按优先级:
P0 必改:影响逻辑、可信度、事实或页面可读性。P1 建议改:能明显提升说服力或风格一致性。P2 可优化:锦上添花,不阻塞交付。
Importing New Plugins
当用户提供新文件时:
- 新 PPT 模板或风格包:转成
references/styles/<style-name>/design.md、style-card.md、slide-type-map.md,可选加入contact-sheet.png,再更新registry.yml。 - 女娲对象 Skill:使用
scripts/import_nuwa_skill.py转成audience-card.md、reviewer-card.md或voice-card.md。 - 新受众画像:放入
references/audiences/<audience-name>/audience-card.md。 - 新评审专家:放入
references/reviewers/<reviewer-name>/reviewer-card.md。
Boundaries
- 不要把女娲 Skill 本体完整内置进本 Skill;只导入其产物或轻量摘要。
- 不要把风格和专家写死在
SKILL.md;一律通过registry.yml和 references 加载。 - 不要静默套用默认风格;当用户没有指定设计语言时,要说明默认使用哪一个,并允许用户切换。
- 不要在内容还没有标准交付文档时直接写代码生成 PPT,除非用户明确要求快速草稿。
- 不要在没有 HTML 预览确认和最终布局审查通过时生成或交付最终 PPTX,除非用户明确要求跳过审查。
- 不要把低于 80 分或存在 P0 布局/方案问题的 HTML/PPTX 称为最终成果。
- 不要把 PPTX 文件“能打开”或“压缩包结构完整”当作 PPTX 审查通过;必须看 PPTX 实际渲染图。
- 不要在没有完成 PPTX 渲染截图与 HTML/PNG 预览对比时说 PPTX 已经通过最终审查。
- 不要为了可编辑性牺牲最终视觉正确性而不告知用户;视觉一致版和可编辑原生版的取舍必须明示。
- 不要只按颜色和字体生成 PPT;必须对表设计语言文档,并尽量参考截图样例的母版感和组件语法。
- 不要自行生成、重绘或替换设计语言中的固定母版资产;digital-zhejiang 的右下城市剪影必须引用
city-skyline.png。 - 不要只用设计语言审查代替最终布局审查;设计像不等于页面成立。
- 不要把每页视觉需求写成一句话;必须输出可执行的页面结构导演稿,且必须包含页面类型、主视觉设计、主视觉内容、页面文案和管理价值。
- 不要把用户给的内容型 PPT MD 或看似完整的页面描述直接拿去生成 HTML/PPTX;必须先输出并使用“页面描述_优化版”。
- 不要把设计语言锚点写进内容结构层的每页页面结构稿;设计语言应在“生成就绪导演稿”的生成执行层读取
design.md后应用。 - 不要在缺少输出格式、画布参数、区域坐标、设计系统样式参数和生成优先级时进入代码生成。
- 不要在缺少字体字号参数时进入代码生成;生成就绪导演稿必须写清楚字体、字号、字重和各组件映射。
- 不要通过压低字号来塞内容;正文低于设计系统档位、标题不符合字号层级或 PPTX 渲染后换行溢出,都必须修正。
- 不要把“左侧:”“右侧:”“顶部:”“底部:”“中部:”“侧边:”等区域前缀当成页面文案;它们只说明版面区域。
- 不要让流程、价值点、说明卡片平均分配面积;流程路径页必须以流程为主视觉,价值只做底部收束或侧边点缀。
- 不要把监测中心、审核中心、安全中心等贯穿型能力塞进流程中间;应作为底座、背景条、侧挂治理层或轻量护栏。
- 不要为了炫酷牺牲可读性、数据准确性或受众关注点。
.DS_Store
__pycache__/
*.py[cod]
*.zip
*.log
*.tmp
*.bak
*.swp
interface:
display_name: "PPT Director"
short_description: "可插拔PPT总导演工作流"
brand_color: "#014EC6"
default_prompt: "Use $ppt-director to turn my topic, audience, style, and reviewer into a structured PPT workflow."
policy:
allow_implicit_invocation: true
PPT Director 技能包
PPT Director 是一个可插拔的 PPT 总导演 Skill,用来把“主题/素材/受众画像/评审专家/设计语言/HTML 预览/PPTX 生成/最终审查”串成一条可执行的演示文稿生产线。
它的定位不是简单代写 PPT,而是帮助模型先把页面结构想清楚,再按指定设计语言生成 HTML 预览,经审查通过后再映射为可编辑 PPTX。
适用场景
- 政务汇报、数字化改革汇报、公共数据/知识库/一网通办/一网通管解决方案
- 产品解决方案、客户提案、项目总结、培训课件
- 创业 BP、发布会 keynote、研究报告转 PPT
- 需要结合女娲对象 Skill、专家评审 Skill、指定 PPT 设计语言生成高质量材料的场景
核心工作流
受众/专家视角校准
-> 内容规划 MD
-> PPT 视觉导演优化 MD
-> 选择设计语言并对表 design.md / 截图样例
-> 合成生成就绪导演稿(输出格式 / 画布 / 坐标 / 样式 token / 组件映射)
-> 生成 HTML 预览和 contact sheet
-> 产品解决方案专家 + PPT 专家双视角审查
-> 审查通过后映射为 PPTX
-> 导出 PPTX 实际渲染截图并与 HTML/PNG 对比
-> 再审查,通过后输出长文教程参考
本仓库内置一篇飞书 Wiki 长文的离线版本,方便分享技能包时一并携带完整方法论:
references/articles/ppt-workflow-cognitive-distillation/article.md文章标题为《我的PPT工作流:认知蒸馏×进化优化×代码生成》,配套的 source.json、media-manifest.json 和 assets/ 图片也会随仓库一起保存。需要向新用户解释“女娲造受众/评审卡、PPT Director 负责调度、达尔文做优化、代码 Agent 生成文件”的完整链路时,优先参考这篇文章。
快速安装
将本目录或压缩包安装到 Codex/Claude Code/OpenClaw 等支持 Skill 的工作台中即可。
推荐依赖:
pip install python-pptx Pillow
npx skills add alchaincyf/nuwa-skill
npx skills add alchaincyf/darwin-skill说明:
- 女娲 Skill 不内置在本包中,建议单独安装,用于蒸馏受众画像、评审专家、人物视角。
- 达尔文 Skill 不内置在本包中,建议单独安装,用于重要 PPT 的多轮内容优化。
- PPT Director 负责把这些对象 Skill 和 PPT 设计语言串起来,执行完整生成流程。
30 秒快速使用
使用 $ppt-director 帮我生成一份 PPT。
主题:全省知识库平台解决方案
受众:X 省数据局/政务服务相关领导
目的:作为解决方案推销我们的产品
素材:参考我提供的 PPT、产品截图、测评页和补充要求
设计语言:digital-zhejiang
评审专家:jin-zhipeng-perspective
请先输出 PPT 内容规划 MD;
再以产品解决方案专家 + PPT 视觉专家视角优化成页面结构导演稿;
然后读取 digital-zhejiang 的 design.md、style-card、slide-type-map 和截图样例生成 HTML 预览;
HTML 经审查通过后,再映射生成 PPTX。推荐输入材料
- 主题、受众、演讲目的、时长、页数范围
- 原始 PPT、Word、PDF、图片、产品截图、数据表
- 必须保留的业务边界、产品能力、场景要求、政策依据
- 想使用的受众 Skill、评审专家 Skill、设计语言包
- 不希望出现的表达方式,例如“不要普通卡片堆叠”“不要把左侧/右侧写进页面文案”
页面内容 MD 规范
进入 HTML/PPTX 生成前,每一页必须先经过“页面描述优化”。用户给的原始 MD 只作为事实来源,不能直接生成 HTML/PPTX。优化版页面描述建议按下面结构描述:
# 页面标题
# 本页核心结论
# 页面类型
分层架构页 / 业务流程页 / 能力体系页 / 对比分析页 / 场景价值页 / 实施路径页 / 案例成效页 / 机制说明页
# 页面版式
- 16:9 PPT 单页
- 顶部:
- 主体:
- 底部:
- 信息密度:
# 主视觉设计
这一页主要用什么图表达,主视觉承担什么解释逻辑。
# 主视觉内容
## 区域/步骤 1
-
## 区域/步骤 2
-
# 模块间关系
- 主模块:
- 辅助模块:
- 关系类型:并列 / 支撑底座 / 总分 / 贯穿型能力 / 侧挂治理层
- 表达方式:
# 主视觉与辅助内容面积预算
- 主视觉占主体区:
- 辅助模块占比:
- 是否存在双主视觉冲突:
# 页面文案
只写真正上屏的短文案。
# 页面想表达的管理价值
-
-
-
# 页面底部总结语
价值:
# 生成风险提示
- 模块关系不清:
- 主视觉占比不足:
- 贯穿型能力位置错误:
- 箭头关系不清:
# 出图要求
- 中文清晰
- 主视觉优先,文字辅助
- 不要文字过密
- 不要普通模板页注意:
左侧:、右侧:、顶部:、底部:这类词是排版指令,不是上屏文案。生成 HTML 和 PPTX 时必须清洗掉这些区域前缀。- 页面必须有 1 个明确主视觉,主视觉占主体区建议不低于 55%。
- 流程路径页中,流程主视觉应占主体区 60% 以上;价值点只做底部收束或侧边点缀,不超过 3 条。
- 监测中心、审核中心、安全中心等贯穿型能力,应作为底座、背景条、侧挂治理层或护栏,不要塞在流程中间。
生成就绪导演稿
页面描述优化版解决“讲什么、怎么组织”,但还不能直接生成。进入 HTML/PPTX 前,需要再生成一份“生成就绪导演稿”,把设计系统也读进来。
默认产物命名建议为:
[项目名]_生成就绪导演稿.md例如 平台边界双向流转_生成就绪导演稿.md。HTML、PNG、PPTX 生成时,应以这份导演稿作为代码 Agent 的直接输入。
它必须包含:
- 输出格式:HTML+CSS、SVG、python-pptx 或 HTML+PPTX
- 画布参数:1280×720、标题区、主体区、底部区、安全边距
- 设计系统 token:来自
design.md的颜色、字体、母版元素、组件形态、线条和箭头样式 - 字体字号参数:字体、字号档位、字重,以及每个组件的字体 / 字号 / 字重
- 固定资产引用:来自
registry.yml和design.md的母版资产路径,例如city-skyline.png - 区域坐标或比例:主视觉区、侧挂模块、底部价值区
- 组件映射:内容节点 -> 设计系统组件 -> 坐标/尺寸 -> 样式 token
- 连接规则:箭头起点、终点、方向、禁止连接
- 生成优先级:主视觉面积和关系正确优先于局部美观
这样做的好处是:页面结构稿仍然可以换风格,真正生成时又不会缺少坐标、尺寸、色彩、字号和箭头参数。
设计语言机制
默认内置 digital-zhejiang 设计语言,来源于数字浙江 PPT 模板抽象。生成时不会机械照抄某一页截图,而是读取以下文件进行风格对齐:
references/styles/digital-zhejiang/design.md
references/styles/digital-zhejiang/style-card.md
references/styles/digital-zhejiang/slide-type-map.md
references/styles/digital-zhejiang/contact-sheet.png
references/styles/digital-zhejiang/assets/city-skyline.png如果要替换 PPT 风格,可以新增一个设计语言目录,并在 registry.yml 中注册。最低要求:
design.md
style-card.md
slide-type-map.md
contact-sheet.png 或若干截图样例digital-zhejiang 字体字号规则
内置数字浙江风格默认使用以下字体字号规范。生成就绪导演稿必须把这些规则落到组件级,不能只写“正式、简洁、政务风”。
- 主字体:微软雅黑
- 允许字重:Regular / Bold
- 大标题:36 / 44 / 60 / 72,Bold
- 小标题:20 / 24 / 28,Bold
- 内容文字:16 / 18,Regular 或 Bold
- 页脚/来源:12 / 14 / 16,Regular
- 禁止:微软雅黑 Light、宋体、特殊字体
审查时要确认 HTML 和 PPTX 实际渲染图都满足上述档位。若 PPTX 因字体替换导致换行、溢出、遮挡或字号被压低,不能通过最终审查。
digital-zhejiang 固定母版资产
正文页右下城市背景装饰使用固定 PNG 资产:
references/styles/digital-zhejiang/assets/city-skyline.png生成 HTML/PPTX 时必须直接引用该资产,保持透明背景、宽高比和右下锚定。不要让模型自行生成城市剪影,不要用 CSS/SVG 重绘,不要替换为照片、卡通或其他城市图。
目录结构
ppt-director/
├── SKILL.md
├── README.md
├── registry.yml
├── agents/
├── references/
│ ├── audiences/ # 受众画像
│ ├── articles/ # 长文教程和离线参考文章
│ ├── reviewers/ # 评审专家
│ ├── styles/ # PPT 设计语言
│ ├── templates/ # 卡片模板
│ ├── toolchains/ # 生成工具链
│ └── workflows/ # 工作流、页面规范、审查规范
└── scripts/关键内置规范
references/workflows/page-structure-brief-schema.md:PPT 单页内容描述规范references/workflows/visual-director-optimization.md:内容 MD 到视觉导演 MD 的优化步骤references/workflows/generation-ready-director-brief.md:读取设计系统后的生成就绪导演稿references/workflows/html-preview-to-pptx-workflow.md:先 HTML 后 PPTX 的生成流程references/workflows/final-layout-review.md:最终页面布局审查规范references/workflows/design-language-workflow.md:设计语言选择和对表流程references/articles/ppt-workflow-cognitive-distillation/article.md:我的PPT工作流:认知蒸馏×进化优化×代码生成
PPTX 视觉一致性规则
PPTX 不是“能打开”就算通过。生成 PPTX 后必须导出实际渲染截图,并与已确认的 HTML/PNG 预览并排对比。
必须检查:
- 标题、判断句和模块文字是否换行或溢出
- 字体是否仍为微软雅黑或合规替代,字号是否落在设计档位,是否因字体替换导致换行/溢出
- 右下城市剪影是否直接引用
city-skyline.png,而不是模型新画或代码重绘 - 箭头方向、连接点和模块关系是否正确
- 主视觉是否仍然是页面中心,辅助内容是否没有抢视觉
- 母版元素、页脚、安全区、角标是否没有漂移
左侧/右侧/顶部/底部/中部/侧边等区域词是否没有误上屏
如果原生可编辑 PPTX 渲染后明显偏离预览,优先修复原生映射。短期无法修复且用户更重视演示效果时,输出两个版本:
视觉一致版:整页或局部栅格化,保证与 HTML/PNG 预览一致可编辑原生版:文本和形状可编辑,但标明仍需人工校准
交付时必须说明最终采用哪个版本,不能把视觉错误的可编辑 PPTX 当作最终成稿。
校验技能包
python3 scripts/validate_registry.py若输出 PASS registry targets,说明 registry.yml 中注册的受众、评审专家、设计语言、工具链文件都能正确找到。
English Reference
PPT Director
PPT Director is a pluggable Skill for producing high-quality presentations from a topic, audience model, expert reviewer, page structure brief, design language, and code-generation toolchain.
It is designed for workflows where the presentation must fit a specific audience and review standard, not just “look like a PPT”.
Core Idea
Nuwa creates cognitive models.
Darwin improves the content plan.
PPT Director orchestrates the production line.
Codex / Claude Code / OpenClaw generates HTML preview and the PPT file.PPT Director does not replace Nuwa or Darwin. It connects them.
The newest version separates content structure from visual style:
1. A page structure brief for every slide. This brief describes what the slide says, how information is organized, module placement, main visual logic, side modules, node text, value tags, bottom summary, and output constraints. 2. A visual director optimization pass between content MD and HTML generation. Product solution and PPT visual expert perspectives rewrite the content into a stronger page storyboard without changing business facts or binding a visual style. 3. A design language crosswalk before generation. The user chooses a design language, then PPT Director aligns the deck against its design.md, style-card.md, slide-type-map.md, and screenshot/contact-sheet examples. 4. A final layout gate for both HTML and PPTX. Product solution experts check business value and scenario closure; PPT experts check layout, density, main visual expression, and readability.
Page structure briefs must not contain specific design-language names, colors, fonts, master elements, or screenshot references. Screenshot examples are used only during generation for style alignment, not forced copying.
Layout-region words in a page structure brief are instructions, not visible copy. If a section is written as 左侧:公共数据共享平台 or 右侧:业务场景, generated HTML/PPTX should show 公共数据共享平台 and 业务场景, not the region prefix.
| Component | Role | Typical Output |
|---|---|---|
| Nuwa Skill | Distill audience or expert cognition | audience.skill, expert.skill |
| Darwin Skill | Iteratively optimize content | optimized content plan |
| PPT Director | Route workflow, apply design language, gate deliverables | delivery-doc, html-preview, pptx, review report |
| Coding agent | Write and run HTML/PPT generation code | .html, screenshots, .pptx |
Default Setup
This repository ships with a default government digital-reporting setup:
- Audience:
default-government-leader - Reviewer:
yuan-jiajun - Design language:
digital-zhejiang - Toolchain:
business-ppt
The default visual style is based on a blue-white “Digital Zhejiang” presentation system:
- main blue
#014EC6 - accent orange
#FFAA11 - Microsoft YaHei typography
- white content pages
- deep-blue geometric cover and closing pages
- title, architecture, matrix, numbered list, circular relation, logo wall, and QR-code slide patterns
Each design language can include:
design.md # full design system: visual DNA, master elements, layout language, rules
style-card.md # short model-facing summary
slide-type-map.md # content type -> slide type mapping
contact-sheet.png # screenshot/contact-sheet reference, optionalRepository Structure
ppt-director/
├── SKILL.md
├── registry.yml
├── agents/
│ └── openai.yaml
├── references/
│ ├── audiences/
│ ├── reviewers/
│ ├── styles/
│ ├── templates/
│ ├── toolchains/
│ └── workflows/
└── scripts/
├── add_audience.py
├── add_reviewer.py
├── add_style.py
├── import_nuwa_skill.py
└── validate_registry.pyInstallation
Install this folder as a Codex/Claude-compatible Skill using your local Skill installer.
If your environment supports installing a local Skill directory, install the ppt-director/ folder directly.
If your environment supports zip packages, zip the folder and install that package.
Recommended optional dependencies for PPT generation:
pip install python-pptx Pillow
npx skills add alchaincyf/nuwa-skill
npx skills add alchaincyf/darwin-skillNuwa and Darwin are intentionally not bundled in this repository. Install them separately so they can be upgraded and reused outside PPT workflows.
Quick Start
Ask your coding agent:
Use $ppt-director to create a PPT.
Topic: [your topic]
Audience: [who will watch it]
Goal: [what decision or understanding you want]
Duration: [X minutes]
Materials: [paste or describe source material]
Use the default digital-zhejiang design language and yuan-jiajun reviewer.
First produce a standard delivery document with page structure briefs. Then confirm the design language and prepare a PPTX generation plan.Full Workflow
1. Distill The Audience With Nuwa
Use Nuwa when the presentation depends on decision-maker psychology.
Example:
Use Nuwa to distill a cognitive model for a CFO reviewing a 5 million RMB IT budget request.
Focus on decision criteria, rejection triggers, preferred evidence, and what the first 3 slides must answer.Output:
audience.skill.mdImport it into PPT Director as an audience card.
2. Distill An Expert Reviewer
Use Nuwa to create an expert perspective for review and critique.
Example:
Use Nuwa to distill Nancy Duarte as a presentation design reviewer.
Focus on narrative structure, slide signal-to-noise ratio, emotional pacing, and title rewriting rules.Output:
expert.skill.mdImport it into PPT Director as a reviewer card.
3. Generate A Content Plan
Ask PPT Director to combine the topic, audience card, and reviewer card into a reusable page structure plan.
Use $ppt-director with:
- audience: [audience-card name]
- reviewer: [reviewer-card name]
Create a page-by-page plan for a [X]-minute PPT about [topic].
Each page must include:
1. opinionated title
2. core point
3. supporting data or case
4. visual direction
5. audience psychology
6. transition logic
7. page structure brief: layout, main visual, module content, expression guidance, value tags, and output constraintsOutput:
content-plan.md3.5 Choose And Crosswalk The Design Language
Before writing PPTX code, confirm which design language to use.
Use $ppt-director.
Design language: digital-zhejiang
Please read:
- design.md
- style-card.md
- slide-type-map.md
- contact-sheet.png
Produce a design language crosswalk before generation:
1. core visual DNA
2. fixed master elements
3. allowed variants
4. forbidden deviations
5. slide-by-slide page type mappingImportant rule:
Do not force every page to match a screenshot layout.
Use screenshots as style references.
If a page naturally matches a sample page type, align it.
If the content needs a variant, keep colors, typography, master elements, component grammar, and information density consistent with design.md.4. Optimize With Darwin
For important decks, optimize the content plan before generating files.
Use Darwin to optimize content-plan.md.
Goals:
- persuasiveness
- logical clarity
- information density
- audience fit
Constraints:
- keep within [X] slides
- keep within [X] minutes
- data must remain verifiableOutput:
optimized-delivery-doc.md4.5 Add Page Structure Briefs
Before generating PPTX, make sure every page has a structure brief:
For every page in optimized-delivery-doc.md, add a page structure brief.
Each page must include:
- page title
- core conclusion
- layout
- top judgement sentence
- central main visual
- module/stage/area content
- design suggestions
- bottom value tags
- bottom summary sentence
- output constraints
Do not write vague instructions like "make a flowchart".
Describe the direction, module positions, node text, information hierarchy, and what should not appear on screen.
Do not include design-language names, colors, fonts, master elements, or screenshot references in the page structure brief.
Treat words such as `left side`, `right side`, `top`, `bottom`, `左侧`, `右侧`, `顶部`, `底部`, `中部`, and `侧边` as layout instructions. Do not display those prefixes as module titles.Reference schema:
references/workflows/page-structure-brief-schema.md4.6 Run Visual Director Optimization
Before HTML generation, run the visual director pass if the current file is still a content-style PPT MD:
Use $ppt-director to optimize content-plan.md into a visual-director MD.
Requirements:
- do not change business facts
- do not drop required materials, links, product abilities, metrics, or scenarios
- strengthen page type, layout skeleton, main visual, on-screen copy, and management value
- keep concrete design language, colors, fonts, master elements, and screenshots out of the MD
- treat layout-region words as instructions, not visible copyReference workflow:
references/workflows/visual-director-optimization.md5. Generate HTML Preview First
Use PPT Director with a toolchain.
Business deck:
Use $ppt-director to generate an HTML design preview from optimized-delivery-doc.md.
Toolchain: business-ppt
Design language: digital-zhejiang
Output: HTML preview + contact sheet
Requirements:
- use page structure brief as the content/layout source
- use the visual-director optimized MD when available
- use design.md as the visual style source
- align with design.md and contact-sheet style references
- do not force every page to copy screenshot layouts
- generate per-slide screenshots and a contact sheet
- run final-layout-review.md using product solution expert + PPT expert perspectives
- clean layout-region prefixes before rendering visible text
- if score is below 80 or any P0 issue exists, revise HTML before continuing5.5 Map Confirmed HTML To PPTX
Only after the HTML preview passes final layout review and the user confirms it:
Use $ppt-director to map the approved HTML preview to editable PPTX.
Requirements:
- do not default to full-page screenshots
- preserve editable text, rectangles, arrows, matrices, flows, and layer structures where practical
- rasterize only complex local visuals or screenshots
- export preview screenshots from the PPTX
- run final-layout-review.md again before delivery
- only output final PPTX if score >= 80 and there are no P0 issuesVisual/keynote deck:
Use $ppt-director with toolchain visual-ppt.
First list image-generation prompts for every slide that needs a strong visual.
After I provide image paths, generate and run the PPTX code.6. Review From Audience, Product Solution, And PPT Perspectives
Use $ppt-director to review the final PPT with:
1. [audience-card] as the audience perspective
2. [reviewer-card] as the expert perspective
For each slide, output:
- first reaction
- unanswered question
- trust issue
- score from 1 to 10
- required change
Final delivery also requires:
Use final-layout-review.md to review HTML/PPTX with: 1. product solution expert perspective 2. PPT expert perspective 3. current design language perspective
Do not mark the deck as final if score < 80 or any P0 issue remains.
Standard Delivery Document
Before code generation, PPT Director should normalize content into this interface:
【PPT信息】
- 标题:
- 副标题:
- 受众:
- 目的:
- 时长:
- PPT类型:业务PPT / 酷炫视觉PPT
- 评审专家:
- 核心信息:
- 输出方式:
【逐页内容】
第1页 | 类型:封面
- 标题:
- 副标题:
- 要点:
- 数据/图表需求:
- 视觉需求:
- 推荐页型:
- 页面结构导演稿:
- 演讲备注:
【生成配置(仅代码生成阶段使用)】
- 设计语言:
- 设计系统文档:
- 样例截图/Contact Sheet:
- style-card:
- slide-type-map:
【HTML设计预览配置】
- HTML输出目录:
- 每页截图目录:
- Contact Sheet:
- HTML最终布局审查报告:
- 是否已通过HTML审查:
【PPTX映射配置】
- 映射来源HTML:
- PPTX输出路径:
- PPTX最终布局审查报告:
- 是否已通过PPTX审查:See references/workflows/delivery-schema.md for the full format.
Extending PPT Director
PPT Director is intentionally registry-driven.
Add A Style
Prepare:
design.md
style-card.md
slide-type-map.md
contact-sheet.png optionalRun:
python scripts/add_style.py \
--name mckinsey-blue \
--design-doc /path/to/design.md \
--style-card /path/to/style-card.md \
--slide-map /path/to/slide-type-map.md \
--contact-sheet /path/to/contact-sheet.png \
--use-when "consulting reports, strategy analysis, management presentations"Add A Reviewer
python scripts/add_reviewer.py \
--name duarte \
--card /path/to/reviewer-card.md \
--use-when "narrative presentations, keynote speeches, product launches"Add An Audience
python scripts/add_audience.py \
--name cfo-budget-reviewer \
--card /path/to/audience-card.md \
--use-when "budget approval, ROI review, finance decision"Import A Nuwa Skill
python scripts/import_nuwa_skill.py \
/path/to/yuan-jiajun-perspective.zip \
--type reviewer \
--name yuan-jiajunThe import script creates a card. Register it with add_reviewer.py or update registry.yml.
Validate
python scripts/validate_registry.pyExpected output:
PASS registry targets: 8Best Practices
- Use Nuwa when the audience or expert lens matters.
- Use Darwin for important decks that need stronger persuasion.
- Use PPT Director for orchestration and standardization.
- Keep styles, audiences, reviewers, and toolchains separate.
- Always confirm the design language before PPT generation.
- Generate HTML preview and contact sheet before PPTX unless the user explicitly asks for a quick draft.
- Run final layout review on both HTML and PPTX; product solution expert and PPT expert perspectives are mandatory.
- Do not deliver a final deck when the final layout review score is below 80 or P0 issues remain.
- Keep page structure briefs free of concrete style tokens.
- Do not put layout-region labels such as
左侧:,右侧:,顶部:,底部:,中部:, or侧边:onto slides as visible copy. - Align generated slides with
design.md; use screenshot examples for style calibration, not rigid page copying. - Do not hard-code one expert or one visual style into
SKILL.md. - Prefer a standard delivery document before generating PPT files.
Limitations
python-pptxis good for structure, content, charts, and basic layout, but not advanced animation.- Brand-grade visual polish may still need final manual adjustment in PowerPoint or Keynote.
- AI-generated images should be checked for text artifacts, fake logos, and inconsistent style.
- For strict brand templates, provide a real
.pptxtemplate and reuse its layouts.
One-Line Summary
Nuwa creates the thinking models.
Darwin improves the content.
PPT Director orchestrates the deck.
The coding agent generates the file.<!-- This article was imported from Feishu for offline reference inside the ppt-director skill repository. Keep source.json and media-manifest.json beside this file when updating from the original wiki page. -->
我的PPT工作流:认知蒸馏×进化优化×代码生成
📌 核心理念
用AI来做ppt,不是简单地让AI帮你写PPT内容,而是通过认知蒸馏技术,先构建「受众思维模型」和「评审专家模型」,再由PPT Director基于这些结构化模型,像导演一样调度全流程,生成高度适配的PPT。
!534f54b6-0f27-4e58-b3a6-5e6553caf9b2.png
🏗️ 环境搭建(一次性配置)
前置条件
| 工具 | 用途 | 安装方式 |
|---|---|---|
| Claude Code | 统一工作台(对话+代码+Skill调度) | 官方安装 |
| Python 3.8+ | 运行PPT生成脚本 | 系统自带或官网下载 |
| python-pptx | PPT文件生成库 | pip install python-pptx |
| 女娲.skill | 认知蒸馏引擎 | npx skills add alchaincyf/nuwa-skill |
| PPT Director.skill | PPT全流程导演 | npx skills add hermess/ppt-director |
| 达尔文.skill(可选) | 自动迭代优化 | npx skills add alchaincyf/darwin-skill |
🗺️ 完整流程总览
!d28abda1-0863-44dc-9956-7b33929dd7b3.png
阶段1:受众蒸馏
1.1 为什么要先蒸馏受众?
一句话解释: PPT不是写给自己看的。你需要先搞清楚「看PPT的那个人脑子怎么转的」,然后才能决定每一页放什么。
传统做法的问题: 凭感觉猜受众想看什么 → 写完发现不对 → 反复修改。
认知蒸馏的优势: 先用AI系统性地分析受众的决策模式 → 基于模型精确生产 → 一次到位。
1.2 确定蒸馏目标
先想清楚你的PPT是给谁看的:
| 场景 | 蒸馏目标 | 女娲能提供的价值 |
|---|---|---|
| 政府汇报 | 具体领导(如分管副省长) | 决策框架、关注维度、汇报偏好、否决触发器 |
| 融资路演 | 具体投资人 / VC角色 | 投资决策漏斗、否决原因、关注指标 |
| 向上汇报 | 具体上级 / 高管角色 | 关注维度、汇报偏好、决策风格 |
| 销售提案 | 行业客户角色 | 采购决策流程、核心痛点、信任建立方式 |
| 技术分享 | 开发者群体 | 技术审美、知识假设、说服路径 |
| 公开演讲 | 大会观众画像 | 注意力曲线、知识水平、期待类型 |
1.3 执行蒸馏
在 Claude Code 中输入:
情况A:你知道具体是谁(最佳)
用女娲蒸馏一个"[具体人名]"
例如:用女娲蒸馏一个"袁家军"情况B:你只知道角色类型
用女娲蒸馏一个"[角色类型]"的认知模型
例如:
- 用女娲蒸馏一个"省级分管数字化的副省长"
- 用女娲蒸馏一个"红杉资本早期投资人"
- 用女娲蒸馏一个"传统制造业数字化转型负责人"情况C:你有具体的场景约束
用女娲蒸馏:
角色:某省分管数字化改革的副省长
场景:他在听一个区县的数字化改革成果汇报
他的决策模型是什么?关心什么?什么会让他认可?什么让他反感?1.4 女娲的工作过程(自动完成,你不需要操作)
女娲会自动调度 6个Agent 并行工作:
1. 著作Agent — 调研该角色的著作、文章、公开讲话 2. 对话Agent — 分析其对话风格、提问方式、思维习惯 3. 表达Agent — 提炼其常用表达、比喻、价值判断方式 4. 批评Agent — 找出其常见的否定模式、反感的事物 5. 决策Agent — 梳理其决策框架、权重分配 6. 时间线Agent — 追踪其认知演变和立场变化
完成后进行交叉验证,输出一份结构化的 .skill.md 文件。
1.5 Skill文件输出示例
以下是女娲蒸馏「政府领导」后可能的输出片段:
# yuan-jiajun.skill.md
## 心智模型
- 核心思维:系统工程思维 × 数据驱动 → 追求可量化的治理成效
- 决策框架:问题导向 → 数据验证 → 体制机制创新 → 可复制推广
- 注意力分配:前3页必须看到核心成效和亮点数据
## 决策启发式
1. 有没有"抓手"——具体的、可操作的工程/项目
2. 数据是否闭环——输入→产出→成效是否可追溯
3. 是否可复制——这个经验能不能推广到其他地区
4. 风险是否可控——有没有预案和底线
## 否决触发器
- 只说理念不讲落地
- 数据前后不一致
- 避谈困难和挑战
- 表达空泛没有具体案例
## 偏好的信息呈现
- 先总后分,先结论后论据
- 数据可视化优先于大段文字
- 对比呈现:改革前vs改革后1.6 转换为PPT Director可用的卡片
这一步是关键桥梁。 女娲输出的 .skill.md 需要通过 Adapter 转换为 PPT Director 能直接使用的格式:
将 yuan-jiajun.skill.md 转换为 PPT Director 的 audience-card.md 格式转换后你会得到一个标准化的 audience-card.md,PPT Director 后续所有阶段都会自动调用它。
💡 小白提示: 如果你不想手动转换,直接告诉 Claude Code「用女娲蒸馏受众后,转成PPT Director的audience-card」,它会一步完成。
1.7 如果你不想蒸馏(快速开始)
PPT Director 有默认配置:
- 默认受众 = 政府领导
- 默认评审 = 袁家军式
- 默认风格 = 内置的蓝色汇报风格
如果你的场景恰好是给政府汇报数字化项目,可以直接跳过蒸馏,使用默认配置。
阶段2:评审专家蒸馏
2.1 为什么需要评审专家?
核心逻辑: 好的PPT不是你自己觉得好,而是过得了专家的审。PPT Director内置了一个"评审关卡"——它会模拟一个严格的专家来挑你PPT的毛病。
受众卡 vs 评审卡的区别:
| 维度 | audience-card(受众卡) | reviewer-card(评审卡) |
|---|---|---|
| 回答的问题 | 他想听什么? | 他会挑什么毛病? |
| 视角 | 接收者视角 | 审查者视角 |
| 用途 | 决定内容选什么、排什么序 | 决定逻辑够不够硬、表达够不够精准 |
| 默认角色 | 政府领导 | 袁家军式严格评审 |
2.2 执行蒸馏
用女娲蒸馏一个"[评审专家]",重点关注其审查逻辑和否决习惯
例如:
- 用女娲蒸馏"袁家军"作为评审专家——他审阅汇报时的思维模式
- 用女娲蒸馏"沈南鹏"作为评审专家——他否决BP的常见原因
- 用女娲蒸馏"Nancy Duarte"作为评审专家——她评价PPT设计的标准2.3 转换为评审卡
将蒸馏结果转换为 PPT Director 的 reviewer-card.md 格式评审卡的核心内容包括:
- 审查维度:这个专家从哪几个角度看问题
- 合格标准:每个维度什么水平算过关
- 常见否决点:什么情况他会直接否定
- 加分项:什么会让他眼前一亮
2.4 推荐的评审专家类型
| 你的PPT类型 | 推荐蒸馏的评审专家 | 你获得的能力 |
|---|---|---|
| 政府汇报 | 袁家军 / 省级领导 | 数据闭环检查、抓手逻辑检查 |
| 融资BP | 沈南鹏 / 具体投资人 | 商业逻辑检查、否决点预判 |
| 技术方案 | 行业CTO | 技术可行性检查、架构合理性 |
| 产品提案 | 俞军 / 产品大师 | 用户价值检查、需求真伪判断 |
| 演讲设计 | Nancy Duarte | 叙事结构检查、视觉原则检查 |
2.5 同一个人可以同时作为受众和评审
这是很常见的场景。 比如你要给袁家军汇报:
用女娲蒸馏"袁家军",同时生成:
1. audience-card.md(他作为受众想听什么)
2. reviewer-card.md(他作为评审会挑什么毛病)一个人的心智模型可以从两个角度来使用——作为"听众"他关注什么,作为"审查者"他会否定什么。
---
阶段3:PPT Director 判断阶段 + 选择路径
3.1 PPT Director 是什么?
一句话解释: PPT Director 就是你的「PPT导演」。你给它材料、告诉它受众是谁,它会像一个经验丰富的导演一样,安排整个PPT的生产流程。
它不是一个简单的模板——它是一套完整的调度系统:
!6d05d88d-64a7-4d23-a6d8-9e94b5b8aa10.png
3.2 PPT Director 的5个工作阶段
PPT Director 会自动判断你当前处于哪个阶段,然后从对应阶段开始工作:
| 阶段 | 判断依据 | Director 会做什么 |
|---|---|---|
| A 灵感激发 | 你只有一个主题/想法 | 帮你发散思路、确认受众、初步规划方向 |
| B 内容打磨 | 你有思路或原始材料 | 生成观点型大纲、标准交付文档 |
| C 视觉定义 | 你已有标准交付文档 | 做页型分配、风格映射 |
| D 代码生成 | 视觉定义已完成 | 生成python-pptx代码,输出.pptx文件 |
| E 迭代优化 | 你已有PPT初稿 | 用三重评审挑毛病,输出修改清单 |
你不需要记住这些阶段。 只需要告诉Director你的情况,它会自动判断。
3.3 启动Director
在 Claude Code 中,按照你的实际情况输入:
情况1:你只有一个想法
我要做一个PPT,主题是"[XX区数字化改革成效汇报]"
受众是省级领导
帮我用PPT Director来规划情况2:你有材料了
我有以下材料,需要做成PPT:
[粘贴你的材料/文档]
受众:[XX领导/投资人/客户]
目的:[说服对方做什么决策]
时长:[X分钟]
用PPT Director帮我从B阶段开始情况3:你已经有大纲了
我已经有PPT大纲如下:
[你的大纲]
用PPT Director帮我做视觉定义和代码生成阶段4:内容规划(Director B阶段)
4.1 这一步的核心逻辑
这一步是整个流程最关键的转化——从"你有什么素材"变成"每页该放什么"。
PPT Director 不是简单地把你的材料分成几页。它的逻辑是:
受众关注什么(audience-card)
× 专家会怎么审(reviewer-card)
× 你有什么素材
= 每一页应该放什么、怎么放、为什么放4.2 Director 的内容规划规则
PPT Director 有明确的标准,它产出的大纲必须满足:
| 规则 | 说明 |
|---|---|
| 观点型标题 | 每页标题不是"项目背景",而是一个观点(如"三年改革让办事时间缩短87%") |
| 每页3个要点 | 每页最多承载3个核心要点,不能贪多 |
| 受众注意力匹配 | 前3页必须抓住受众注意力(基于audience-card的注意力分配模型) |
| 证据链完整 | 每个观点都有对应的数据/案例支撑 |
| 页型映射 | 每页分配标准页型(封面页/数据页/对比页/流程页等17种) |
4.3 风格卡:蓝色汇报风格(默认)
PPT Director 默认使用「蓝色汇报」风格包。这个风格包定义了:
色彩规范:
- 主色:深蓝 #003366 — 体现政务稳重
- 辅色:科技蓝 #0066CC — 体现数字化属性
- 强调色:活力橙 #FF6600 — 用于数据高亮
- 背景色:浅灰 #F5F7FA — 大面积使用
版式原则:
- 标题区固定在上方1/5
- 内容区占中间3/5
- 数据可视化优先于文字描述
- 图标化表达优先于段落文字
禁忌:
- 不使用圆角过大的装饰
- 不使用卡通风格图标
- 不出现英文为主的排版
- 避免信息过载(每页文字不超过50字)
4.4 页型映射表(slide-type-map)
PPT Director 内置了 17种标准页型,每页内容会映射到对应的页型:
| 页型编号 | 名称 | 适用场景 |
|---|---|---|
| T01 | 封面页 | 标题+副标题+汇报人 |
| T02 | 目录页 | 整体结构概览 |
| T03 | 章节过渡页 | 大段落切换 |
| T04 | 纯文字观点页 | 一个核心观点+3个要点 |
| T05 | 数据图表页 | 柱状图/折线图/饼图 |
| T06 | 对比页 | 改革前vs改革后 |
| T07 | 流程图页 | 步骤/时间线/路径 |
| T08 | 架构图页 | 系统架构/组织结构 |
| T09 | 案例展示页 | 具体案例+成效 |
| T10 | 数字突出页 | 1-3个大数字+说明 |
| T11 | 图片+文字页 | 场景图配文字 |
| T12 | 引言页 | 领导讲话/政策引用 |
| T13 | 矩阵页 | 2×2/3×3分类分析 |
| T14 | 列表页 | 并列事项罗列 |
| T15 | 地图页 | 地理分布/区域展示 |
| T16 | 时间轴页 | 里程碑/发展历程 |
| T17 | 总结页 | 结论+下一步 |
Director 会根据每页内容自动分配最合适的页型。
4.5 标准交付文档示例
Director B阶段完成后,你会得到一份「标准交付文档」(delivery-schema格式),类似这样:
# PPT标准交付文档:XX区数字化改革成效汇报
## 元信息
- 受众:省级分管数字化副省长
- 评审标准:袁家军式
- 风格:数字浙江
- 总页数:15页
- 时长:20分钟
---
## 第1页
- 页型:T01 封面页
- 标题:XX区数字化改革三年答卷
- 副标题:以数字化改革撬动整体智治
- 视觉:深蓝渐变背景 + 区域标志性图像
## 第2页
- 页型:T10 数字突出页
- 标题观点:三组数据看改革成效
- 要点1:办事时间缩短87%(367分钟→48分钟)
- 要点2:群众满意度从72%提升至96%
- 要点3:年度节省行政成本2.3亿元
- 视觉:三个大数字横排,每个配变化箭头
- 受众心理:看到具体数据,建立初步信任
## 第3页
- 页型:T06 对比页
- 标题观点:从"群众跑"到"数据跑"的根本转变
- 要点1:改革前——跑5个部门、交23份材料、等15天
- 要点2:改革后——一个窗口、0份纸质材料、即时办结
- 要点3:底层逻辑——打通了XX个数据接口
- 视觉:左右对比,左灰右蓝,箭头连接
- 受众心理:直观感受到变化的力度
## 第4-15页...(依次展开)
---
## 评审三检查
### 受众检查(Audience Check)
- ✅ 前3页是否抓住注意力?→ 第2页大数据冲击
- ✅ 观众是否关心这些内容?→ 对标省级考核指标
- ✅ 信息密度是否匹配受众耐心?→ 控制在50字/页以内
### 评审检查(Reviewer Check)
- ✅ 逻辑有抓手吗?→ 数据→原因→机制→可复制
- ✅ 风险闭环了吗?→ 第12页专门讲挑战和应对
- ✅ 表达不空泛?→ 每页都有具体案例或数据
### 风格检查(Style Check)
- ✅ 颜色规范?→ 全部使用数字浙江色卡
- ✅ 字数控制?→ 最多页不超过45字
- ✅ 页型使用?→ 17种页型覆盖12种4.6 如果你要修改大纲
第5页的观点不够有力,
帮我基于受众卡重新生成一个更能打动省级领导的标题
第8页和第9页内容重复了,
帮我合并并重新分配页型阶段5:达尔文优化(可选但推荐)
5.1 什么时候需要达尔文?
| 场景 | 是否建议用达尔文 |
|---|---|
| 日常周报PPT | ❌ 不需要,直接进阶段6 |
| 重要领导汇报 | ✅ 推荐 |
| 融资路演BP | ✅ 强烈推荐 |
| 公开大会演讲 | ✅ 强烈推荐 |
| 内部沟通PPT | ❌ 通常不需要 |
5.2 将内容规划喂给达尔文
用达尔文优化上面的PPT标准交付文档
优化目标:
- 说服力(每页的论点是否足够有力)
- 逻辑清晰度(页与页之间的连贯性)
- 信息密度(是否有冗余或缺失)
约束条件:
- 保持15页以内
- 保持20分钟可讲完
- 受众卡和评审卡的要求不能违背5.3 达尔文的工作机制
达尔文会自动执行以下循环:
!8e3d2326-7322-4573-b3f3-dc069d882161.png
5.4 查看优化结果
显示达尔文优化前后的对比,列出每一处修改及其理由阶段6:代码生成与执行(Director D阶段)
6.1 一步生成PPT
这一步你只需要一句话,Director会基于标准交付文档自动完成所有工作:
基于上面的标准交付文档,生成PPT文件
使用配置:
- 工具链:python-pptx
- 风格:数字浙江(已在风格卡中定义)
- 比例:16:9
- 直接运行并输出 presentation.pptx6.2 Director 在代码生成阶段会做什么
Director 会按照以下逻辑生成代码:
1. 读取风格卡 → 确定颜色、字体、间距等视觉参数 2. 读取页型映射 → 每种页型对应固定的布局模板 3. 逐页生成 → 按标准交付文档逐页填充内容 4. 执行代码 → 直接运行python-pptx脚本 5. 输出文件 → 生成可直接打开的 .pptx 文件
6.3 关于风格卡的参数说明(蓝色汇报)
风格卡中定义的关键参数,Director会严格遵守:
颜色系统:
- primary: #003366(深蓝,标题和重点元素)
- secondary: #0066CC(科技蓝,图表和装饰)
- accent: #FF6600(橙色,数据高亮和CTA)
- background: #F5F7FA(浅灰底色)
- text: #333333(正文色)
- text-light: #666666(辅助文字)
字体系统:
- 标题:微软雅黑 Bold 28-32pt
- 副标题:微软雅黑 Regular 18-22pt
- 正文:微软雅黑 Regular 14-16pt
- 数据:DIN / Impact 48-72pt(大数字展示)
间距规则:
- 页面边距:上下左右各占10%
- 标题区:页面上方20%
- 内容区:页面中间60%
- 页脚区:页面下方10%(页码+Logo)6.4 高级定制选项
使用自定义模板:
读取 template.pptx 作为模板(已有品牌色和母版),
基于模板的版式生成内容,输出 final.pptx指定特定页的图表数据:
第5页的柱状图数据:
- 2022年: 1200件
- 2023年: 3400件
- 2024年: 8700件
用python-pptx的chart功能直接生成批量输出多版本:
基于同一份标准交付文档,生成3个版本:
1. 完整版(15页,面对面汇报用)→ full.pptx
2. 精简版(8页,邮件发送用)→ brief.pptx
3. 摘要版(3页,电梯汇报用)→ summary.pptx6.5 常见视觉风格快捷指令
| 风格 | 一句话指令 |
|---|---|
| 蓝色汇报(默认) | 使用默认风格卡 |
| 苹果风 | 风格改为:极简、大留白、深色渐变背景、一页一句话 |
| 麦肯锡风 | 风格改为:框架图、蓝灰色系、信息密度高、结论先行 |
| TED风 | 风格改为:大图全屏、最少文字、故事驱动、黑底白字 |
| 数据驱动 | 风格改为:图表为主、数字突出、灰白底色、注释清晰 |
阶段7:评审验证 + 迭代(Director E阶段)
7.1 评审三检查
这是本方法论最独特的闭环——用蒸馏出的受众模型和评审模型来验证你的产出。
PPT Director 内置了「评审三检查」协议:
!e9080403-877a-4ca8-9adb-acd7f69abe7e.png
7.2 执行评审
对当前PPT执行评审三检查,
按P0/P1/P2优先级输出修改清单7.3 修改清单示例
Director 的评审输出会是这样:
## 评审修改清单
### P0(必须修改,否则汇报有风险)
1. 第4页:缺少数据来源标注 → 领导可能质疑数据可信度
2. 第8页:只谈成绩不谈困难 → 袁家军式评审会认为"回避问题"
### P1(建议修改,改了明显更好)
3. 第2页:三组数据并列缺乏逻辑递进 → 改为"效率→体验→成本"递进
4. 第11页:文字过多(82字) → 压缩到50字以内,图表化呈现
### P2(可优化,锦上添花)
5. 第6页:可增加一个"改革前后"的对比动画建议
6. 第14页:总结页可增加"下一步时间表"7.4 执行修改
按照上面的修改清单,先修改所有P0项,再修改P1项
然后重新生成PPT代码并运行7.5 迭代循环
如果修改后还有问题,可以继续迭代:
修改完成后,再执行一次评审三检查
确认所有P0已解决💡 小白提示: 通常1-2轮迭代就够了。如果是特别重要的汇报,可以做3轮。
🎯 快速路径:4种常见场景的精简操作
场景A:给政府领导做数字化汇报(使用默认配置)
# 全部在 Claude Code 中执行
# Step 1:直接启动(使用默认受众+评审+风格)
"我要做一个PPT,给省级领导汇报XX区的数字化改革成效。
材料如下:[粘贴你的材料]
时长20分钟,15页左右。
用PPT Director帮我做,使用默认配置。"
# Step 2:确认大纲后生成
"大纲可以,直接生成PPT文件"
# Step 3:评审检查
"对这个PPT执行评审三检查"
# Step 4:修改并重新生成
"按修改清单改完后重新生成"预计耗时:15-25分钟
场景B:给特定领导汇报(需要蒸馏受众)
# Step 1:蒸馏受众
"用女娲蒸馏'[领导姓名]',同时生成audience-card和reviewer-card"
# Step 2:启动Director
"材料如下:[粘贴材料]
用PPT Director的controlled路径,
使用刚蒸馏的受众卡和评审卡,
风格用数字浙江默认"
# Step 3:达尔文优化(因为重要)
"用达尔文优化标准交付文档,重点提升说服力"
# Step 4:生成PPT
"生成PPT文件"
# Step 5:评审+迭代
"执行评审三检查,修改P0后重新生成"预计耗时:35-50分钟
场景C:给投资人做融资BP
# Step 1:蒸馏投资人
"用女娲蒸馏'红杉资本早期投资人'的认知模型,重点关注否决原因"
# Step 2:蒸馏BP评审专家
"用女娲蒸馏'Guy Kawasaki'作为评审专家"
# Step 3:启动Director(premium路径)
"我要做融资BP:
项目:[一句话介绍]
阶段:[Pre-A / A轮 / ...]
融资额:[金额]
关键数据:[核心指标]
用PPT Director的premium路径,10页以内"
# Step 4:达尔文优化
"用达尔文优化,重点提升数据可信度和说服力"
# Step 5:生成+评审
"生成PPT → 执行评审三检查 → 修改 → 重新生成"
# Step 6:受众模拟
"以投资人Skill的视角,逐页审查:他看到每页会怎么想?会问什么?"预计耗时:60-90分钟
场景D:技术分享/公开演讲
# Step 1:蒸馏受众
"用女娲蒸馏'参加技术大会的高级开发者'的认知模型"
# Step 2:蒸馏演讲风格(可选)
"用女娲蒸馏'TED演讲的叙事结构方法论'"
# Step 3:启动Director
"主题:[XX]
时长:40分钟
风格:大图少字、故事驱动
用PPT Director规划30页技术分享PPT"
# Step 4:优化+生成
"达尔文优化 → 生成PPT → 评审检查"
# Step 5:图片需求清单
"列出所有需要配图的页面和图片描述,
我将用Midjourney/其他工具生成后替换"预计耗时:40-60分钟
🔧 进阶技巧
技巧1:复用Skill库
蒸馏一次,反复使用:
我之前蒸馏的 audience-gov-leader.skill.md,
这次要做另一个项目的汇报PPT,直接调用这个受众卡建议建立个人Skill库:
audiences/ ← 各类受众认知模型
gov-leader.skill.md
vc-investor.skill.md
enterprise-buyer.skill.md
reviewers/ ← 各类评审专家模型
yuan-jiajun.skill.md
nancy-duarte.skill.md
styles/ ← 风格包(可自定义)
digital-zhejiang/
tech-minimal/
corporate-blue/技巧2:一个人同时做受众和评审
最常见的场景是「给某个领导汇报」——他既是受众也是评审。
用女娲蒸馏"[领导姓名]"
输出两个视角:
1. 作为受众:他想听什么、他的注意力怎么分配
2. 作为评审:他会问什么问题、什么会让他否定
分别输出 audience-card.md 和 reviewer-card.md技巧3:自定义风格包
如果默认的「蓝色汇报」风格不适合你,可以创建自定义风格:
帮我创建一个新的风格卡,参数如下:
- 主色:[你的品牌色]
- 字体:[你的字体]
- 风格关键词:[极简/科技/活力/稳重...]
- 禁忌:[不能出现什么]
输出为 style-card.md 格式,供PPT Director使用技巧4:演讲稿与PPT同步生成
基于标准交付文档,同时生成:
1. PPT文件(presentation.pptx)
2. 配套演讲稿(每页对应的讲稿,含时间标注)
3. Q&A预案(基于受众Skill预测可能的提问和建议回答)技巧5:用评审卡做"红蓝对抗"
在重要汇报前,模拟最严格的审查:
同时调用以下两个角色审查我的PPT:
1. audience-card(受众视角)——他是否想听
2. reviewer-card(评审视角)——他是否能通过
对每页分别给出两个视角的评价:
- 受众满意度(1-10)
- 评审通过率(通过/风险/不通过)
- 改进建议💡 最后的一句话总结
蒸馏受众认知 → 蒸馏评审专家 → Director规划内容 → 达尔文打磨 → 代码生成PPT → 三重评审验证 → 迭代直到过关全程在 Claude Code 一个终端中完成。女娲负责"懂人",Director负责"造PPT",达尔文负责"打磨"——三位一体,一站到底。核心逻辑只有一句话:先搞清楚他的脑子怎么转,再决定PPT每页放什么。
[
{
"name": "534f54b6-0f27-4e58-b3a6-5e6553caf9b2.png",
"token": "PkKrb8iGWoedSaxmOntc3YahnOe",
"mime": "image/png",
"href_present": true,
"href": "[redacted temporary Feishu download URL; asset is downloaded locally]",
"path": "assets/534f54b6-0f27-4e58-b3a6-5e6553caf9b2.png",
"downloaded": true,
"download_method": "href-curl",
"download_returncode": 0,
"bytes": 59860
},
{
"name": "d28abda1-0863-44dc-9956-7b33929dd7b3.png",
"token": "XjtbbNvxmotwY4xMQ9ocualOnch",
"mime": "image/png",
"href_present": true,
"href": "[redacted temporary Feishu download URL; asset is downloaded locally]",
"path": "assets/d28abda1-0863-44dc-9956-7b33929dd7b3.png",
"downloaded": true,
"download_method": "href-curl",
"download_returncode": 0,
"bytes": 226483
},
{
"name": "6d05d88d-64a7-4d23-a6d8-9e94b5b8aa10.png",
"token": "CoeZbnjmcoJG0Zx7BsKcZBQTnre",
"mime": "image/png",
"href_present": true,
"href": "[redacted temporary Feishu download URL; asset is downloaded locally]",
"path": "assets/6d05d88d-64a7-4d23-a6d8-9e94b5b8aa10.png",
"downloaded": true,
"download_method": "href-curl",
"download_returncode": 0,
"bytes": 95056
},
{
"name": "8e3d2326-7322-4573-b3f3-dc069d882161.png",
"token": "M9AMbvB04ouUMPxQ6IPcaTGInng",
"mime": "image/png",
"href_present": true,
"href": "[redacted temporary Feishu download URL; asset is downloaded locally]",
"path": "assets/8e3d2326-7322-4573-b3f3-dc069d882161.png",
"downloaded": true,
"download_method": "href-curl",
"download_returncode": 0,
"bytes": 62063
},
{
"name": "e9080403-877a-4ca8-9adb-acd7f69abe7e.png",
"token": "SNNdbM5jRobe2CxY2DicUpYQnFA",
"mime": "image/png",
"href_present": true,
"href": "[redacted temporary Feishu download URL; asset is downloaded locally]",
"path": "assets/e9080403-877a-4ca8-9adb-acd7f69abe7e.png",
"downloaded": true,
"download_method": "href-curl",
"download_returncode": 0,
"bytes": 96224
}
]
{
"ok": true,
"identity": "bot",
"data": {
"document": {
"content": "<title>我的PPT工作流:认知蒸馏×进化优化×代码生成</title><h2>📌 核心理念</h2><p /><p>用AI来做ppt,不是简单地让AI帮你写PPT内容,而是通过认知蒸馏技术,先构建「受众思维模型」和「评审专家模型」,再由PPT Director基于这些结构化模型,像导演一样调度全流程,生成高度适配的PPT。</p><img name=\"534f54b6-0f27-4e58-b3a6-5e6553caf9b2.png\" mime=\"image/png\" scale=\"1.000000\" src=\"PkKrb8iGWoedSaxmOntc3YahnOe\" /><h2>🏗️ 环境搭建(一次性配置)</h2><p /><h3>前置条件</h3><table><colgroup><col /><col /><col /></colgroup><tbody><tr><td><p>工具</p></td><td><p>用途</p></td><td><p>安装方式</p></td></tr><tr><td><p>Claude Code</p></td><td><p>统一工作台(对话+代码+Skill调度)</p></td><td><p>官方安装</p></td></tr><tr><td><p>Python 3.8+</p></td><td><p>运行PPT生成脚本</p></td><td><p>系统自带或官网下载</p></td></tr><tr><td><p>python-pptx</p></td><td><p>PPT文件生成库</p></td><td><p><code>pip install python-pptx</code></p></td></tr><tr><td><p>女娲.skill</p></td><td><p>认知蒸馏引擎</p></td><td><p><code>npx skills add alchaincyf/nuwa-skill</code></p></td></tr><tr><td><p>PPT Director.skill</p></td><td><p>PPT全流程导演</p></td><td><p><code>npx skills add hermess/ppt-director</code></p></td></tr><tr><td><p>达尔文.skill(可选)</p></td><td><p>自动迭代优化</p></td><td><p><code>npx skills add alchaincyf/darwin-skill</code></p></td></tr></tbody></table><p /><h2>🗺️ 完整流程总览</h2><img name=\"d28abda1-0863-44dc-9956-7b33929dd7b3.png\" mime=\"image/png\" scale=\"1.000000\" src=\"XjtbbNvxmotwY4xMQ9ocualOnch\" /><h2>阶段1:受众蒸馏</h2><h3>1.1 为什么要先蒸馏受众?</h3><p /><p>一句话解释: PPT不是写给自己看的。你需要先搞清楚「看PPT的那个人脑子怎么转的」,然后才能决定每一页放什么。</p><p>传统做法的问题: 凭感觉猜受众想看什么 → 写完发现不对 → 反复修改。</p><p>认知蒸馏的优势: 先用AI系统性地分析受众的决策模式 → 基于模型精确生产 → 一次到位。</p><p /><h3>1.2 确定蒸馏目标</h3><p /><p>先想清楚你的PPT是给谁看的:</p><table><colgroup><col /><col /><col /></colgroup><tbody><tr><td><p>场景</p></td><td><p>蒸馏目标</p></td><td><p>女娲能提供的价值</p></td></tr><tr><td><p>政府汇报</p></td><td><p>具体领导(如分管副省长)</p></td><td><p>决策框架、关注维度、汇报偏好、否决触发器</p></td></tr><tr><td><p>融资路演</p></td><td><p>具体投资人 / VC角色</p></td><td><p>投资决策漏斗、否决原因、关注指标</p></td></tr><tr><td><p>向上汇报</p></td><td><p>具体上级 / 高管角色</p></td><td><p>关注维度、汇报偏好、决策风格</p></td></tr><tr><td><p>销售提案</p></td><td><p>行业客户角色</p></td><td><p>采购决策流程、核心痛点、信任建立方式</p></td></tr><tr><td><p>技术分享</p></td><td><p>开发者群体</p></td><td><p>技术审美、知识假设、说服路径</p></td></tr><tr><td><p>公开演讲</p></td><td><p>大会观众画像</p></td><td><p>注意力曲线、知识水平、期待类型</p></td></tr></tbody></table><h3>1.3 执行蒸馏</h3><p /><p>在 Claude Code 中输入:</p><p /><p>情况A:你知道具体是谁(最佳)</p><p /><pre caption=\" \" lang=\"Plain Text\"><code>用女娲蒸馏一个\"[具体人名]\"<br />例如:用女娲蒸馏一个\"袁家军\"</code></pre><p /><p>情况B:你只知道角色类型</p><p /><pre caption=\" \" lang=\"Plain Text\"><code>用女娲蒸馏一个\"[角色类型]\"的认知模型<br /><br />例如:<br />- 用女娲蒸馏一个\"省级分管数字化的副省长\"<br />- 用女娲蒸馏一个\"红杉资本早期投资人\"<br />- 用女娲蒸馏一个\"传统制造业数字化转型负责人\"</code></pre><p /><p>情况C:你有具体的场景约束</p><p /><pre caption=\" \" lang=\"Plain Text\"><code>用女娲蒸馏:<br />角色:某省分管数字化改革的副省长<br />场景:他在听一个区县的数字化改革成果汇报<br />他的决策模型是什么?关心什么?什么会让他认可?什么让他反感?</code></pre><p /><h3>1.4 女娲的工作过程(自动完成,你不需要操作)</h3><p /><p>女娲会自动调度 6个Agent 并行工作:</p><p /><ol><li>著作Agent — 调研该角色的著作、文章、公开讲话</li><li>对话Agent — 分析其对话风格、提问方式、思维习惯</li><li>表达Agent — 提炼其常用表达、比喻、价值判断方式</li><li>批评Agent — 找出其常见的否定模式、反感的事物</li><li>决策Agent — 梳理其决策框架、权重分配</li><li>时间线Agent — 追踪其认知演变和立场变化<p /></li></ol><p>完成后进行交叉验证,输出一份结构化的 <code>.skill.md</code> 文件。</p><p /><h3>1.5 Skill文件输出示例</h3><p /><p>以下是女娲蒸馏「政府领导」后可能的输出片段:</p><p /><pre caption=\" \" lang=\"Markdown\"><code># yuan-jiajun.skill.md<br /><br />## 心智模型<br />- 核心思维:系统工程思维 × 数据驱动 → 追求可量化的治理成效<br />- 决策框架:问题导向 → 数据验证 → 体制机制创新 → 可复制推广<br />- 注意力分配:前3页必须看到核心成效和亮点数据<br /><br />## 决策启发式<br />1. 有没有\"抓手\"——具体的、可操作的工程/项目<br />2. 数据是否闭环——输入→产出→成效是否可追溯<br />3. 是否可复制——这个经验能不能推广到其他地区<br />4. 风险是否可控——有没有预案和底线<br /><br />## 否决触发器<br />- 只说理念不讲落地<br />- 数据前后不一致<br />- 避谈困难和挑战<br />- 表达空泛没有具体案例<br /><br />## 偏好的信息呈现<br />- 先总后分,先结论后论据<br />- 数据可视化优先于大段文字<br />- 对比呈现:改革前vs改革后</code></pre><p /><h3>1.6 转换为PPT Director可用的卡片</h3><p /><p>这一步是关键桥梁。 女娲输出的 <code>.skill.md</code> 需要通过 Adapter 转换为 PPT Director 能直接使用的格式:</p><p /><pre caption=\" \" lang=\"Plain Text\"><code>将 yuan-jiajun.skill.md 转换为 PPT Director 的 audience-card.md 格式</code></pre><p /><p>转换后你会得到一个标准化的 <code>audience-card.md</code>,PPT Director 后续所有阶段都会自动调用它。</p><p /><blockquote><p>💡 小白提示: 如果你不想手动转换,直接告诉 Claude Code「用女娲蒸馏受众后,转成PPT Director的audience-card」,它会一步完成。</p></blockquote><p /><h3>1.7 如果你不想蒸馏(快速开始)</h3><p /><p>PPT Director 有默认配置:</p><ul><li>默认受众 = 政府领导</li><li>默认评审 = 袁家军式</li><li>默认风格 = 内置的蓝色汇报风格<p /></li></ul><p>如果你的场景恰好是给政府汇报数字化项目,可以直接跳过蒸馏,使用默认配置。</p><p /><h2>阶段2:评审专家蒸馏</h2><p /><h3>2.1 为什么需要评审专家?</h3><p /><p>核心逻辑: 好的PPT不是你自己觉得好,而是过得了专家的审。PPT Director内置了一个\"评审关卡\"——它会模拟一个严格的专家来挑你PPT的毛病。</p><p /><p>受众卡 vs 评审卡的区别:</p><p /><table><colgroup><col /><col /><col /></colgroup><tbody><tr><td><p>维度</p></td><td><p>audience-card(受众卡)</p></td><td><p>reviewer-card(评审卡)</p></td></tr><tr><td><p>回答的问题</p></td><td><p>他想听什么?</p></td><td><p>他会挑什么毛病?</p></td></tr><tr><td><p>视角</p></td><td><p>接收者视角</p></td><td><p>审查者视角</p></td></tr><tr><td><p>用途</p></td><td><p>决定内容选什么、排什么序</p></td><td><p>决定逻辑够不够硬、表达够不够精准</p></td></tr><tr><td><p>默认角色</p></td><td><p>政府领导</p></td><td><p>袁家军式严格评审</p></td></tr></tbody></table><p /><h3>2.2 执行蒸馏</h3><p /><pre caption=\" \" lang=\"Plain Text\"><code>用女娲蒸馏一个\"[评审专家]\",重点关注其审查逻辑和否决习惯<br /><br />例如:<br />- 用女娲蒸馏\"袁家军\"作为评审专家——他审阅汇报时的思维模式<br />- 用女娲蒸馏\"沈南鹏\"作为评审专家——他否决BP的常见原因<br />- 用女娲蒸馏\"Nancy Duarte\"作为评审专家——她评价PPT设计的标准</code></pre><p /><h3>2.3 转换为评审卡</h3><p /><pre caption=\" \" lang=\"Plain Text\"><code>将蒸馏结果转换为 PPT Director 的 reviewer-card.md 格式</code></pre><p /><p>评审卡的核心内容包括:</p><ul><li>审查维度:这个专家从哪几个角度看问题</li><li>合格标准:每个维度什么水平算过关</li><li>常见否决点:什么情况他会直接否定</li><li>加分项:什么会让他眼前一亮<p /></li></ul><h3>2.4 推荐的评审专家类型</h3><p /><table><colgroup><col /><col /><col /></colgroup><tbody><tr><td><p>你的PPT类型</p></td><td><p>推荐蒸馏的评审专家</p></td><td><p>你获得的能力</p></td></tr><tr><td><p>政府汇报</p></td><td><p>袁家军 / 省级领导</p></td><td><p>数据闭环检查、抓手逻辑检查</p></td></tr><tr><td><p>融资BP</p></td><td><p>沈南鹏 / 具体投资人</p></td><td><p>商业逻辑检查、否决点预判</p></td></tr><tr><td><p>技术方案</p></td><td><p>行业CTO</p></td><td><p>技术可行性检查、架构合理性</p></td></tr><tr><td><p>产品提案</p></td><td><p>俞军 / 产品大师</p></td><td><p>用户价值检查、需求真伪判断</p></td></tr><tr><td><p>演讲设计</p></td><td><p>Nancy Duarte</p></td><td><p>叙事结构检查、视觉原则检查</p></td></tr></tbody></table><p /><h3>2.5 同一个人可以同时作为受众和评审</h3><p /><p>这是很常见的场景。 比如你要给袁家军汇报:</p><p /><pre caption=\" \" lang=\"Plain Text\"><code>用女娲蒸馏\"袁家军\",同时生成:<br />1. audience-card.md(他作为受众想听什么)<br />2. reviewer-card.md(他作为评审会挑什么毛病)</code></pre><p /><p>一个人的心智模型可以从两个角度来使用——作为\"听众\"他关注什么,作为\"审查者\"他会否定什么。</p><p /><hr /><p /><h2>阶段3:PPT Director 判断阶段 + 选择路径</h2><p /><h3>3.1 PPT Director 是什么?</h3><p /><p>一句话解释: PPT Director 就是你的「PPT导演」。你给它材料、告诉它受众是谁,它会像一个经验丰富的导演一样,安排整个PPT的生产流程。</p><p /><p>它不是一个简单的模板——它是一套完整的调度系统:</p><img name=\"6d05d88d-64a7-4d23-a6d8-9e94b5b8aa10.png\" mime=\"image/png\" scale=\"1.000000\" src=\"CoeZbnjmcoJG0Zx7BsKcZBQTnre\" /><h3>3.2 PPT Director 的5个工作阶段</h3><p /><p>PPT Director 会自动判断你当前处于哪个阶段,然后从对应阶段开始工作:</p><p /><table><colgroup><col /><col /><col /></colgroup><tbody><tr><td><p>阶段</p></td><td><p>判断依据</p></td><td><p>Director 会做什么</p></td></tr><tr><td><p>A 灵感激发</p></td><td><p>你只有一个主题/想法</p></td><td><p>帮你发散思路、确认受众、初步规划方向</p></td></tr><tr><td><p>B 内容打磨</p></td><td><p>你有思路或原始材料</p></td><td><p>生成观点型大纲、标准交付文档</p></td></tr><tr><td><p>C 视觉定义</p></td><td><p>你已有标准交付文档</p></td><td><p>做页型分配、风格映射</p></td></tr><tr><td><p>D 代码生成</p></td><td><p>视觉定义已完成</p></td><td><p>生成python-pptx代码,输出.pptx文件</p></td></tr><tr><td><p>E 迭代优化</p></td><td><p>你已有PPT初稿</p></td><td><p>用三重评审挑毛病,输出修改清单</p></td></tr></tbody></table><p /><p>你不需要记住这些阶段。 只需要告诉Director你的情况,它会自动判断。</p><p /><h3>3.3 启动Director</h3><p /><p>在 Claude Code 中,按照你的实际情况输入:</p><p /><p>情况1:你只有一个想法</p><pre caption=\" \" lang=\"Plain Text\"><code>我要做一个PPT,主题是\"[XX区数字化改革成效汇报]\"<br />受众是省级领导<br />帮我用PPT Director来规划</code></pre><p /><p>情况2:你有材料了</p><pre caption=\" \" lang=\"Plain Text\"><code>我有以下材料,需要做成PPT:<br />[粘贴你的材料/文档]<br /><br />受众:[XX领导/投资人/客户]<br />目的:[说服对方做什么决策]<br />时长:[X分钟]<br /><br />用PPT Director帮我从B阶段开始</code></pre><p /><p>情况3:你已经有大纲了</p><pre caption=\" \" lang=\"Plain Text\"><code>我已经有PPT大纲如下:<br />[你的大纲]<br /><br />用PPT Director帮我做视觉定义和代码生成</code></pre><p /><h2>阶段4:内容规划(Director B阶段)</h2><p /><h3>4.1 这一步的核心逻辑</h3><p /><p>这一步是整个流程最关键的转化——从\"你有什么素材\"变成\"每页该放什么\"。</p><p /><p>PPT Director 不是简单地把你的材料分成几页。它的逻辑是:</p><p /><pre caption=\" \" lang=\"Plain Text\"><code>受众关注什么(audience-card)<br /> × 专家会怎么审(reviewer-card)<br /> × 你有什么素材<br /> = 每一页应该放什么、怎么放、为什么放</code></pre><p /><h3>4.2 Director 的内容规划规则</h3><p /><p>PPT Director 有明确的标准,它产出的大纲必须满足:</p><p /><table><colgroup><col /><col /></colgroup><tbody><tr><td><p>规则</p></td><td><p>说明</p></td></tr><tr><td><p>观点型标题</p></td><td><p>每页标题不是\"项目背景\",而是一个观点(如\"三年改革让办事时间缩短87%\")</p></td></tr><tr><td><p>每页3个要点</p></td><td><p>每页最多承载3个核心要点,不能贪多</p></td></tr><tr><td><p>受众注意力匹配</p></td><td><p>前3页必须抓住受众注意力(基于audience-card的注意力分配模型)</p></td></tr><tr><td><p>证据链完整</p></td><td><p>每个观点都有对应的数据/案例支撑</p></td></tr><tr><td><p>页型映射</p></td><td><p>每页分配标准页型(封面页/数据页/对比页/流程页等17种)</p></td></tr></tbody></table><p /><h3>4.3 风格卡:蓝色汇报风格(默认)</h3><p /><p>PPT Director 默认使用「蓝色汇报」风格包。这个风格包定义了:</p><p /><p>色彩规范:</p><ul><li>主色:深蓝 <code>#003366</code> — 体现政务稳重</li><li>辅色:科技蓝 <code>#0066CC</code> — 体现数字化属性</li><li>强调色:活力橙 <code>#FF6600</code> — 用于数据高亮</li><li>背景色:浅灰 <code>#F5F7FA</code> — 大面积使用<p /></li></ul><p>版式原则:</p><ul><li>标题区固定在上方1/5</li><li>内容区占中间3/5</li><li>数据可视化优先于文字描述</li><li>图标化表达优先于段落文字<p /></li></ul><p>禁忌:</p><ul><li>不使用圆角过大的装饰</li><li>不使用卡通风格图标</li><li>不出现英文为主的排版</li><li>避免信息过载(每页文字不超过50字)<p /></li></ul><h3>4.4 页型映射表(slide-type-map)</h3><p /><p>PPT Director 内置了 17种标准页型,每页内容会映射到对应的页型:</p><p /><table><colgroup><col /><col /><col /></colgroup><tbody><tr><td><p>页型编号</p></td><td><p>名称</p></td><td><p>适用场景</p></td></tr><tr><td><p>T01</p></td><td><p>封面页</p></td><td><p>标题+副标题+汇报人</p></td></tr><tr><td><p>T02</p></td><td><p>目录页</p></td><td><p>整体结构概览</p></td></tr><tr><td><p>T03</p></td><td><p>章节过渡页</p></td><td><p>大段落切换</p></td></tr><tr><td><p>T04</p></td><td><p>纯文字观点页</p></td><td><p>一个核心观点+3个要点</p></td></tr><tr><td><p>T05</p></td><td><p>数据图表页</p></td><td><p>柱状图/折线图/饼图</p></td></tr><tr><td><p>T06</p></td><td><p>对比页</p></td><td><p>改革前vs改革后</p></td></tr><tr><td><p>T07</p></td><td><p>流程图页</p></td><td><p>步骤/时间线/路径</p></td></tr><tr><td><p>T08</p></td><td><p>架构图页</p></td><td><p>系统架构/组织结构</p></td></tr><tr><td><p>T09</p></td><td><p>案例展示页</p></td><td><p>具体案例+成效</p></td></tr><tr><td><p>T10</p></td><td><p>数字突出页</p></td><td><p>1-3个大数字+说明</p></td></tr><tr><td><p>T11</p></td><td><p>图片+文字页</p></td><td><p>场景图配文字</p></td></tr><tr><td><p>T12</p></td><td><p>引言页</p></td><td><p>领导讲话/政策引用</p></td></tr><tr><td><p>T13</p></td><td><p>矩阵页</p></td><td><p>2×2/3×3分类分析</p></td></tr><tr><td><p>T14</p></td><td><p>列表页</p></td><td><p>并列事项罗列</p></td></tr><tr><td><p>T15</p></td><td><p>地图页</p></td><td><p>地理分布/区域展示</p></td></tr><tr><td><p>T16</p></td><td><p>时间轴页</p></td><td><p>里程碑/发展历程</p></td></tr><tr><td><p>T17</p></td><td><p>总结页</p></td><td><p>结论+下一步</p></td></tr></tbody></table><p /><p>Director 会根据每页内容自动分配最合适的页型。</p><p /><h3>4.5 标准交付文档示例</h3><p /><p>Director B阶段完成后,你会得到一份「标准交付文档」(delivery-schema格式),类似这样:</p><p /><pre caption=\" \" lang=\"Markdown\"><code># PPT标准交付文档:XX区数字化改革成效汇报<br /><br />## 元信息<br />- 受众:省级分管数字化副省长<br />- 评审标准:袁家军式<br />- 风格:数字浙江<br />- 总页数:15页<br />- 时长:20分钟<br /><br />---<br /><br />## 第1页<br />- 页型:T01 封面页<br />- 标题:XX区数字化改革三年答卷<br />- 副标题:以数字化改革撬动整体智治<br />- 视觉:深蓝渐变背景 + 区域标志性图像<br /><br />## 第2页<br />- 页型:T10 数字突出页<br />- 标题观点:三组数据看改革成效<br />- 要点1:办事时间缩短87%(367分钟→48分钟)<br />- 要点2:群众满意度从72%提升至96%<br />- 要点3:年度节省行政成本2.3亿元<br />- 视觉:三个大数字横排,每个配变化箭头<br />- 受众心理:看到具体数据,建立初步信任<br /><br />## 第3页<br />- 页型:T06 对比页 <br />- 标题观点:从\"群众跑\"到\"数据跑\"的根本转变<br />- 要点1:改革前——跑5个部门、交23份材料、等15天<br />- 要点2:改革后——一个窗口、0份纸质材料、即时办结<br />- 要点3:底层逻辑——打通了XX个数据接口<br />- 视觉:左右对比,左灰右蓝,箭头连接<br />- 受众心理:直观感受到变化的力度<br /><br />## 第4-15页...(依次展开)<br /><br />---<br /><br />## 评审三检查<br />### 受众检查(Audience Check)<br />- ✅ 前3页是否抓住注意力?→ 第2页大数据冲击<br />- ✅ 观众是否关心这些内容?→ 对标省级考核指标<br />- ✅ 信息密度是否匹配受众耐心?→ 控制在50字/页以内<br /><br />### 评审检查(Reviewer Check)<br />- ✅ 逻辑有抓手吗?→ 数据→原因→机制→可复制<br />- ✅ 风险闭环了吗?→ 第12页专门讲挑战和应对<br />- ✅ 表达不空泛?→ 每页都有具体案例或数据<br /><br />### 风格检查(Style Check) <br />- ✅ 颜色规范?→ 全部使用数字浙江色卡<br />- ✅ 字数控制?→ 最多页不超过45字<br />- ✅ 页型使用?→ 17种页型覆盖12种</code></pre><p /><h3>4.6 如果你要修改大纲</h3><p /><pre caption=\" \" lang=\"Plain Text\"><code>第5页的观点不够有力,<br />帮我基于受众卡重新生成一个更能打动省级领导的标题<br /><br />第8页和第9页内容重复了,<br />帮我合并并重新分配页型</code></pre><p /><h2>阶段5:达尔文优化(可选但推荐)</h2><p /><h3>5.1 什么时候需要达尔文?</h3><p /><table><colgroup><col /><col /></colgroup><tbody><tr><td><p>场景</p></td><td><p>是否建议用达尔文</p></td></tr><tr><td><p>日常周报PPT</p></td><td><p>❌ 不需要,直接进阶段6</p></td></tr><tr><td><p>重要领导汇报</p></td><td><p>✅ 推荐</p></td></tr><tr><td><p>融资路演BP</p></td><td><p>✅ 强烈推荐</p></td></tr><tr><td><p>公开大会演讲</p></td><td><p>✅ 强烈推荐</p></td></tr><tr><td><p>内部沟通PPT</p></td><td><p>❌ 通常不需要</p></td></tr></tbody></table><p /><h3>5.2 将内容规划喂给达尔文</h3><p /><pre caption=\" \" lang=\"Plain Text\"><code>用达尔文优化上面的PPT标准交付文档<br /><br />优化目标:<br />- 说服力(每页的论点是否足够有力)<br />- 逻辑清晰度(页与页之间的连贯性)<br />- 信息密度(是否有冗余或缺失)<br /><br />约束条件:<br />- 保持15页以内<br />- 保持20分钟可讲完<br />- 受众卡和评审卡的要求不能违背</code></pre><p /><h3>5.3 达尔文的工作机制</h3><p /><p>达尔文会自动执行以下循环:</p><img name=\"8e3d2326-7322-4573-b3f3-dc069d882161.png\" mime=\"image/png\" scale=\"1.000000\" src=\"M9AMbvB04ouUMPxQ6IPcaTGInng\" /><p /><h3>5.4 查看优化结果</h3><p /><pre caption=\" \" lang=\"Plain Text\"><code>显示达尔文优化前后的对比,列出每一处修改及其理由</code></pre><p /><h2>阶段6:代码生成与执行(Director D阶段)</h2><p /><h3>6.1 一步生成PPT</h3><p /><p>这一步你只需要一句话,Director会基于标准交付文档自动完成所有工作:</p><p /><pre caption=\" \" lang=\"Plain Text\"><code>基于上面的标准交付文档,生成PPT文件<br /><br />使用配置:<br />- 工具链:python-pptx<br />- 风格:数字浙江(已在风格卡中定义)<br />- 比例:16:9<br />- 直接运行并输出 presentation.pptx</code></pre><p /><h3>6.2 Director 在代码生成阶段会做什么</h3><p /><p>Director 会按照以下逻辑生成代码:</p><p /><ol><li>读取风格卡 → 确定颜色、字体、间距等视觉参数</li><li>读取页型映射 → 每种页型对应固定的布局模板</li><li>逐页生成 → 按标准交付文档逐页填充内容</li><li>执行代码 → 直接运行python-pptx脚本</li><li>输出文件 → 生成可直接打开的 .pptx 文件<p /></li></ol><h3>6.3 关于风格卡的参数说明(蓝色汇报)</h3><p /><p>风格卡中定义的关键参数,Director会严格遵守:</p><p /><pre caption=\" \" lang=\"Plain Text\"><code>颜色系统:<br />- primary: #003366(深蓝,标题和重点元素)<br />- secondary: #0066CC(科技蓝,图表和装饰)<br />- accent: #FF6600(橙色,数据高亮和CTA)<br />- background: #F5F7FA(浅灰底色)<br />- text: #333333(正文色)<br />- text-light: #666666(辅助文字)<br /><br />字体系统:<br />- 标题:微软雅黑 Bold 28-32pt<br />- 副标题:微软雅黑 Regular 18-22pt <br />- 正文:微软雅黑 Regular 14-16pt<br />- 数据:DIN / Impact 48-72pt(大数字展示)<br /><br />间距规则:<br />- 页面边距:上下左右各占10%<br />- 标题区:页面上方20%<br />- 内容区:页面中间60%<br />- 页脚区:页面下方10%(页码+Logo)</code></pre><p /><h3>6.4 高级定制选项</h3><p /><p>使用自定义模板:</p><p /><pre caption=\" \" lang=\"Plain Text\"><code>读取 template.pptx 作为模板(已有品牌色和母版),<br />基于模板的版式生成内容,输出 final.pptx</code></pre><p /><p>指定特定页的图表数据:</p><p /><pre caption=\" \" lang=\"Plain Text\"><code>第5页的柱状图数据:<br />- 2022年: 1200件<br />- 2023年: 3400件<br />- 2024年: 8700件<br />用python-pptx的chart功能直接生成</code></pre><p /><p>批量输出多版本:</p><p /><pre caption=\" \" lang=\"Plain Text\"><code>基于同一份标准交付文档,生成3个版本:<br />1. 完整版(15页,面对面汇报用)→ full.pptx<br />2. 精简版(8页,邮件发送用)→ brief.pptx <br />3. 摘要版(3页,电梯汇报用)→ summary.pptx</code></pre><p /><h3>6.5 常见视觉风格快捷指令</h3><p /><table><colgroup><col /><col /></colgroup><tbody><tr><td><p>风格</p></td><td><p>一句话指令</p></td></tr><tr><td><p>蓝色汇报(默认)</p></td><td><p>使用默认风格卡</p></td></tr><tr><td><p>苹果风</p></td><td><p>风格改为:极简、大留白、深色渐变背景、一页一句话</p></td></tr><tr><td><p>麦肯锡风</p></td><td><p>风格改为:框架图、蓝灰色系、信息密度高、结论先行</p></td></tr><tr><td><p>TED风</p></td><td><p>风格改为:大图全屏、最少文字、故事驱动、黑底白字</p></td></tr><tr><td><p>数据驱动</p></td><td><p>风格改为:图表为主、数字突出、灰白底色、注释清晰</p></td></tr></tbody></table><p /><h2>阶段7:评审验证 + 迭代(Director E阶段)</h2><p /><h3>7.1 评审三检查</h3><p /><p>这是本方法论最独特的闭环——用蒸馏出的受众模型和评审模型来验证你的产出。</p><p /><p>PPT Director 内置了「评审三检查」协议:</p><img name=\"e9080403-877a-4ca8-9adb-acd7f69abe7e.png\" mime=\"image/png\" scale=\"1.000000\" src=\"SNNdbM5jRobe2CxY2DicUpYQnFA\" /><p /><h3>7.2 执行评审</h3><p /><pre caption=\" \" lang=\"Plain Text\"><code>对当前PPT执行评审三检查,<br />按P0/P1/P2优先级输出修改清单</code></pre><p /><h3>7.3 修改清单示例</h3><p /><p>Director 的评审输出会是这样:</p><p /><pre caption=\" \" lang=\"Markdown\"><code>## 评审修改清单<br /><br />### P0(必须修改,否则汇报有风险)<br />1. 第4页:缺少数据来源标注 → 领导可能质疑数据可信度<br />2. 第8页:只谈成绩不谈困难 → 袁家军式评审会认为\"回避问题\"<br /><br />### P1(建议修改,改了明显更好)<br />3. 第2页:三组数据并列缺乏逻辑递进 → 改为\"效率→体验→成本\"递进<br />4. 第11页:文字过多(82字) → 压缩到50字以内,图表化呈现<br /><br />### P2(可优化,锦上添花)<br />5. 第6页:可增加一个\"改革前后\"的对比动画建议<br />6. 第14页:总结页可增加\"下一步时间表\"</code></pre><p /><h3>7.4 执行修改</h3><p /><pre caption=\" \" lang=\"Plain Text\"><code>按照上面的修改清单,先修改所有P0项,再修改P1项<br />然后重新生成PPT代码并运行</code></pre><p /><h3>7.5 迭代循环</h3><p /><p>如果修改后还有问题,可以继续迭代:</p><p /><pre caption=\" \" lang=\"Plain Text\"><code>修改完成后,再执行一次评审三检查<br />确认所有P0已解决</code></pre><p /><blockquote><p>💡 小白提示: 通常1-2轮迭代就够了。如果是特别重要的汇报,可以做3轮。</p></blockquote><p /><p /><h2>🎯 快速路径:4种常见场景的精简操作</h2><p /><h3>场景A:给政府领导做数字化汇报(使用默认配置)</h3><p /><pre caption=\" \" lang=\"Bash\"><code># 全部在 Claude Code 中执行<br /><br /># Step 1:直接启动(使用默认受众+评审+风格)<br />\"我要做一个PPT,给省级领导汇报XX区的数字化改革成效。<br />材料如下:[粘贴你的材料]<br />时长20分钟,15页左右。<br />用PPT Director帮我做,使用默认配置。\"<br /><br /># Step 2:确认大纲后生成<br />\"大纲可以,直接生成PPT文件\"<br /><br /># Step 3:评审检查<br />\"对这个PPT执行评审三检查\"<br /><br /># Step 4:修改并重新生成<br />\"按修改清单改完后重新生成\"</code></pre><p /><p>预计耗时:15-25分钟</p><p /><p /><h3>场景B:给特定领导汇报(需要蒸馏受众)</h3><p /><pre caption=\" \" lang=\"Bash\"><code># Step 1:蒸馏受众<br />\"用女娲蒸馏'[领导姓名]',同时生成audience-card和reviewer-card\"<br /><br /># Step 2:启动Director<br />\"材料如下:[粘贴材料]<br />用PPT Director的controlled路径,<br />使用刚蒸馏的受众卡和评审卡,<br />风格用数字浙江默认\"<br /><br /># Step 3:达尔文优化(因为重要)<br />\"用达尔文优化标准交付文档,重点提升说服力\"<br /><br /># Step 4:生成PPT<br />\"生成PPT文件\"<br /><br /># Step 5:评审+迭代<br />\"执行评审三检查,修改P0后重新生成\"</code></pre><p /><p>预计耗时:35-50分钟</p><p /><p /><h3>场景C:给投资人做融资BP</h3><p /><pre caption=\" \" lang=\"Bash\"><code># Step 1:蒸馏投资人<br />\"用女娲蒸馏'红杉资本早期投资人'的认知模型,重点关注否决原因\"<br /><br /># Step 2:蒸馏BP评审专家<br />\"用女娲蒸馏'Guy Kawasaki'作为评审专家\"<br /><br /># Step 3:启动Director(premium路径)<br />\"我要做融资BP:<br />项目:[一句话介绍]<br />阶段:[Pre-A / A轮 / ...]<br />融资额:[金额]<br />关键数据:[核心指标]<br /><br />用PPT Director的premium路径,10页以内\"<br /><br /># Step 4:达尔文优化<br />\"用达尔文优化,重点提升数据可信度和说服力\"<br /><br /># Step 5:生成+评审<br />\"生成PPT → 执行评审三检查 → 修改 → 重新生成\"<br /><br /># Step 6:受众模拟<br />\"以投资人Skill的视角,逐页审查:他看到每页会怎么想?会问什么?\"</code></pre><p /><p>预计耗时:60-90分钟</p><p /><h3>场景D:技术分享/公开演讲</h3><p /><pre caption=\" \" lang=\"Bash\"><code># Step 1:蒸馏受众<br />\"用女娲蒸馏'参加技术大会的高级开发者'的认知模型\"<br /><br /># Step 2:蒸馏演讲风格(可选)<br />\"用女娲蒸馏'TED演讲的叙事结构方法论'\"<br /><br /># Step 3:启动Director<br />\"主题:[XX]<br />时长:40分钟<br />风格:大图少字、故事驱动<br />用PPT Director规划30页技术分享PPT\"<br /><br /># Step 4:优化+生成<br />\"达尔文优化 → 生成PPT → 评审检查\"<br /><br /># Step 5:图片需求清单<br />\"列出所有需要配图的页面和图片描述,<br />我将用Midjourney/其他工具生成后替换\"</code></pre><p /><p>预计耗时:40-60分钟</p><p /><h2>🔧 进阶技巧</h2><p /><h3>技巧1:复用Skill库</h3><p /><p>蒸馏一次,反复使用:</p><p /><pre caption=\" \" lang=\"Plain Text\"><code>我之前蒸馏的 audience-gov-leader.skill.md,<br />这次要做另一个项目的汇报PPT,直接调用这个受众卡</code></pre><p /><p>建议建立个人Skill库:</p><p /><pre caption=\" \" lang=\"Plain Text\"><code>audiences/ ← 各类受众认知模型<br /> gov-leader.skill.md<br /> vc-investor.skill.md<br /> enterprise-buyer.skill.md<br /><br />reviewers/ ← 各类评审专家模型<br /> yuan-jiajun.skill.md<br /> nancy-duarte.skill.md<br /><br />styles/ ← 风格包(可自定义)<br /> digital-zhejiang/<br /> tech-minimal/<br /> corporate-blue/</code></pre><p /><h3>技巧2:一个人同时做受众和评审</h3><p /><p>最常见的场景是「给某个领导汇报」——他既是受众也是评审。</p><p /><pre caption=\" \" lang=\"Plain Text\"><code>用女娲蒸馏\"[领导姓名]\"<br /><br />输出两个视角:<br />1. 作为受众:他想听什么、他的注意力怎么分配<br />2. 作为评审:他会问什么问题、什么会让他否定<br /><br />分别输出 audience-card.md 和 reviewer-card.md</code></pre><p /><h3>技巧3:自定义风格包</h3><p /><p>如果默认的「蓝色汇报」风格不适合你,可以创建自定义风格:</p><p /><pre caption=\" \" lang=\"Plain Text\"><code>帮我创建一个新的风格卡,参数如下:<br />- 主色:[你的品牌色]<br />- 字体:[你的字体]<br />- 风格关键词:[极简/科技/活力/稳重...]<br />- 禁忌:[不能出现什么]<br /><br />输出为 style-card.md 格式,供PPT Director使用</code></pre><p /><h3>技巧4:演讲稿与PPT同步生成</h3><p /><pre caption=\" \" lang=\"Plain Text\"><code>基于标准交付文档,同时生成:<br />1. PPT文件(presentation.pptx)<br />2. 配套演讲稿(每页对应的讲稿,含时间标注)<br />3. Q&A预案(基于受众Skill预测可能的提问和建议回答)</code></pre><p /><h3>技巧5:用评审卡做\"红蓝对抗\"</h3><p /><p>在重要汇报前,模拟最严格的审查:</p><p /><pre caption=\" \" lang=\"Plain Text\"><code>同时调用以下两个角色审查我的PPT:<br />1. audience-card(受众视角)——他是否想听<br />2. reviewer-card(评审视角)——他是否能通过<br /><br />对每页分别给出两个视角的评价:<br />- 受众满意度(1-10)<br />- 评审通过率(通过/风险/不通过)<br />- 改进建议</code></pre><p /><h2>💡 最后的一句话总结</h2><p /><blockquote><p>蒸馏受众认知 → 蒸馏评审专家 → Director规划内容 → 达尔文打磨 → 代码生成PPT → 三重评审验证 → 迭代直到过关</p><p /><p>全程在 Claude Code 一个终端中完成。女娲负责\"懂人\",Director负责\"造PPT\",达尔文负责\"打磨\"——三位一体,一站到底。</p><p /><p>核心逻辑只有一句话:先搞清楚他的脑子怎么转,再决定PPT每页放什么。</p></blockquote><p />",
"document_id": "DQjwdbqbNopr71xsFuWcA9YWnY2",
"revision_id": 225
},
"log_id": "202605151244207169A6BBD1A39D387C60"
},
"_notice": {
"update": {
"current": "1.0.21",
"latest": "1.0.31",
"message": "lark-cli 1.0.31 available, current 1.0.21"
}
}
}
Article References
This directory stores long-form workflow articles that should travel with the ppt-director skill package.
Imported Articles
| ID | Title | Source | Use When |
|---|---|---|---|
ppt-workflow-cognitive-distillation | 我的PPT工作流:认知蒸馏×进化优化×代码生成 | Feishu Wiki | Explaining the end-to-end PPT Director method, especially Nuwa audience distillation, reviewer cards, Darwin optimization, Director routing, and code generation. |
Each article folder should keep:
article.md: model-readable offline Markdown.source.json: normalized source fetch result.media-manifest.json: media token/download metadata.assets/: downloaded images referenced byarticle.md.
Audience Card: Default Government Leader
Profile
适用于政务汇报、数字化改革项目汇报、区域治理方案、国企技术运营汇报。默认受众是时间有限、重视政策对标和落地成效的领导或管理层。
Attention Budget
- 总汇报通常 10-20 分钟。
- 前 3 页必须讲清楚:为什么重要、现在到哪一步、下一步要什么支持。
- 单页停留时间通常很短,标题必须直接表达结论。
Wants
- 对齐上位政策和战略任务。
- 讲清总抓手、实施路径、时间节点。
- 有量化指标、对标案例、阶段成果。
- 风险可控,责任边界清晰。
- 能体现群众、企业、基层的获得感或实际效益。
Dislikes
- 纯文字墙。
- 抽象概念堆叠。
- 只有系统界面,没有制度和流程变化。
- 只有愿景,没有指标、节点、责任。
- 只讲技术先进,不讲治理价值和落地效果。
First 3 Slides Test
1. 是否 3 秒内知道主题和价值。 2. 是否 1 分钟内知道为什么现在要做。 3. 是否 3 页内知道成果、问题、下一步抓手。
Likely Questions
- 这件事和上位政策是什么关系?
- 已经有什么阶段性成果?
- 需要领导决策什么?
- 风险点在哪里,怎么兜底?
- 这个系统或项目能不能复制推广?
- 群众、企业或基层有没有真实感知?
Reviewer Card: yuan-jiajun
Lens
从系统工程、数字改革、区域治理、产业承载、安全底线、群众和企业获得感的角度审查 PPT。这个评审卡来源于女娲生成的 yuan-jiajun-perspective Skill,但在 PPT Director 中只作为评审镜头使用,不进行全程角色扮演。
Cares About
- 是否有总抓手,而不是散点动作。
- 是否讲清平台、机制、场景、节点。
- 是否对齐“国家所需、地方所能、未来所向”。
- 数字化是否重塑制度、流程、数据供给和协同能力。
- 是否有真实场景验证,能否边建边用、边用边改。
- 产业升级是否有制造业根基、链主企业、创新链、人才链和资金链协同。
- 是否同时考虑日常高效运行和极端情况下安全运行。
- 群众、企业、基层是否有获得感。
Rejects
- 只有概念,没有平台。
- 只有口号,没有场景。
- 只有技术系统,没有制度重塑。
- 只有数据展示,没有问题闭环。
- 只有愿景,没有阶段节点。
- 只讲发展,不讲风险底线。
- 只讲部门工作,不讲跨层级、跨部门协同。
Review Checklist
Structure
- 这份 PPT 的总抓手是什么?
- 每一部分是否服务同一个主线?
- 标题单独串起来,是否能形成完整故事?
Digital Reform
- 有没有说明数据链路如何打通?
- 有没有说明平台如何支撑流程重塑?
- 有没有说明制度、机制、责任如何变化?
Execution
- 是否有阶段目标和时间节点?
- 是否有可验证指标?
- 是否有试点场景和推广路径?
Risk
- 是否识别高频风险和极端场景?
- 是否有监测、预警、处置、复盘闭环?
Public Value
- 群众是否更方便?
- 企业是否更省事?
- 基层是否更能执行?
Rewrite Rules
- 把“工作推进情况”改成“X 项抓手推动 Y 能力成型”。
- 把“数字化平台建设”改成“以统一平台打通 X、Y、Z 协同链路”。
- 把“取得明显成效”改成带数字、场景或对象的结果。
- 把“下一步工作计划”改成“下一阶段以 X 为总抓手,完成 Y 个节点”。
Output Format
【袁家军式评审】
P0 必改:
- ...
P1 建议改:
- ...
P2 可优化:
- ...
标题改写:
- 原标题 -> 建议标题
缺失问题:
- 是否缺政策对标 / 平台机制 / 风险闭环 / 获得感 / 阶段节点Design Language: digital-zhejiang
本文件是“数字浙江 PPT 模板六”的设计语言说明。它比 style-card.md 更完整,用于生成 PPT 前的设计对表和成稿风格检查。
来源模板:/Users/caifeiya/Downloads/数字浙江PPT模板第三版第六套.pptx
1. 风格定位
- 适用场景:政务数字化、国企技术运营、智慧城市、区域治理、数字改革、正式汇报。
- 气质关键词:正式、可信、清爽、秩序感、政务蓝白。
- 视觉重心:结构图、流程图、目录、分栏说明、圆形图标节点、平台架构。
- 生成原则:先根据内容选择最接近的页型,再让新页面靠齐该页型的视觉语法。不要机械照抄截图,也不要从空白页做成通用蓝白商务风。
2. 核心视觉语法
正文页采用“白底母版感”:
- 主背景:白色
#FFFFFF。 - 左上:浅蓝半透明几何标题底纹,承载页面标题。
- 右上:蓝色品牌角标、横条或斜切块。
- 右下:低透明浅蓝城市剪影,作为空间锚点。必须使用固定资产
references/styles/digital-zhejiang/assets/city-skyline.png,不得自行生成、重绘、替换为其他城市图或用 CSS/SVG 临摹。 - 局部:浅蓝半透明大三角形可用于目录、章节或强调页。
封面、章节转场、感谢页采用“深蓝几何满版”:
- 深蓝到亮蓝的几何叠层。
- 大三角形、斜切面和低透明度多边形交错。
- 中央白色大标题,视觉中心稳定。
- 品牌标识位于顶部中轴或右上区域。
3. 颜色系统
| 角色 | 色值 | 用法 |
|---|---|---|
| 主色蓝 | #014EC6 | 标题、编号、结构图主节点、图标圆底、重点数字、标题条、主边框 |
| 辅助橙 | #FFAA11 | 次级模块、强调箭头、辅助节点、对比组、提示备注 |
| 亮蓝 | #0065E2 / #0073E2 | 细线、连接线、局部强调 |
| 正文黑 | #000000 / #262626 | 正文、说明文字、目录文字 |
| 浅蓝背景 | #E7EFFD | 信息背景、虚线框、城市剪影、弱承载区 |
| 浅灰背景 | #F9F9F9 | 图片占位、普通内容区背景 |
| 米黄背景 | #FFF5DC 附近 | 提示块、备注块 |
| 白色 | #FFFFFF | 深蓝页文字、蓝色圆形节点内文字、卡片背景 |
比例建议:
- 正文页:白色 70%-85%,主蓝 10%-20%,橙色 3%-8%。
- 深蓝页:蓝色 90% 以上,白色文字,少量橙色或浅蓝点缀。
- 结构图:主链路用蓝色,辅助链路或审核/强调节点用橙色。
禁忌:
- 不要引入大面积紫色、红色、绿色或霓虹色。
- 不要让橙色成为主视觉。
- 不要使用花哨渐变、复杂阴影、互联网营销式 hero。
4. 字体系统
- 主字体:微软雅黑。
- 允许字重:Regular / Bold。
- 大标题一般使用 Bold。
- 小标题一般使用 Bold。
- 内容文字按情况使用 Regular 或 Bold。
4.1 参考字号
| 层级 | 推荐字号 | 字重 | 用法 |
|---|---|---|---|
| 大标题 | 36 / 44 / 60 / 72 | Bold | 封面主标题、章节标题、正文页重要观点标题 |
| 小标题 | 20 / 24 / 28 | Bold | 模块标题、流程节点标题、分栏标题、卡片标题 |
| 内容文字 | 16 / 18 | Regular 或 Bold | 正文说明、模块短句、要点文字 |
| 页脚/来源 | 12 / 14 / 16 | Regular | 来源、页码、低层级注释 |
4.2 典型使用
- 封面主标题:60 / 72 pt,Bold,白色;一般封面用 60,重大封面可用 72。
- 章节页标题:44 / 60 pt,Bold,白色或主蓝。
- 正文页主标题:36 / 44 pt,Bold,主蓝;普通内容页优先 36,标题短且需要强调时可用 44。
- 模块标题:20 / 24 / 28 pt,Bold;卡片、流程节点、分栏标题优先 20 或 24。
- 内容文字:16 / 18 pt,Regular 或 Bold;正文优先 18,辅助说明可 16。
- 标签/短词:16 / 18 / 20 pt,Regular 或 Bold;必须保证汇报投影可读。
- 页脚/来源:12 / 14 / 16 pt,Regular,低对比深灰或浅蓝。
避免使用微软雅黑 Light、宋体、特殊字体。
生成要求:
- 生成就绪导演稿必须明确每类文字的字体、字号和字重。
- PPTX 映射后如果字体替换导致换行、溢出、遮挡或可读性下降,判定为不通过。
- 中文清晰可读优先于局部美观;不得为了塞内容把正文压到 16 以下。
5. 母版固定元素
正文页尽量保留以下母版感:
- 左上标题区:x 约 60 px,y 约 20 px,标题为主蓝加粗。
- 右上品牌区:蓝色横条、角标或斜切块贴右上。
- 右下城市剪影:使用
references/styles/digital-zhejiang/assets/city-skyline.png原始资产,保持透明通道和宽高比;推荐锚定右下,约从 x=760 px、y=515 px 延展到右下角,宽度约 500-620 px。不得自行生成、重绘、换图或将其做成卡通/照片风。 - 标题装饰:浅蓝倒三角或多边形底纹。
封面固定元素:
- 品牌标识在上方中轴或偏上区域。
- 主标题居中,白色加粗。
- 副标题位于主标题下方。
- 公司名或汇报单位在底部中间,低对比浅蓝或白色。
6. 组件语法
矩形
- 实心蓝矩形:关键模块、标题背景、主结构节点。
- 实心橙矩形:次级标题条、辅助模块、强调中枢。
- 空心蓝矩形:普通信息卡、内容容器。
- 空心橙矩形:次级普通信息卡。
- 浅蓝虚线矩形:背景承载、占位框、弱信息区。
- 浅灰/浅蓝底矩形:图片占位或普通内容背景。
矩形默认直角或极小圆角,不做圆角卡片堆叠。
圆形
- 实心蓝圆:主节点、核心角色、主要对象。
- 实心橙圆:辅助节点、次级对象。
- 空心圆/虚线圆:弱关系、背景承载、待填充状态。
- 常见结构:蓝色圆形承载白色图标,图标下方放短标签。
箭头
- 主链路箭头用主蓝。
- 辅助链路箭头用辅助橙。
- 可用成对箭头表达交换、协同、流转。
- 箭头保持扁平、简洁,不做 3D 或重阴影。
7. 页型语言
生成时不必逐页复刻截图,但要优先靠齐下列页型语言。
| 页型 | 适用内容 | 视觉骨架 |
|---|---|---|
| 深蓝几何封面页 | 报告标题、项目名 | 深蓝满版几何背景,白色居中大标题,顶部品牌 |
| 白底斜切目录页 | 3-4 个章节 | 左侧“目录/CONTENT”,右侧编号目录,浅蓝斜切背景 |
| 蓝色侧栏目录页 | 强章节感报告 | 左侧深蓝侧栏,右侧目录项,右下城市剪影 |
| 三栏编号说明页 | 三个并列观点 | 中部三列,每列大编号、短标题、少量说明 |
| 纵向编号列表页 | 步骤、阶段、问题清单 | 左侧纵向编号,右侧标题+说明,条目留白 |
| 中心标题说明页 | 单一核心结论 | 中央大标题,下面一段短说明,右下城市剪影 |
| 双图说明页 | 截图、案例、对比图 | 两个浅灰图片框,下方说明,标题左上 |
| 环形五步页 | 五步流程、五类能力 | 中央圆/环,周围五个编号节点 |
| 矩阵页 | 对比、能力矩阵 | 蓝/橙标题条,浅底单元格,虚线或细边框 |
| 架构图页 | 平台、系统、数据流 | 蓝色主模块条,橙色次级中枢,浅蓝模块卡片和蓝橙连接线 |
| 圆形关系图页 | 主体生态、能力模型 | 左侧大圆核心节点,外围小圆,右侧要点 |
| Logo 墙页 | 生态伙伴、客户案例 | 多行多列 logo,白底或透明,少边框 |
| 二维码页 | 扫码入口 | 二维码居中或偏右,周围留白 |
| 深蓝几何感谢页 | 收尾 | 深蓝满版几何背景,中央“感谢/谢谢” |
8. 版式尺度
以 1280 x 720 px 渲染画布为参考:
- 安全边距:左右至少 60 px,上方约 22 px。
- 主内容区:x=80-1180 px,y=120-620 px。
- 左上标题位置:x 约 60 px,y 约 20 px。
- 右上品牌角标:贴右上,约 100-200 px 宽。
- 右下城市剪影:固定资产
references/styles/digital-zhejiang/assets/city-skyline.png,x 约 760 px 起,y 约 515 px 起,锚定右下,保持原图比例和透明背景。 - 三列布局:每列宽约 250-330 px,列间距 40-80 px。
- 标题条高度:45-70 px。
单页最多表达一个主结构或 3-5 个并列点。长解释放进演讲备注,不直接铺满页面。
9. 图片与截图规则
- 产品截图页可使用双图说明页或架构图页的截图承载区。
- 截图保持矩形裁切,不使用厚重阴影。
- 图片说明用 12-16 pt 深灰或黑色。
- 没有真实图片时使用浅灰占位框,并标注建议图片内容。
- 右下城市剪影不应被大图完全覆盖,除非该页明确是全图说明页。
- 右下城市剪影不是可替换插画,生成 HTML/PPTX 时必须引用固定 PNG 资产,不得自行生成。
10. 内容口吻
- 标题短、实、前置结论。
- 小标题控制在 4-8 个汉字。
- 正文每块 1-3 行。
- 用“平台、机制、闭环、协同、共享、治理、审核、编目”等政务数字化词汇,但避免空泛堆叠。
- 避免“极致、颠覆、赋能未来”等营销化表达。
11. 截图样例使用方式
contact-sheet.png 是设计靠齐参考,不是逐页照抄模板。
使用规则:
1. 生成前先看 design.md,再看 contact-sheet.png,最后看 slide-type-map.md。 2. 每页先按内容选择“最接近的页型语言”。 3. 若内容与截图页型完全匹配,则尽量靠齐其标题位置、主结构区域和组件语法。 4. 若内容需要新结构,则可以变体设计,但必须保留颜色、字体、母版固定元素、组件语法和信息密度。 5. 生成后检查:风格是否像同一套模板新增页面,而不是普通蓝白商务模板。
12. 生成检查清单
- 是否为 16:9 宽屏。
- 是否使用微软雅黑。
- 是否只使用主蓝、辅助橙、黑白灰和浅蓝/米黄背景。
- 正文页是否有左上标题、右上角标、右下城市剪影的母版感。
- 右下城市剪影是否引用
city-skyline.png固定资产,而不是模型新画或代码重绘。 - 标题字号是否明显大于正文,且标题为蓝色加粗。
- 是否避免大段文字和营销式表达。
- 架构图是否蓝为主、橙为辅。
- 矩阵/表格标题条是否为蓝/橙实心矩形。
- 圆形图标是否为蓝底白图标。
- 封面/感谢页是否为深蓝几何背景。
- 是否避免复杂阴影、圆角卡片堆叠、花哨渐变和大面积非蓝橙配色。
Slide Type Map: digital-zhejiang
| Content Type | Recommended Slide Type |
|---|---|
| 报告标题、项目名 | 深蓝几何封面页 |
| 章节清单 | 白底斜切几何目录页 / 蓝色侧栏目录页 |
| 三个并列观点 | 三栏编号说明页 |
| 多步骤说明 | 纵向编号列表页 |
| 单一核心结论 | 中心标题说明页 |
| 两个案例/截图 | 双图说明页 |
| 五步流程/五类能力 | 环形五步页 |
| 平台、系统、数据流 | 架构图页 |
| 左右对比/能力矩阵 | 蓝橙矩阵页 |
| 合作伙伴/客户 | Logo 墙页 |
| 主体生态/能力模型 | 圆形关系图页 |
| 扫码入口 | 二维码页 |
| 收尾 | 深蓝几何感谢页 |
Layout Rules
- 正文页标题放在左上角。
- 结构图主模块用蓝色,辅助模块用橙色。
- 目录编号使用主蓝加粗。
- 图标优先使用白色图标放入蓝色圆形。
- 图片页用浅灰矩形占位,说明文字放在图下。
- 数据页标题必须表达发现,不使用“XX统计”。
- 结束页只保留“感谢”或“谢谢”,避免复杂内容。
Page Density
- 单页最多 3-5 个并列点。
- 正文块每块 1-3 行。
- 架构图最多 2 层主结构,更多内容放附录。
- 表格最多 5 列,超过则拆页或改为矩阵摘要。
Style Card: digital-zhejiang
Positioning
政务数字化、国企技术运营、智慧城市、区域治理和数字改革汇报风格。整体气质正式、可信、清爽,偏政务蓝白视觉。
Canvas
- 16:9 宽屏。
- 参考渲染画布:1280 x 720 px。
Visual DNA
- 正文页:白底、大留白、左上浅蓝几何标题底、右上蓝色品牌角标、右下浅蓝城市剪影。
- 封面和结束页:深蓝满版几何叠层背景,中央白色大标题。
- 组件:直角矩形、蓝橙标题条、浅蓝虚线框、蓝/橙圆形节点、蓝橙箭头。
- 信息表达:结构图、流程图、目录、分栏说明、图标圆形节点。
Color System
| Role | Color | Usage |
|---|---|---|
| 主色蓝 | #014EC6 | 页面标题、编号、主节点、图标圆底、重点数字、标题条、实线边框 |
| 辅助橙 | #FFAA11 | 次级模块、强调箭头、辅助节点、对比组、提示备注 |
| 亮蓝 | #0065E2 | 细线、连接线、局部强调 |
| 正文黑 | #000000 / #262626 | 正文、说明文字、目录文字 |
| 浅蓝背景 | #E7EFFD | 普通信息背景、虚线框、城市剪影 |
| 浅灰背景 | #F9F9F9 | 图片占位、普通内容区背景 |
| 白色 | #FFFFFF | 深蓝页文字、圆形节点内文字、卡片背景 |
正文页推荐比例:白色 70%-85%,主蓝 10%-20%,橙色 3%-8%。
Typography
- 主字体:微软雅黑。
- 封面主标题:44-60 pt,Bold,白色。
- 正文页标题:24-36 pt,Bold,主蓝。
- 大标题:36 / 44 / 60 / 72 pt,Bold。
- 小标题:20 / 24 / 28 pt,Bold。
- 正文:16 / 18 pt,Regular 或 Bold。
Avoid:
- 微软雅黑 Light。
- 宋体。
- 特殊字体。
Fixed Elements
- 左上标题区:x 约 60 px,y 约 20 px。
- 右上角标:贴右上,蓝色横条或斜切块。
- 右下城市剪影:固定资产
references/styles/digital-zhejiang/assets/city-skyline.png,x 约 760 px 起,y 约 515 px 起,锚定右下,保持宽高比和透明背景。 - 封面品牌标识:顶部中轴或偏上。
Do
- 保持政务蓝白秩序感。
- 每页只表达一个主结构。
- 用蓝色表达主链路,橙色表达辅助链路。
- 标题要短、实、前置结论。
- 数据、流程、结构优先于装饰。
Don't
- 不要大面积紫色、红色、绿色。
- 不要复杂阴影、圆角卡片堆叠、花哨渐变。
- 不要互联网营销式 hero 或过度视觉化。
- 不要把橙色变成主视觉。
- 不要使用手绘感或娱乐化图标。
Generation Prompt
请按照“数字浙江 PPT 模板六”风格生成 16:9 PowerPoint。
整体为政务数字化汇报风:白底正文页 + 深蓝几何封面/转场页。
主色使用 #014EC6,辅助色使用 #FFAA11,正文黑色,背景辅以极浅蓝 #E7EFFD、浅灰 #F9F9F9。
字体统一使用微软雅黑,标题和小标题加粗。
正文页必须保留左上浅蓝几何标题底、右上蓝色品牌角标、右下浅蓝城市剪影的母版感。
右下城市剪影必须引用固定 PNG 资产 references/styles/digital-zhejiang/assets/city-skyline.png,不要自行生成、重绘或替换。
优先使用目录页、三栏编号页、纵向编号列表页、中心观点页、双图说明页、环形五步页、蓝橙矩阵页、架构图页、圆形关系图页、Logo 墙页、二维码页、感谢页。
组件使用直角矩形、蓝橙标题条、浅蓝虚线框、蓝/橙圆形节点、蓝橙箭头。
不要使用复杂阴影、圆角卡片堆叠、花哨渐变或大面积非蓝橙配色。Audience Card: <name>
Profile
<who this audience is>
Attention Budget
<time, patience, first-three-slides standard>
Wants
- ...
Dislikes
- ...
First 3 Slides Test
1. ... 2. ... 3. ...
Likely Questions
- ...
Reviewer Card: <name>
Lens
<the review perspective>
Cares About
- ...
Rejects
- ...
Review Checklist
- ...
Rewrite Rules
- ...
Output Format
P0 必改:
P1 建议改:
P2 可优化:
标题改写:
缺失问题:Toolchain: visual-ppt
Use When
发布会、品牌展示、融资路演、大会 keynote、强视觉冲击演示。
Priority
1. 画面冲击力。 2. 视觉一致性。 3. 文字可读性。 4. 叙事节奏。 5. 文件可编辑性。
Recommended Execution
- 先确认每页是否需要 AI 生图。
- 生成图片 Prompt 时要指定构图留白、主色、禁忌元素。
- 图片页用全屏背景图,文字叠加半透明色块。
- 非图片页使用统一渐变或纯色大字页。
- 每张图要检查是否有文字乱码、人物误生成、品牌伪造。
Image Prompt Schema
页面:
内容:
用途:背景图 / 配图 / 主视觉
风格:
色调:
构图留白:
禁忌:
中文 Prompt:
English Prompt:Coding Agent Prompt Addendum
这是强视觉 PPT。请将图片作为视觉主角,代码负责排版、文字层级和文件组装。
图片页必须保证文字在背景上清晰可读。
不要生成虚假 logo、虚假截图、虚假产品界面。Nuwa To PPT Workflow
女娲 Nuwa 的角色是生成“对象 Skill”:受众、专家、人物视角、表达风格。PPT Director 不内置女娲本体,只把女娲产物转换成 PPT 可用插件。
Import Targets
Audience Card
当女娲 Skill 描述的是目标观众、领导、客户、评委、投资人时,转换为 audience-card。
抽取字段:
- 角色身份
- 关注焦点
- 决策风格
- 注意力预算
- 最想看到什么
- 最反感什么
- 前 3 页判断标准
- 可能追问的问题
Reviewer Card
当女娲 Skill 描述的是专家、领导、行业人物或某种评审视角时,转换为 reviewer-card。
抽取字段:
- 评审镜头
- 关注重点
- 反模式
- 标题改写规则
- 结构审查清单
- 风险审查清单
- 输出格式
Voice Card
当用户希望 PPT 采用某类表达语气时,可转换为 voice-card。
抽取字段:
- 表达 DNA
- 常用词汇
- 句式节奏
- 禁忌表达
- 标题语言规则
Recommended Flow
1. 用户提供 Nuwa skill zip 或目录。 2. 解压并读取 SKILL.md。 3. 判断导入类型:audience / reviewer / voice。 4. 按模板生成卡片。 5. 放入对应目录。 6. 更新 registry.yml。 7. 后续 PPT 生成只读取轻量卡片,不加载完整 Nuwa Skill。
User Prompt Template
我上传了一个女娲生成的对象 Skill。
请把它导入 PPT Director:
- 作为受众画像 / 评审专家 / 表达风格
- 名称:
- 默认是否启用:Related skills
FAQ
Is Ppt Director safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.