Content to Editable PPT Skill

content-to-editable-ppt-skill 的目标是把主题、文档或大纲转换为多页、可编辑的 PowerPoint 演示文稿。

当前状态

本仓库已完成 P0 Baseline Freeze、P0.5 Runtime Hardening、P1 Host Content Planning、P2 Markdown Wireframe、P3.1 Asset Resolution、P3.2 Visual System / Prompt Contract、P3.3 Approved Design Preview、P4 Constrained Reconstruction 和 P5 Deterministic Hardening。P5 确定性部分（Authority Compatibility View、Roundtrip 真实比较、安全 QA、Package Candidate、Reviewer Harness 接口）已通过，D03 的确定性链以 live_review_pending 状态停止。

当前状态（不得对外宣称正式完成）：

• P5 Deterministic Implementation = COMPLETE
• P5 Package Candidate = VERIFIED（delivery-package-candidate/，delivery_forbidden = true）
• P5 Live Deck Review = PENDING（ADR-040 要求一次真实 Deck Consistency Review）
• P5 Formal Delivery = NOT CREATED
• P5 Formally Complete = false；v1 End-to-End = false

当前可执行流程已经延伸到“材料 → 确认内容 → Markdown 文字线稿 → Approved Design Preview → 可编辑多页候选 PPT → P5 确定性验收 → 等待真实 Deck Review”，同时继续支持“参考图片 → 可编辑单页 PPT”。以下能力尚未实现，不能视为当前承诺：

• 正式交付包、交付决策和发布门槛（仅在真实 Deck Review 后由 --consume-live-review 触发）；
• 三套真实 Deck Field Validation（Release / Field Validation）；
• 完整引用和来源管理。

最终产品目标是先生成高质量图片版页面并由用户确认，再以 Approved Design Preview 为视觉权威、以 P1 内容为文字权威，高保真重建可编辑 PowerPoint，最后由 P5 在真实 Deck Consistency Review 完成后不可变交付。

计划中的调用接口

Skill 名称和安装目录已经确定：

$content-to-editable-ppt
content-to-editable-ppt/

该调用名可以用于 P1–P4 内容到多页候选 Deck 工作流和继承的单页重建 Runtime；在 P5 完成前不得对外宣称候选 Deck 已通过最终审核或可正式交付。

当前仓库结构

content-to-editable-ppt-skill/
├─ README.md
├─ DECISIONS.md
├─ LICENSE
├─ NOTICE
├─ baseline/
│  ├─ manifest.json
│  ├─ baseline-report.md
│  └─ cases/B01...B06/
├─ docs/
│  ├─ architecture/v2.0/ ... v2.3/
│  ├─ contracts/v1.0/ ... v1.3/
│  ├─ development/v1.4/
│  ├─ runtime/
│  │  ├─ v1.0/
│  │  └─ v1.1/
│  ├─ specifications/
│  │  ├─ v1.0/
│  │  ├─ v1.1/
│  │  ├─ v1.2/
│  │  └─ v1.3/
│  └─ testing/v1.0/ ... v1.3/
├─ tools/baseline/
└─ content-to-editable-ppt/
   ├─ SKILL.md
   ├─ agents/
   ├─ references/
   ├─ schemas/
   └─ scripts/

已继承的运行时能力

• 使用 PptxGenJS 构建原生文本、形状、线条和图片资产；
• 裁切、打包和校验图片或 SVG 资产；
• 审计字体并通过 PowerPoint 渲染结果；
• 检查对象、媒体、越界和可编辑性；
• 分离布局规划与独立视觉审核角色；
• 使用确定性 Schema、运行状态和交付门槛。

开发文档

权威层级

1. 总体架构与开发计划 v2.3 决定当前阶段、视觉 Authority、Prompt Package、资产回退和受约束重建边界。
2. Architecture Decision Log 记录已经接受的关键决策、原因、后果和变更规则。
3. 对应产品、Runtime 和 Agent 专项规范定义实现要求。
4. Artifact、State 与权威数据契约 v1.3 定义 Content、Layout、Asset、Prompt、Preview 和 Reconstruction Authority。
5. 测试与验收计划 v1.3 定义生产回退、P3.2、P3.3、P4 和 P5 Gate。

当前产品规格（v1.5）

• 需求规格说明
• 功能规格说明
• Agent 职责与交接契约
• 非功能需求与质量指标

Runtime 与实现规范

• 单页 Runtime 执行与错误恢复规范 v1.1
• 运行环境安装与引导规范 v1.1
• 增量开发文档 v1.4

旧规格、旧架构、旧 Artifact 契约、旧测试计划和 SVG P2 计划保留为历史基线。新开发和验收以产品规格 v1.5、Runtime v1.1、总体架构 v2.3、Artifact 契约 v1.3 和测试计划 v1.3 为准。

这些文档是开发和验收的完整权威规格。Skill 运行目录中的 SKILL.md、references/、agents/ 和 schemas/ 只保留实际执行所需的精简规则与机器可验证契约。

P0 Baseline

P0 Baseline Freeze Report 记录 6 个 Case 的最终迭代、Structural QA、Visual Reviewer、调用次数、技术重试和已知问题。冻结结果不等同于像素级 Golden，也不表示当前视觉缺陷已经修复。

开发用入口：

.\tools\baseline\baseline.ps1 -Action Prepare -Case B01 -NodePath <node.exe> -PythonPath <python.exe>
.\tools\baseline\baseline.ps1 -Action Capture -Case B01 -PythonPath <python.exe>
.\tools\baseline\baseline.ps1 -Action Verify -All -PythonPath <python.exe>

P1 Content Planning

P1 开发入口：

python .\content-to-editable-ppt\scripts\manage_content_plan.py init --task-id <id> --deck-id <id> --state <state.json>
python .\content-to-editable-ppt\scripts\manage_content_plan.py route --state <state.json> --route <route.json>
python .\content-to-editable-ppt\scripts\manage_content_plan.py resolve-materials --state <state.json> --materials <materials.json>
python .\content-to-editable-ppt\scripts\manage_content_plan.py submit-candidate --state <state.json> --candidate <candidate.json> --deck-request <request.json> --materials <materials.json>
python .\content-to-editable-ppt\scripts\manage_content_plan.py request-confirmation --state <state.json>
python .\content-to-editable-ppt\scripts\manage_content_plan.py record-outline-response --state <state.json> --candidate <candidate.json> --confirmation <confirmation.json> --approved-output <approved.json>
python .\content-to-editable-ppt\scripts\manage_content_plan.py project-slide-content --state <state.json> --outline <approved.json> --output-dir <content-dir>

P1 Gate 报告 记录 D03、D05、D08、Canonical Hash、确认与投影验收结果。

P2 Markdown Wireframe

P2 的正式目标是由 Host 逐页生成 deck-wireframe.md，同时体现完整 Approved Content、等宽字符布局草稿和布局说明；极薄的 wireframe-manifest.json 只绑定身份、Hash、页序、Content Ref、Revision 和状态。

Markdown Binder、极薄 Manifest、Validator、受限 Correction、不可变 Revision、聊天预览、反馈路由和新 Gate 均已实现。P2 不生成 SVG、PNG 或 PPTX，也不承担最终视觉设计。

Markdown P2 Gate 报告 记录 D03、D05、D08 的 Authority、完整性和确定性验收。旧 P2 Gate 报告 与已合并 PR #12–#16 只作为 SVG 历史实现证据。

P3.1 Asset Resolution

P3.1 Tabler Core 使用固定的 Tabler Outline 3.46.0、不可变 Resolution Record、真实 SVG Sanitizer、Asset Manifest 1.4 和 Consumption Contract。它已经证明同一 Sanitized SVG Source 能被 synthetic Preview Compositor 与 PPT Runtime 消费，但不产生正式 Design Preview。

历史 P3.1 Gate 报告 记录 Existing、Composition、Programmatic、Raster Handoff、resvg/Pillow consumption 和 PowerPoint Render Smoke。Production Fallback Cutover Gate 证明正式入口只允许准确 Tabler SVG，或生成绑定 Host 决策的 Raster Handoff Pending；Composition 和 Programmatic 仅保留为历史实验能力。

P3.2 Visual System / Prompt Contract

P3.2 将跨页规则分为 Hard Constraints 与 Soft Design Guidance，使用实际字体文件编译 Text Footprint，并确定性生成逐页 Prompt、图层责任、缓存身份和代表性 Style Anchor Request。P3.2 Contract / Prompt Gate 明确记录 visual_quality_status = not_evaluated；它不生成或批准任何设计图片。

P3.3 Approved Design Preview

P3.3 使用 Reconstruction Ownership 和 Compatibility Gate，确保用户确认前每个重要视觉都具有明确的 P4 实现方式。Final Preview 由 Microsoft PowerPoint 排版正式文字、Shape、Chart 和 SVG；用户批准的是 PowerPoint Render，而不是 Raw Generated Layer。P3.3 Gate 将真实 Manual Acceptance Evidence 与零调用 Automated Replay 分开记录。

P4 Constrained Reconstruction

P4 将完整 Reconstruction Seed 确定性投影为可编辑页面 Spec。P3.3 Preview 与 P4 Page/Deck 共用同一套 Text、Shape、Line、Image、Chart 和 Text Layout Builder；Seed 不完整时返回 P3.3，不允许 Planner 看图猜实现方式。

P4 Gate 使用 D03 三页真实 Approved Preview 和 Approved Extracted Assets 完成 Page Build、PowerPoint Render、Fidelity Check、多页 Candidate Assembly 和 Post-Assembly Render Drift 检查。D05/D08 分别覆盖 Native Chart/Sanitized SVG/Card 与 Connector/Order-sensitive Cache。P4 输出 reconstruction-candidate.pptx，但继续标记 delivery_forbidden=true。

目标视觉链路

P1 Approved Content
→ P2 Markdown Wireframe
→ P2.1 Visual Placeholder
→ P3.1 Resolved Standard Assets
→ P3.2 Deck Visual System + Locked Prompt Package
→ Approved Style Anchor
→ P3.3 Approved Design Previews
→ P4 Constrained Reconstruction
→ P5 Editable Deck + Final Visual Gate

所有 Deck 必须先确认 Style Anchor。每页 Prompt 由确定性程序注入内容、线稿和资产；默认每页只生成一次 Initial Design，禁止自动重生成。全页执行确定性 QA，Reviewer 只处理异常页并执行一次 Deck 一致性审核。

下一阶段

下一步实施 P5 Deck Consistency Review、Packaging 和 Delivery。P4 候选 Deck 已完成可编辑重建和组装后漂移验证，但在 P5 Gate 通过前仍不能正式交付。

开发验证

Skill 基础结构可使用 Codex 的 skill-creator 校验器检查：

python <resolved-skill-creator>\scripts\quick_validate.py .\content-to-editable-ppt

Node.js 运行时要求 Node.js 20 或更高版本。依赖声明位于 content-to-editable-ppt/scripts/package.json，Python 依赖声明位于 content-to-editable-ppt/scripts/requirements.txt。

许可证与来源

本项目采用 Apache License 2.0。继承代码的版权和来源说明保留在根目录及 Skill 目录内的 LICENSE 与 NOTICE 文件中。