visual-req proposal-generator
该 Skill 用于生成可直接被前端打开的网页 PPT JSON 数据。
它的核心约束不是“一次性输出 deck”，而是采用两阶段流程：
- 先生成并确认
outline.json - 再生成
deck.json + slides/*.json
适用场景
- 用户要求“做成 PPT / 汇报稿 / 路演稿 / deck”
- 用户希望输出可直接打开的网页 PPT
- 用户希望同时得到结构大纲、详细页与图形素材
Commands
/fppt:outline
生成并写出 work/ppt/001_项目名/outline.json，用于确认章节结构、页面顺序、布局选择和每页核心结论。
流程：
- 判断 PPT 类型（课件类/方案类/汇报类/演示类）
- 读取对应类型提示词（
skills/prompts/ppt/01~04_*.md） - 规划章节结构、页面顺序、每页 layout_type 和决策目的
- 写出
outline.json - 执行大纲质检，通过后才能进入下一阶段
/fppt:detail
基于已确认的 outline.json，生成 deck.json + slides/*.json，补齐每页的文案、图表字段和素材引用。
流程：
- 读取已确认的
outline.json - 逐页生成 slide JSON，填充 title/subtitle/blocks/table/chart/svg 等字段
- 对图形页主动在
work/assets/下生成 SVG 资产 - 写出
deck.json和所有slides/*.json - 执行详细页质检，通过后再交付
/fppt:viewer
启动前端预览服务。
流程：
- 如果
ppt-viewer/dist/不存在，先执行npm --prefix ppt-viewer run build - 执行
node server.mjs - 服务启动在
http://localhost:9030/
也可以用项目根目录的快捷命令：
npm run dev：先 build 再启动npm start：直接启动（需已 build）
/fppt:review
基于已生成的 detail（deck.json + slides），站在听众视角对内容进行全面的审阅评判。
流程：
- 读取
deck.json确定 PPT 类型（课件类/方案类/汇报类/演示类） - 读取
skills/prompts/ppt/05_review.md中的审阅标准 - 先检查 deck 的页顺序、章节归属、前后承接和主题一致性，再逐页读取 slides JSON 评判：
- 可理解性：听众一次性能否听懂核心信息？
- 结构清晰度：页面信息层级是否一目了然？
- 信息密度：是否过于拥挤或过于空洞？
- 视觉匹配度：layout_type 选择是否合理？
- 承接连贯性：前后页逻辑是否流畅？
- 章节归属合理性：页面是否放在正确章节
- 主题关联性：标题、内容、章节主题是否一致
- 布局合理性：当前 layout_type 是否真的适合内容表达
- 图形质量：如为图表/SVG/流程图，额外检查结构、内容、序号、对齐与完整显示
- 根据 PPT 类型叠加专用审阅维度（见 05_review.md）
- 输出
work/ppt/XXX/review-yyyyMMddHHmmss.md，包含：- 总体评分与总评
- 逐页诊断（问题 + 严重等级 + 改进建议）
- 优先级排序的修改清单
工作区结构
work/
input/
001_项目名/
ppt/
001_项目名/
outline.json
deck.json
slides/
001_cover.json
002_agenda.json
...
assets/
*.svg
类型支持
生成时必须先确定 deck.type，四选一：
课件类方案类汇报类演示类
类型一旦确定，必须继续读取对应提示词：
skills/prompts/ppt/01_课件类.mdskills/prompts/ppt/02_方案类.mdskills/prompts/ppt/03_汇报类.mdskills/prompts/ppt/04_演示类.md
输出要求
必须输出到项目目录：
work/ppt/001_项目名/outline.jsonwork/ppt/001_项目名/deck.jsonwork/ppt/001_项目名/slides/*.json
图示类素材默认输出到：
work/assets/*.svg
前端工程通过读取 deck.json + slides/*.json 聚合展示，不再要求生成 deck.html。
质量要求
- 强制使用
outline -> detail两阶段流程 outline阶段结束后必须先做一轮大纲质检detail阶段结束后必须再做一轮详细页质检- 图示类页面优先采用
svg_full、phases、swimlane_process、comparison_table等结构化表达 svg_full默认不在 SVG 内重复写页面标题，标题由 deck 页标题承担- 页面标题必须是业务主题或结论，禁止直接使用布局名称作为标题；不要出现“九宫格”“四宫格”“步骤图”“流程图”“甘特图”等命名
提示词目录
fast_ppt/
README.md
LICENSE
docs/
usage.md
workflow.md
layouts.md
skills/
SKILL.md
prompts/
ppt/
00_PPT生成.md
01_课件类.md
02_方案类.md
03_汇报类.md
04_演示类.md
05_review.md
layouts.md
layout_rules.md
examples/