# Keynote Pipeline

> 架构型技术演讲（Keynote）端到端交付管线：从材料结构化、叙事架构、页级设计规格， 到 PPT 版本化打磨、评分卡评估、提词器同步与彩排就绪。 适用于安全 / AI Agent 治理 / 零信任 / 企业产品方案等主题的 15-30 分钟大会演讲。 触发词: "技术演讲", "keynote", "大会演讲", "演讲PPT", "提词器", "彩排", "演讲评分", "scorecard" 使用场景: 需要把散乱的产品/理论/案例/模板材料交付为可上台的演讲成品包（主PPT + 提词器 + 评分 + QG报告）时

- Skill: `ameureka/keynote-pipeline` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add ameureka/keynote-pipeline`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ameureka/keynote-pipeline/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: ameureka (https://skillmd.com/u/ameureka)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/ameureka/keynote-pipeline

---


# Keynote Pipeline

> 📌 版本：v1.0.0
> 📌 脱敏声明：本技能为方法论骨架萃取，已剥离全部项目专属内容，不含任何客户名称、案例客户、规模数字、金额、具体日期与竞品信息；评分卡/检查清单为通用契约。
> 📎 资源文件：`resources/checklists/keynote-delivery-qg-checklist.md`（交付质量检查清单）、`resources/scorecards/keynote-scorecard-schema.yaml`（评分卡 schema）
> 📚 参考文档：`references/version-ladder.md`（版本阶梯）、`references/visual-evidence-patterns.md`（视觉证据模式）、`references/rehearsal-and-teleprompter.md`（彩排与提词器）
> 🔧 配套脚本：`scripts/pptx_audit.py`（PPTX 包结构审计）、`scripts/scorecard_summary.py`（评分卡汇总）、`scripts/teleprompter_build.py`（Markdown 分节脚本→提词器 PPTX，P1-8 随迁自 plugin）

## 1) Purpose

把散乱的产品、理论、案例、模板材料，通过可追溯的 Harness Engineering 工作流，交付为**演讲者就绪（speaker-ready）**的技术 Keynote 成品包。

核心价值：

- **管线化交付**：材料结构化 → 叙事架构 → 页级设计规格 → 版本化打磨 → 提词器与彩排，五阶段闭环
- **版本阶梯管理**：每个版本有且仅有一个明确升级目标，杜绝"泛泛改好一点"
- **量化评分**：10 维加权评分卡（满分 100，交付线 80，可复用线 90），机器可读
- **演讲交付保障**：主 PPT 与提词器严格同步，超时压缩有固定顺序

**与页面生成技能的边界**：本技能不负责单页 PPT 的视觉设计与生成，只负责演讲交付管线本身（叙事架构、版本打磨、QG、评分、提词器、彩排）。页面生成可由任何支持 python-pptx 原生交付（非截图转 PPTX）的技能承接——详见 [kit/pptx_lib/](../../kit/pptx_lib/) 提供的最小可复用构建库。

| 维度 | 页面生成技能（外部/自备） | keynote-pipeline（本技能） |
|------|--------------------------|------------------------------|
| 职责 | 单页 PPT 的**设计与生成**（原生交付、视觉系统、页面构建） | 演讲的**交付管线**（叙事架构、版本打磨、QG、评分、提词器、彩排） |
| 受众 | 管理层汇报场景 | 大会/会议 15-30 分钟技术演讲场景 |
| 输出 | PPT 文件本身 | 主PPT + 提词器PPT + 联系表 + 评分卡 + QG报告 + manifest 成品包 |
| 协作 | 可作为本管线 Phase 3 的页面生成引擎 | 接管 briefing 产物进行版本化打磨与交付门禁 |

## 2) When to Use

- 需要准备安全、AI Agent 治理、零信任、企业产品方案等主题的大会技术演讲
- 需要 15-30 分钟会议演讲的完整交付（含理论、方法论、实践、产品证据与口播）
- 已有 PPT 初稿，需要按版本阶梯迭代打磨至大会级（Keynote-grade）质感
- 主 PPT 定稿后需要同步提词器并进行按时长彩排
- 需要对演讲产物做量化评分与交付质量门禁

## 3) Inputs (Material Contract)

### P0 (必需) - 缺失则停止执行
- 演讲主题、受众、时长（写入 `PROJECT.yaml`）
- 产品材料（能力描述、截图、功能清单）
- 主 PPT 模板（品牌与版式基线）

### P1 (重要) - 缺失则占位
- 理论/行业参考材料（方法论、趋势判断）
- 案例/证据材料（事件链、实践证明、合规过审的截图）
- `02-design/product-knowledge-base.yaml`（Phase 0 产物，可现场构建）
- 提词器模板（如有）

### P2 (可选) - 缺失则备注
- 历史演讲录像或彩排记录
- 往届同系列演讲的评分卡（用于基线对比）

## 4) Outputs

默认输出到项目交付目录：

- 主 PPT 最终版 + 联系表预览（contact sheet）
- 提词器 PPT + 提词器联系表
- `03-initiation/演讲叙事规划.md` - 叙事架构文档
- `03-initiation/slide-design-spec.yaml` + `03-initiation/逐页设计/` - 页级设计规格
- 评分卡 YAML + 汇总报告（`scripts/scorecard_summary.py` 生成）
- QG 报告、版本清单 manifest、会话交接文件

## 5) Document Structure

### 版本阶梯（Version Ladder）

| 版本目标 | 核心问题 | 典型改动 |
|----------|----------|----------|
| 1 内容完整 | 演讲能否端到端讲通 | 补缺页、补核心论点 |
| 2 逻辑顺滑 | 每页是否自然引出下一页 | 重排、合并、拆分、改转场 |
| 3 视觉统一 | 是否像"同一套"PPT | 统一标题、间距、配色、组件 |
| 4 Keynote 打磨 | 是否达到大会质感 | 重点页冲击力、光影、层次、节奏 |
| 5 证据增强 | 观众凭什么相信 | 加截图、案例、产品证明 |
| 6 场景增强 | 观众是否看到真实工作流 | 加工具、链路、事件、角色 |
| 7 彩排就绪终版 | 演讲者能否按时讲完 | 同步提词器、压缩口播 |

> 规则：每个版本只解决一类主要问题；禁止无版本目标的"整体再改改"。

### 视觉证据三层（Visual Evidence Patterns）

| 层 | 作用 | 典型页面 |
|----|------|----------|
| 逻辑图层 | 解释结构、边界、关系 | 边界迁移、风险链、架构图 |
| 场景层 | 让工作流有真实感 | 工具栈、身份、终端、数据流 |
| 证据层 | 证明产品能力 | 截图卡、日志、告警、审计 |

常用模式（结构骨架，项目内容按实填充）：

- 抽象趋势 + 工具锚点：`能力类型 → 真实工具 → 安全控制点迁移`
- 安全边界迁移：`旧边界（用户/设备/应用）→ 新边界（身份/工具/动作/数据/审计）`
- 风险事件链：`输入风险 → 工具动作 → 权限放大 → 数据触达 → 审计缺口`
- 治理动作 + 产品证据：`治理动作 → 产品截图 → 观众结论`
- 事件故事链：`谁触发 → 用什么工具 → 碰什么数据 → 哪个控制点 → 如何复盘`

> 规则：截图不是装饰。每张截图必须证明当页的一个具体论点。

## 6) Process

### Phase 0: 材料结构化
```
1. 创建/更新 PROJECT.yaml（主题、受众、时长）与材料索引
2. 抽取产品能力 → 02-design/product-knowledge-base.yaml
3. 从调研材料提炼现状诊断
4. 规则：禁止直接从原始文件写 PPT；先抽取可复用事实、能力描述、
   案例证据、截图与术语；关键论断保留来源引用
```

### Phase 1: 叙事架构
```
产出 03-initiation/演讲叙事规划.md，必须包含：
- 一句话主张
- 受众假设
- 三段式或四段式结构
- 页数目标与时间分配
- 核心框架/模型
```

### Phase 2: 页级设计规格
```
产出 slide-design-spec.yaml + 逐页设计/index.md + 逐页设计/slide-N-*.md
每页必须定义：
- 在全局叙事中的职责
- 核心论点（每页仅一个）
- 来源引用
- 视觉概念（按三层证据模型选型）
- 证据要求
- 口播方向
门禁：用户确认页级结构前，禁止进入 PPT 制作
```

### Phase 3: 版本化制作与评分
```
1. 按版本阶梯逐版打磨，每版单独保存文件并生成联系表
2. 每版完成后按 resources/scorecards/keynote-scorecard-schema.yaml 评分：
   python3 scripts/scorecard_summary.py path/to/scorecard.yaml --json
3. PPTX 结构审计（交付前必跑）：
   python3 scripts/pptx_audit.py path/to/deck.pptx --expected-slides 12
4. 页面生成使用 python-pptx 原生交付（禁止截图转 PPTX），可复用 `kit/pptx_lib/` 提供的构建库
```

### Phase 4: 提词器与彩排
```
主 PPT 定稿后：
1. 生成提词器脚本与提词器 PPT（高对比大字、每页一个短口播单元、
   页脚/元数据标注对应主 PPT 页码）
2. 同步触发条件（任一变化即同步）：页标题、核心论点、视觉主张、
   产品截图、证据卡、案例链、时间分配
3. 彩排超时压缩顺序（先压口播，不动主 PPT 结构）：
   背景铺垫 → 过渡句 → 能力罗列 → 重复证据解释
   必须保留：主张、核心框架、产品证据、实践案例、结尾回扣
```

## 7) Quality Gates

交付前逐项过检 `resources/checklists/keynote-delivery-qg-checklist.md`（7 组 36 项）：

| 门禁 | 检查项（摘要） | 失败处理 |
|------|----------------|----------|
| QG-K1 材料与来源 | 主题/受众/时长入配置；关键判断可追溯来源；截图合规过检 | ERR-01 停止 |
| QG-K2 叙事与结构 | 一句话主张；三/四段式；每页能说明叙事职责；结尾回扣开头 | ERR-02 返工 Phase 1 |
| QG-K3 页级设计 | 每页一个核心论点；抽象概念图形化；能力有证据支撑；案例有事件链 | ERR-02 返工 Phase 2 |
| QG-K4 视觉质量 | 字体/颜色/标题层级统一；重点页有冲击力；节奏变化 | ERR-03 警告 |
| QG-K5 版本管理 | 每版有升级目标；评分记录含多维度；终版写入 manifest | ERR-04 规范化 |
| QG-K6 提词器与彩排 | 定稿后已同步；短句拆页；按时长彩排；超时先压口播 | ERR-02 返工 Phase 4 |
| QG-K7 交付包 | 主PPT/提词器PPT/联系表/QG报告/manifest/交接文件齐全 | ERR-01 停止 |

评分门禁（引用 `resources/scorecards/keynote-scorecard-schema.yaml`）：

| 阈值 | 含义 | 处理 |
|------|------|------|
| weighted_score < 80 | 未达交付线 | 定位最低贡献维度，开新版本专项修复 |
| 80 ≤ score < 90 | 可交付 | 记录残留风险后交付 |
| score ≥ 90 | 达可复用线 | 萃取方法论回流入技能资源 |

## 8) Error Handling

| 错误ID | 触发条件 | 严重级别 | 处理方式 |
|--------|----------|----------|----------|
| ERR-01 | P0 材料缺失（主题/受众/时长、产品材料、模板） | CRITICAL | 停止执行，提示补充 |
| ERR-02 | 叙事/页级/提词器门禁未过 | WARNING | 回到对应 Phase 返工 |
| ERR-03 | 视觉不统一、节奏失衡 | WARNING | 开"视觉统一"专项版本 |
| ERR-04 | manifest/评分记录缺字段 | INFO | 自动规范化补全 |
| ERR-05 | `pptx_audit.py` 报告 slide_count 不匹配或无 notes | WARNING | 修正 PPTX 后重跑审计 |
| ERR-06 | 评分卡 < 80 分 | WARNING | 按最低维度开新版本，禁止直接交付 |

## 9) Key Data Anchors

| 数据项 | 锚定值 | 来源 |
|--------|--------|------|
| 评分范围 | 0-100 | scorecard schema `score_range` |
| 计算公式 | `sum(score_i * weight_i / 100)`，按权重归一 | scorecard schema `calculation.formula` |
| 交付线 | 80 分 | scorecard schema `pass_line` |
| 可复用线 | 90 分 | scorecard schema `reusable_line` |
| 评分维度（10 维） | narrative 12 / framework 12 / product_evidence 12 / visual_quality 10 / scenario_reality 10 / speaker_readiness 10 / engineering_reuse 10 / flow 8 / automation 8 / compliance 8 | scorecard schema `dimensions` |
| 版本阶梯 | 7 级（内容→逻辑→视觉→Keynote→证据→场景→彩排） | 本文件 §5 |
| 超时压缩顺序 | 背景铺垫→过渡句→能力罗列→重复证据解释 | 本文件 §6 Phase 4 |
| 检查清单规模 | 7 组 36 项 | resources/checklists/keynote-delivery-qg-checklist.md |

## 10) Acceptance Criteria

- [ ] 一句话主张明确，三/四段式结构完整，结尾回扣开头
- [ ] 每页仅一个核心论点，且能说明其叙事职责
- [ ] 产品能力论点均有截图或案例证据支撑，案例页有事件链
- [ ] 关键判断均可追溯到来源文件
- [ ] 评分卡加权得分 ≥ 80（交付线），评分记录机器可读
- [ ] `pptx_audit.py` 审计通过（slide 数匹配、notes 存在）
- [ ] 主 PPT 与提词器 PPT 同步，提词器按短句拆页
- [ ] 已按目标时长彩排，超时按固定顺序压缩口播
- [ ] 交付包齐全：主PPT、提词器PPT、联系表、QG报告、manifest、交接文件
- [ ] 检查清单 7 组 36 项全部勾选或明确标注例外

---

## 版本历史

| 版本 | 日期 | 变更说明 |
|------|------|----------|
| 1.0.0 | 2026-08-13 | 初始版本：自一次真实峰会演讲交付项目的经验沉淀脱敏萃取；萃取版本阶梯、视觉证据三层、提词器/彩排方法论骨架；接入 resources 检查清单与评分卡 schema 及 scripts 配套脚本 |