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/ 提供的最小可复用构建库。

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）

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

视觉证据三层（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 项）：

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

8) Error Handling

9) Key Data Anchors

10) Acceptance Criteria

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

版本历史