1. Detect Mode

Choose one path:

• New presentation: user has a topic, notes, or full draft
• PPT conversion: user has .ppt or .pptx
• Enhancement: user already has HTML slides and wants improvements

2. Discover Content

Ask only the minimum needed:

• purpose: pitch, teaching, conference talk, internal update
• length: short (5-10), medium (10-20), long (20+)
• content state: finished copy, rough notes, topic only

If the user has content, ask them to paste it before styling.

3. Discover Style

Default to visual exploration.

If the user already knows the desired preset, skip previews and use it directly.

Otherwise:

1. Ask what feeling the deck should create: impressed, energized, focused, inspired.
2. Generate 3 single-slide preview files in .ecc-design/slide-previews/.
3. Each preview must be self-contained, show typography/color/motion clearly, and stay under roughly 100 lines of slide content.
4. Ask the user which preview to keep or what elements to mix.

Use the preset guide in STYLE_PRESETS.md when mapping mood to style.

4. Build the Presentation

Output either:

• presentation.html
• [presentation-name].html

Use an assets/ folder only when the deck contains extracted or user-supplied images.

Required structure:

• semantic slide sections
• a viewport-safe CSS base from STYLE_PRESETS.md
• CSS custom properties for theme values
• a presentation controller class for keyboard, wheel, and touch navigation
• Intersection Observer for reveal animations
• reduced-motion support

5. Enforce Viewport Fit

Treat this as a hard gate.

Rules:

• every .slide must use height: 100vh; height: 100dvh; overflow: hidden;
• all type and spacing must scale with clamp()
• when content does not fit, split into multiple slides
• never solve overflow by shrinking text below readable sizes
• never allow scrollbars inside a slide

Use the density limits and mandatory CSS block in STYLE_PRESETS.md.

6. Validate

Check the finished deck at these sizes:

• 1920x1080
• 1280x720
• 768x1024
• 375x667
• 667x375

If browser automation is available, use it to verify no slide overflows and that keyboard navigation works.

7. Deliver

At handoff:

• delete temporary preview files unless the user wants to keep them
• open the deck with the platform-appropriate opener when useful
• summarize file path, preset used, slide count, and easy theme customization points

Use the correct opener for the current OS:

• macOS: open file.html
• Linux: xdg-open file.html
• Windows: start "" file.html

PPT / PPTX Conversion

For PowerPoint conversion:

1. Prefer python3 with python-pptx to extract text, images, and notes.
2. If python-pptx is unavailable, ask whether to install it or fall back to a manual/export-based workflow.

…

santa-method

通过双评审智能体对结果进行对抗式校验，提升输出发布前的可靠性

frontend-patterns

帮助你梳理 React 与 Next.js 前端模式、状态管理及性能优化最佳实践