Skip to content

About

A human-centered Codex skill for natural, accurate, editable presentations using native Presentations and built-in ImageGen.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

14 Commits

Folders and files

Repository files navigation

Human-Centered PPT:用当前 Codex 原生 Presentations 制作自然、准确、可编辑的演示文稿

从主题、文件、数据、既有幻灯片或 Codex 对话出发,做一份真正适合人讲的 PPT。

通用演示 · 教学讲解 · 项目汇报 · 科研组会 · 方案讨论 · 既有 PPT 修改

它做什么

human-centered-ppt 是一个通用 PowerPoint 制作 Skill。它先弄清听众、用途和材料,再直接调用当前安装的 Codex 原生 Presentations 生成可编辑 PPTX。

Codex 项目对话仍然可以作为材料来源,但只是其中一种模式。普通演示不需要项目仓库、科研台账或治理文件。

支持的材料

来源 典型用法
一个主题或提纲 教学、说明、提案、内部分享
DOCX、PDF、表格、图片或代码 从现有材料整理完整演示
既有 PPTX 或参考模板 修改、续做或继承视觉体系
Codex 项目与任务对话 按项目和日期制作进展汇报
获准的外部研究 制作带来源依据的分析型演示

为什么单独做这个 Skill

原生 Presentations 负责真正的 PPTX 创建、模板路由、可编辑对象和渲染验收。本 Skill 只补充那些容易在实际制作中丢失的要求:

  • 用用户选择的材料,不擅自扩大范围;
  • 重要演示先确认事实和逐页结构;
  • 标题和正文采用自然的人类表达;
  • 页面保留实际内容与必要解释,讲述展开和汇报组织说明进入备注;
  • 避免连续三栏卡片、胶囊标签和仪表盘式页面;
  • 根据内容选择表格、图、公式、图片或流程,而不是套同一个版式;
  • 需要生成图片时默认使用内置 ImageGen;
  • 科研模式保留公式、实验和结论边界;
  • 最终逐页渲染检查,而不是只看缩略图。

Human-Centered PPT 从材料、内容结构、原生 Presentations 与 ImageGen 到最终验收的工作流

默认制作方式

  1. 确认听众、用途、材料、时长和输出格式。
  2. 提取真正要在演示中使用的事实、数字和视觉素材。
  3. 对较长、科研或多材料演示,先确认事实摘要和逐页大纲。
  4. 直接调用当前 Codex 原生 Presentations,按其最新规则选择模板和布局。
  5. 没有真实图片且确实需要新视觉时,使用内置 ImageGen。
  6. 检查文本、版式、数据、公式、字体和可编辑性。
  7. 渲染每一页,修正溢出、遮挡、裁切和重复模板感。
  8. 默认只交付最终 PPTX。

独立 ppt-agent 不再参与默认链路。这样可以直接继承原生 Presentations 的更新,也减少重复指令和代理交接。

视觉路线

Skill 按当前 Presentations 的规则选择第一条适用路线:

  1. 用户提供参考 PPTX 或模板时,继承其母版、版式和视觉语言;
  2. 用户明确指定配色、品牌或构图时,从零定制;
  3. 没有明确视觉方向时,使用当前 Codex 原生模板选择和默认布局体系。

“严谨”“视觉讲解”“决策讨论”等描述决定内容侧重,不会自动把演示锁定到某套旧模板。

图片生成

新建位图视觉默认调用内置 ImageGen,不要求 API Key。素材优先级为:

  1. 用户或项目提供的真实图片;
  2. 根据真实数据生成的图表;
  3. ImageGen 生成的封面图、概念插图、场景或纹理;
  4. 经用户允许后使用的外部图片。

ImageGen 不用于伪造实验结果、真实事件、软件截图、公式、精确数据图或需要严格几何关系的方法流程。生成的科研示意图在可能被误解时会明确标为示意。

减少“AI 味”

可见文字首先说明实际主题。背景页可以使用普通主题标题,不强行制造洞察;结果页只有在数据确实支持时才使用结论型标题。

Skill 会重点检查:

  • 用三条主线回答……、从 A 到 B、一张图看懂…… 等模板化标题;
  • 口号、空泛抽象词、机械排比和为了凑三项而写的列表;
  • 本页介绍、下面来看、这里需要强调 等制作或讲述元话语;
  • 每页重复的卡片、横条、圆角框、图标行和大号数字;
  • 把真实表格、图和公式缩小后塞进装饰性容器;
  • 相邻页面使用完全相同的密度、对称方式和强调色。

目标不是刻意制造变化,而是让每页看起来确实为这部分内容而做。

科研与 Codex 模式

科研汇报会额外处理:

  • 研究方向、方法或流程变化及其依据;
  • 实验如何组织;
  • 目前能够和不能够得到的结论;
  • 关键公式的可靠渲染;
  • 下一阶段工作。

当用户选择 Codex 对话作为来源时,Skill 会按项目、日期和任务范围读取材料。多项目或长任务历史可以使用仓库中的 ppt-evidence-extractor 生成临时证据包。证据提取器只整理来源,不制作 PPT,也不替用户决定最终叙事。

普通 PPT 不会自动进入这套科研流程。

字体、表格和公式

用户或参考模板未指定其他字体时:

  • 中文使用宋体;
  • 普通英文和数字使用 Times New Roman;
  • 数学公式保留正确的数学字体;
  • 表格中的表头、首列和数据默认水平、垂直居中。

新建或重建的展示公式使用可编辑的 Office Math(OMML)原生对象。工具缺少原生支持时,需要使用原生公式转换或最终处理步骤并复验,不能自行降级成公式图片。只有用户明确同意的特定页面才允许矢量公式例外。

验收检查最终 PPTX 中的真实 OMML 节点和逐页公式数量,并检查代表公式的编辑、保存及显示。Equation: 图片标记和数学字体都不能代替原生公式。审计同时提示正文中的讲述元话语和重复页底条,最终仍需人工判断内容是否应该进入备注。

安装

将 Skill 复制到 Codex Skills 目录:

Copy-Item -Recurse -Force `
  '.\skills\human-centered-ppt' `
  "$env:USERPROFILE\.codex\skills\human-centered-ppt"

只有需要从较长 Codex 对话中并行提取证据时,才安装可选提取器:

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex\agents" | Out-Null
Copy-Item -Force '.\agents\ppt-evidence-extractor.toml' `
  "$env:USERPROFILE\.codex\agents\ppt-evidence-extractor.toml"

安装或更新 Skill 和 Agent 后重启 Codex。

使用示例

使用 $human-centered-ppt,根据这份 DOCX 制作一份 12 分钟的项目汇报。
先给我逐页大纲,结果以表格为主,没有指定风格时使用 Codex 原生设计。
使用 $human-centered-ppt 修改这份 PPTX,保留现有模板,精简文字并统一图表。
使用 $human-centered-ppt,从我确认的两个 Codex 项目最近 14 天对话中
制作组会汇报,重点说明公式变化、实验安排、当前结论和下一步。

项目结构

agents/
└── ppt-evidence-extractor.toml

skills/human-centered-ppt/
├── SKILL.md
├── agents/openai.yaml
├── scripts/audit_pptx.py
└── references/
    ├── human-style.md
    ├── design-and-qa.md
    ├── codex-evidence.md
    ├── evidence-packets.md
    └── research-report-content.md

使用边界

  • 不擅自扩大材料、项目、日期或外部研究范围。
  • 不把计划、假设、生成图片或未经验证的描述写成事实。
  • 不在未获许可时覆盖已有演示文稿。
  • 不用装饰性图片替代真实数据和项目证据。
  • 不把自动检查通过等同于文字和设计已经自然;最终仍需逐页查看。

About

A human-centered Codex skill for natural, accurate, editable presentations using native Presentations and built-in ImageGen.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages