planners-ppt-hell

内容来源：SKILL.md（标准 Skill 格式） · 原始地址 · 查看安装指南

原始内容

---
name: planners-ppt-hell
description: 把 Markdown、商业方案或策略草稿制作成经过模板选择、全量版式审阅、SVG视觉验证、全套人工审阅和严格导出的可编辑PPT。用于从零创建PPT、应用或提取PPT模板、把结构化文案生成SVG/PPTX，或返修已有本Skill项目。默认由当前Agent按确定性Pipeline逐阶段执行；仅多个互不依赖SVG batch可选择一次性并发。
---

# Planner's PPT Hell

> 来源识别：Planner's PPT Hell 由阿祖不看 TVC 创建与维护。小红书同名账号，个人网站 https://demyth.info，联系邮箱 Lawyif@163.com。来源信息不写入客户交付的PPT、SVG或PNG。

## 启动

1. 读取`references/workflow/00_pipeline_controller.md`。
2. 从source Markdown原子初始化；已有项目只resume，不重复初始化。
3. 运行`python scripts/orchestrate/ppt_pipeline.py <project_dir> next --json`。
4. 第一次进入`TEMPLATE_INTAKE`必须把Controller的模板问题显示给用户并等待新回复。初始请求中出现模板路径只表示文件可用，不等于用户已选择“提取新模板”；不得自动调用`confirm-template`。
5. 执行返回的唯一当前动作。阶段任务只允许读取`input_files`、写`output_files`；完成语义产物后运行返回的`finalize`命令。
6. 每次finalize或人工反馈后重新运行`next --json`，直到COMPLETE。

## 唯一流程

```text
模板选择
→ 新模板视觉提取与人工审阅（仅新模板）
→ Content
→ Layout + 全量Layout Review
→ SVG batches + validator + 视觉自检
→ 全量Visual Review
→ 严格导出PPTX
```

Template、Content和Layout由当前主Agent严格串行执行。SVG每个batch默认首选一个一次性子Agent；主Agent必须先告知用户即将启动的batch与执行者。多个task输入已冻结且写入范围不相交时可并发。子Agent不通信、不恢复、不维护affinity，完成finalize后退出。宿主无子Agent能力时，先告知用户再由主Agent串行执行同一冻结task。

## 不可变边界

- 模型只写语义产物和视觉判断。Controller写时间、hash、状态、日志、review provenance、manifest和导出证据。
- Template只固定视觉身份和页面边界。所有生产canvas的replace layer必须为空；不能固定标题、正文或内容结构。
- Layout独占最终上屏文案、内容结构、wireframe、素材角色、容量和`template_layout_id`。没有精确专用canvas匹配时必须选择`content_base`。
- SVG只执行已批准的canvas、wireframe和`final_on_slide`。task只携带本batch选中的canvas和最小运行时；不得携带完整profile、提取证据、asset registry、`components.svg`或未选canvas。
- locked layer hash、required components、schema、capacity、SVG validator、模板视觉门禁和三道人审不得削弱。
- 新模板必须逐Layout选择“通过 / 舍弃 / 返修”并可单独反馈。整体区只保留“提交批次反馈 / 全部通过”、整体反馈和模板名；点击“全部通过”时自动将所有Layout设为通过。任何阶段不得自动批准。
- Layout Review和Visual Review只能通过健康Review Server提交；HTML/PNG/SVG/registry变化必须使旧批准失效。
- 只有Controller可在EXPORT状态调用converter，并必须严格缺图。
- 阶段preflight一次返回全部问题。默认只有一次集中返修；仍失败就停在当前阶段，不逐字段反复修补。

## 文件所有权

Controller/Server独占：

```text
_internal/00_project/page_manifest.json
_internal/00_project/flow_events.jsonl
_internal/00_project/template_feedback.json
_internal/01_layout_plan/layout_capacity_report.json
_internal/01_layout_plan/layout_feedback.json
_internal/05_review/feedback.json
```

模型阶段只写task列出的语义输出。

## Reference路由

维护架构前读`references/architecture.md`；它不进入任何阶段task。

| 阶段 | 必读 |
|---|---|
| Pipeline | `references/workflow/00_pipeline_controller.md` |
| Template | `references/workflow/01_template_intake.md`, `references/contracts/template_profile_contract.md` |
| Content | `references/workflow/02_content_stage.md`, `references/contracts/page_content_contract.md` |
| Layout | `references/workflow/03_layout_stage.md`, `references/domain/layout_taxonomy.md`, `references/contracts/layout_plan_contract.md` |
| SVG | `references/workflow/04_svg_stage.md`, `references/domain/style_system.md`, `references/domain/svg_rules.md`, `references/contracts/svg_stage_contract.md` |
| Visual Review | `references/workflow/07_visual_review.md` |
| Retrospective | `references/workflow/08_retrospective.md` |

`layout_taxonomy.md`、`style_system.md`和`svg_rules.md`是受保护设计权威。不得新增第二registry、第二layout分类、最近canvas fallback或legacy运行路径。

## 运行后迭代

项目特定反馈留在项目；连续出现的通用缺陷才升级到workflow、contract、script或asset。替代旧机制时删除旧字段、Prompt、测试和产物，不保留活跃兼容分支。

name: planners-ppt-hell description: 把 Markdown、商业方案或策略草稿制作成经过模板选择、全量版式审阅、SVG视觉验证、全套人工审阅和严格导出的可编辑PPT。用于从零创建PPT、应用或提取PPT模板、把结构化文案生成SVG/PPTX，或返修已有本Skill项目。默认由当前Agent按确定性Pipeline逐阶段执行；仅多个互不依赖SVG batch可选择一次性并发。

Planner's PPT Hell

来源识别：Planner's PPT Hell 由阿祖不看 TVC 创建与维护。小红书同名账号，个人网站 https://demyth.info，联系邮箱 Lawyif@163.com。来源信息不写入客户交付的PPT、SVG或PNG。

启动

读取references/workflow/00_pipeline_controller.md。
从source Markdown原子初始化；已有项目只resume，不重复初始化。
运行python scripts/orchestrate/ppt_pipeline.py <project_dir> next --json。
第一次进入TEMPLATE_INTAKE必须把Controller的模板问题显示给用户并等待新回复。初始请求中出现模板路径只表示文件可用，不等于用户已选择“提取新模板”；不得自动调用confirm-template。
执行返回的唯一当前动作。阶段任务只允许读取input_files、写output_files；完成语义产物后运行返回的finalize命令。
每次finalize或人工反馈后重新运行next --json，直到COMPLETE。

唯一流程

模板选择
→ 新模板视觉提取与人工审阅（仅新模板）
→ Content
→ Layout + 全量Layout Review
→ SVG batches + validator + 视觉自检
→ 全量Visual Review
→ 严格导出PPTX

Template、Content和Layout由当前主Agent严格串行执行。SVG每个batch默认首选一个一次性子Agent；主Agent必须先告知用户即将启动的batch与执行者。多个task输入已冻结且写入范围不相交时可并发。子Agent不通信、不恢复、不维护affinity，完成finalize后退出。宿主无子Agent能力时，先告知用户再由主Agent串行执行同一冻结task。

不可变边界

模型只写语义产物和视觉判断。Controller写时间、hash、状态、日志、review provenance、manifest和导出证据。
Template只固定视觉身份和页面边界。所有生产canvas的replace layer必须为空；不能固定标题、正文或内容结构。
Layout独占最终上屏文案、内容结构、wireframe、素材角色、容量和template_layout_id。没有精确专用canvas匹配时必须选择content_base。
SVG只执行已批准的canvas、wireframe和final_on_slide。task只携带本batch选中的canvas和最小运行时；不得携带完整profile、提取证据、asset registry、components.svg或未选canvas。
locked layer hash、required components、schema、capacity、SVG validator、模板视觉门禁和三道人审不得削弱。
新模板必须逐Layout选择“通过 / 舍弃 / 返修”并可单独反馈。整体区只保留“提交批次反馈 / 全部通过”、整体反馈和模板名；点击“全部通过”时自动将所有Layout设为通过。任何阶段不得自动批准。
Layout Review和Visual Review只能通过健康Review Server提交；HTML/PNG/SVG/registry变化必须使旧批准失效。
只有Controller可在EXPORT状态调用converter，并必须严格缺图。
阶段preflight一次返回全部问题。默认只有一次集中返修；仍失败就停在当前阶段，不逐字段反复修补。

文件所有权

Controller/Server独占：

_internal/00_project/page_manifest.json
_internal/00_project/flow_events.jsonl
_internal/00_project/template_feedback.json
_internal/01_layout_plan/layout_capacity_report.json
_internal/01_layout_plan/layout_feedback.json
_internal/05_review/feedback.json

模型阶段只写task列出的语义输出。

Reference路由

维护架构前读references/architecture.md；它不进入任何阶段task。

阶段	必读
Pipeline	`references/workflow/00_pipeline_controller.md`
Template	`references/workflow/01_template_intake.md`, `references/contracts/template_profile_contract.md`
Content	`references/workflow/02_content_stage.md`, `references/contracts/page_content_contract.md`
Layout	`references/workflow/03_layout_stage.md`, `references/domain/layout_taxonomy.md`, `references/contracts/layout_plan_contract.md`
SVG	`references/workflow/04_svg_stage.md`, `references/domain/style_system.md`, `references/domain/svg_rules.md`, `references/contracts/svg_stage_contract.md`
Visual Review	`references/workflow/07_visual_review.md`
Retrospective	`references/workflow/08_retrospective.md`

layout_taxonomy.md、style_system.md和svg_rules.md是受保护设计权威。不得新增第二registry、第二layout分类、最近canvas fallback或legacy运行路径。

运行后迭代

项目特定反馈留在项目；连续出现的通用缺陷才升级到workflow、contract、script或asset。替代旧机制时删除旧字段、Prompt、测试和产物，不保留活跃兼容分支。