planners-ppt-hell

Planner's PPT Hell

由阿祖不看 TVC 创建与维护。https://demyth.info · [email protected]。 署名保留在 Skill 与工作台，不加入客户 PPT、SVG 或 PNG。

SVG 工作台持续存在。用户改字与模型候选共用版本存储；PPT 与视频快照是可重复输出，不是项目终态。普通页面没有批准门；模板入库保留独立的当前包人工确认。

1. 接收

职责与接口见 架构。读 00_pipeline_controller.md，初始化或恢复同一项目。 幻灯片可接收 Bypage 逐页稿，也可从用户材料、已有稿件或需求直接整理内容；按复杂度调用 Bypage，不把它设为前置门。见 02_content_stage.md。 视频可适配 visual-plan.json 与 assets，也可直接接收上屏稿或材料；已有 screen ID 保持不变。见 03_video_route.md。 沿用 Bypage 的 canonical 来源索引和已绑定的事实核查；内容改写后的核查时机与范围见内容输入文档，不把原 audit 扩大为新页面已核查。 结束条件：来源可读、稳定页面身份可定位、资产已登记且没有静默遗漏。

2. 定方向

一次确认画幅与视觉来源，用户已指明的直接执行。共同秩序写入 _internal/01_content/design_direction.md。 通用判断读 style_system.md；选择信息关系时读 layout_taxonomy.md。模板含义以 模板契约 为准；开画前读取所选模板/主题定义并实际查看样张；没有模板时查看本次参考，具体构图由当前内容决定。 幻灯片复用参考、选择库模板或提炼入库时读 01_template_intake.md；只有入库分支需要模板人工确认。 结束条件：方向和画幅明确，必要的源参考已经实际查看。

3. 工作台

读 04_svg_stage.md。模型可以通过 store CLI 新增或删除页面；新增页提交完整 candidate 与 page 元数据，删除页提交 page_key、base_revision 与 base_order。已有页先 checkout 当前页，编辑返回的候选，再提交 author=model、candidate、base_revision。_internal/02_svg_source 是可重建兼容视图，不是生成脚本写入位置。 读取 notes、protected 与待办 tasks；冲突时保留候选并重新读取。遗漏用户操作会被拦下，明确改写范围只来自浏览器任务授权。 用 check --summary 批量检查本轮页面，再逐页查看当前 PNG、记录实际 inspect。打开工作台与反馈恢复见 07_visual_review.md；反馈不是批准，未完成反馈不阻止独立输出。运行在 DSH 时用 review_open 自动加载同一工作台到侧栏；非 DSH 自动启动或复用 planners-review-core 本地宿主。两路共用同一份 Workbench Store、草稿和命令回执。 结束条件：本轮提交有保存回执，技术问题与实际看图结果可查。工作台可继续修改，没有永久 COMPLETE。

4. 输出

网页先保存末次输入、页序和页面集合并提交 snapshot；宿主唤醒携带确切 snapshot.path。运行 python scripts/orchestrate/ppt_pipeline.py <project> export --snapshot <snapshot.json绝对路径> 消费选定版本；指定无效路径直接报错。未指定路径时，export 才固定当前页面、页序与资产。 控制器校验冻结画面。slides 的 PPT、notes 与转换报告在 _internal/06_ppt_output/<snapshot_id>/；export 的 output_path 指向实际输出，根 final_deck.pptx 只是最新兼容副本。video 返回不可变 snapshot.json 给 Video Craft。 PPT 用实际渲染预览运行 export-inspect --snapshot <同一snapshot.json> --previews <实际PNG...> --note "<工具与发现>"，绑定该次输出，不要求工作台停止编辑。没有渲染工具就报告未复核，保留 EXPORT_VERIFY；快照校验范围见 项目契约。 视频只保留不可变快照、页序、SVG、资产与 notes；元素 id、步骤钩子、脚本绑定都是可选增强，不要求。报告 content_delta / changed_needs_check；它们不证明新文本与已录音语义一致。动效与合成规范归 Video Craft。 结束条件：输出的快照与文件可定位、技术结果已报告、实际复核工具及限制清楚。随后仍可回到工作台。

按需读取

分支	上下文
SVG 特性、缺图或转换错误	svg_rules.md；PPT 再读 svg_to_ppt_rules.md
版本、候选、反馈恢复或输出溯源	project_contract.md
新模板包制作、审阅、替换入库	template_package.md
视频主题选择	03_video_route.md；选 editorial-archive 再读 video_style_editorial_archive.md
新视频风格提炼	08_video_style_extraction_sop.md
工程维护与验证	ARCHITECTURE.md；命令参数以各脚本 --help 为准

运行后迭代

任务后内部自检，仅明确纠正或多次复现的通用缺陷列为候选，项目反馈留在项目；没有可复用发现不增加日志。 改之前读 架构；候选记 GOTCHAS 的现象、原因、行为修正、证据、状态与 module；实际升级记 维护历史 的变化、原因、影响与移除项。 Skill 改动先确认，冻结候选测试，完成后统一发布；候选验收阶段不改正式来源或 runtime。