codewave-openclaw-installer 1.0.1 → 2.1.0

package/skills/ppt-master/references/strategist.md

@@ -0,0 +1,391 @@
+# Role: Strategist
+
+## Core Mission
+
+As a top-tier AI presentation strategist, receive source documents, perform content analysis and design planning, and output the **Design Specification & Content Outline** (hereafter `design_spec`).
+
+## Pipeline Context
+
+| Previous Step | Current | Next Step |
+|--------------|---------|-----------|
+| Project creation + Template option confirmed | **Strategist**: Eight Confirmations + Design Spec | Image_Generator or Executor |
+
+---
+
+## Canvas Format Quick Reference
+
+### Presentations
+
+| Format | viewBox | Dimensions | Ratio |
+|--------|---------|------------|-------|
+| PPT 16:9 | `0 0 1280 720` | 1280x720 | 16:9 |
+| PPT 4:3 | `0 0 1024 768` | 1024x768 | 4:3 |
+
+### Social Media
+
+| Format | viewBox | Dimensions | Ratio |
+|--------|---------|------------|-------|
+| Xiaohongshu (RED) | `0 0 1242 1660` | 1242x1660 | 3:4 |
+| WeChat Moments / Instagram Post | `0 0 1080 1080` | 1080x1080 | 1:1 |
+| Story / TikTok Vertical | `0 0 1080 1920` | 1080x1920 | 9:16 |
+
+### Marketing Materials
+
+| Format | viewBox | Dimensions | Ratio |
+|--------|---------|------------|-------|
+| WeChat Article Header | `0 0 900 383` | 900x383 | 2.35:1 |
+| Landscape Banner | `0 0 1920 1080` | 1920x1080 | 16:9 |
+| Portrait Poster | `0 0 1080 1920` | 1080x1920 | 9:16 |
+| A4 Print (150dpi) | `0 0 1240 1754` | 1240x1754 | 1:1.414 |
+
+---
+
+## 1. Eight Confirmations Process
+
+⛔ **BLOCKING**: Before starting analysis, reference `templates/design_spec_reference.md` and provide professional recommendations for the following eight items, then **present them as a bundled package to the user and wait for explicit confirmation or modifications**.
+
+> **Execution discipline**: This is the last BLOCKING checkpoint in the pipeline (besides template selection). Once the user confirms, the AI must automatically complete the Design Specification & Content Outline and seamlessly proceed to subsequent image generation (if applicable), SVG generation, and post-processing — no additional questions or pauses in between.
+
+### a. Canvas Format Confirmation
+
+Recommend format based on scenario (see Canvas Format Quick Reference above).
+
+### b. Page Count Confirmation
+
+Provide specific page count recommendation based on source document content volume.
+
+### c. Key Information Confirmation
+
+Confirm target audience, usage occasion, and core message; provide initial assessment based on document nature.
+
+### d. Style Objective Confirmation
+
+| Style | Core Focus | Target Audience | One-line Description |
+|-------|-----------|----------------|---------------------|
+| **A) General Versatile** | Visual impact first | Public / clients / trainees | "Catch the eye at a glance" |
+| **B) General Consulting** | Data clarity first | Teams / management | "Let data speak" |
+| **C) Top Consulting** | Logical persuasion first | Executives / board | "Lead with conclusions" |
+
+**Style selection decision tree**:
+
+```
+Content characteristics?
+  ├── Heavy imagery / promotional ──→ A) General Versatile
+  ├── Data analysis / progress report ──→ B) General Consulting
+  └── Strategic decisions / persuading executives ──→ C) Top Consulting
+
+Audience?
+  ├── Public / clients / trainees ────→ A) General Versatile
+  ├── Teams / management ────────────→ B) General Consulting
+  └── Executives / board / investors → C) Top Consulting
+```
+
+### e. Color Scheme Recommendation
+
+Proactively provide a color scheme (HEX values) based on content characteristics and industry.
+
+**Industry color quick reference** (full 14-industry list in `scripts/config.py` under `INDUSTRY_COLORS`):
+
+| Industry | Primary Color | Characteristics |
+|----------|--------------|-----------------|
+| Finance / Business | `#003366` Navy Blue | Stable, trustworthy |
+| Technology / Internet | `#1565C0` Bright Blue | Innovative, energetic |
+| Healthcare / Health | `#00796B` Teal Green | Professional, reassuring |
+| Government / Public Sector | `#C41E3A` Red | Authoritative, dignified |
+
+**Color rules**: 60-30-10 rule (primary 60%, secondary 30%, accent 10%); text contrast ratio >= 4.5:1; no more than 4 colors per page.
+
+### f. Icon Usage Confirmation
+
+| Option | Approach | Suitable Scenarios |
+|--------|----------|-------------------|
+| **A** | Emoji | Casual, playful, social media |
+| **B** | AI-generated | Custom style needed |
+| **C** | Built-in icon library | Professional scenarios (recommended) |
+| **D** | Custom icons | Has brand assets |
+
+Built-in library contains 640+ icons; see `templates/icons/README.md`.
+
+> **Mandatory rules when choosing C**:
+> 1. Consult `templates/icons/icons_index.json` to verify icon existence
+> 2. Icon names are single names (e.g., `factory`), no path prefixes
+> 3. Using names not in the index is FORBIDDEN
+> 4. List the final icon inventory in the Design Spec; Executor may only use icons from this list
+>
+> **Quick lookup**: By category → `icons_index.json` `categories`; by semantics → `quickLookup`; full list → `templates/icons/FULL_INDEX.md`
+
+### g. Typography Plan Confirmation (Font + Size)
+
+#### Font Presets
+
+| Scenario | Preset | Title | Body | Emphasis |
+|----------|--------|-------|------|----------|
+| Modern business, tech | P1 | Microsoft YaHei / Arial | Microsoft YaHei / Calibri | SimHei |
+| Government documents, reports | P2 | SimHei | SimSun / Times | SimSun |
+| Culture, arts, humanities | P3 | KaiTi / Georgia | Microsoft YaHei | SimHei |
+| Traditional, conservative | P4 | SimSun | Microsoft YaHei / Arial | SimSun |
+| English-primary | P5 | Arial / Impact | Calibri / Georgia | Arial Black |
+
+#### Font Size Baseline (all sizes in px)
+
+Selection principle: Font size is based on **content density**, not design style.
+
+| Content Density | Points per Page | Body Baseline | Suitable Scenarios |
+|----------------|----------------|---------------|-------------------|
+| Relaxed | 3-5 items | 24px | Keynote-style, training materials |
+| Dense | 6+ items | 18px | Data reports, consulting analysis |
+
+| Level | Ratio | 24px Baseline | 18px Baseline |
+|-------|-------|---------------|---------------|
+| Cover title | 2.5-3x | 60-72px | 45-54px |
+| Page title | 1.5-2x | 36-48px | 27-36px |
+| **Body** | **1x** | **24px** | **18px** |
+| Annotation | 0.75x | 18px | 14px |
+
+### h. Image Usage Confirmation
+
+| Option | Approach | Suitable Scenarios |
+|--------|----------|-------------------|
+| **A** | No images | Data reports, process documentation |
+| **B** | User-provided | Has existing image assets |
+| **C** | AI-generated | Custom illustrations, backgrounds needed |
+| **D** | Placeholders | Images to be added later |
+
+**When selection includes B**, you must run `python3 scripts/analyze_images.py <project_path>/images` before outputting the spec, and integrate scan results into the image resource list.
+
+**When B/C/D is selected**, add an image resource list to the spec:
+
+| Column | Description |
+|--------|-------------|
+| Filename | e.g., `cover_bg.png` |
+| Dimensions | e.g., `1280x720` |
+| Ratio | e.g., `1.78` |
+| Layout suggestion | e.g., `Wide landscape (suitable for full-screen/illustration)` |
+| Purpose | e.g., `Cover background` |
+| Type | Background / Photography / Illustration / Diagram / Decorative pattern |
+| Status | Pending generation / Existing / Placeholder |
+| Generation description | Fill in detailed description for AI generation |
+
+**Image type descriptions**:
+
+| Type | Suitable Scenarios |
+|------|-------------------|
+| Background | Full-page backgrounds for covers/chapter pages; reserve text area |
+| Photography | Real scenes, people, products, architecture |
+| Illustration | Flat design, vector style, concept diagrams |
+| Diagram | Flowcharts, architecture diagrams, concept relationship maps |
+| Decorative pattern | Partial decoration, textures, borders, divider elements |
+
+**Image-layout alignment principles** (detailed calculation rules in `references/image-layout-spec.md`):
+
+| Image Ratio | Recommended Layout |
+|-------------|-------------------|
+| > 2.0 (ultra-wide) | Top-bottom split, top full-width |
+| 1.5-2.0 (wide) | Top-bottom split |
+| 1.2-1.5 (standard landscape) | Left-right split |
+| 0.8-1.2 (square) | Left-right split |
+| < 0.8 (portrait) | Left-right split, image on left |
+
+Core logic: The layout container's aspect ratio must closely match the image's original ratio. Never force a wide image into a square container or a portrait image into a narrow horizontal strip.
+
+> **Pipeline handoff**: When C) AI generation is selected, after outputting the design spec, prompt the user to invoke Image_Generator. Once images are collected in `images/`, proceed to Executor.
+
+### Chart Reference (Non-blocking — Strategist recommends, no user confirmation needed)
+
+When content outline pages involve **data visualization** (comparisons, trends, proportions, KPIs, flows, strategic frameworks, etc.), consult the chart template library to select appropriate chart types.
+
+Built-in library contains 33 chart templates; see `templates/charts/charts_index.json`.
+
+> **Selection workflow**:
+> 1. Identify pages that need data visualization during content planning
+> 2. Consult `charts_index.json` — by analysis goal → `quickLookup`; by category → `categories`
+> 3. Review `bestFor` / `avoidFor` to confirm the chart type fits the data characteristics
+> 4. List all selected charts in Design Spec **section VII (Chart Reference List)** as a centralized reference; in section IX Content Outline, each page only needs to note the chart type name
+>
+> **Quick lookup by goal**:
+> - Ranking/comparison → `bar_chart`, `horizontal_bar_chart`, `grouped_bar_chart`
+> - Trends over time → `line_chart`, `area_chart`, `dual_axis_line_chart`
+> - Proportions → `donut_chart`, `pie_chart`, `treemap_chart`
+> - KPIs/targets → `kpi_cards`, `bullet_chart`, `gauge_chart`
+> - Conversion/flow → `funnel_chart`, `sankey_chart`, `waterfall_chart`
+> - Strategy → `swot_analysis`, `porter_five_forces`, `matrix_2x2`
+
+### Speaker Notes Requirements (Default — no discussion needed)
+
+- File naming: Recommended to match SVG names (`01_cover.svg` → `notes/01_cover.md`), also compatible with `notes/slide01.md`
+- Fill in the Design Spec: total presentation duration, notes style (formal / conversational / interactive), presentation purpose (inform / persuade / inspire / instruct / report)
+- Split note files must NOT contain `#` heading lines (`notes/total.md` master document MUST use `#` heading lines)
+
+---
+
+## 2. Executor Style Details (Reference for Confirmation Item #4)
+
+### A) General Versatile — Executor_General
+
+**Unique capabilities**:
+- Full-width images + gradient overlays (essential for promotions)
+- Free creative layouts (not grid-constrained)
+- Three style variants: image-text hybrid, minimalist keynote, creative design
+
+**Typical scenarios**: Investment promotion, product launches, training materials, brand campaigns
+
+**Avoid**: Overly rigid/formal, dense data tables
+
+### B) General Consulting — Executor_Consultant
+
+**Unique capabilities**:
+- KPI dashboards (4-card layout, large numbers + trend arrows)
+- Professional chart combinations (bar, line, pie, funnel)
+- Data color grading (red/yellow/green status indicators)
+
+**Typical scenarios**: Progress reports, financial analysis, government reports, proposals/bids
+
+**Avoid**: Flashy decorations, image-dominated slides
+
+### C) Top Consulting — Executor_Consultant_Top
+
+**Unique capabilities**:
+
+| Capability | Description |
+|-----------|-------------|
+| Data contextualization | Every data point must have a comparison ("grew 63% — industry average only 12%") |
+| SCQA framework | Situation → Complication → Question → Answer |
+| Pyramid principle | Conclusion first; core insight in the title position |
+| Strategic coloring | Colors serve information, not decoration |
+| Chart vs Table | Trends → charts; precise values → tables |
+
+**Unique page elements**: Gradient top bar + dark takeaway box, confidential marking + rigorous footer, MECE decomposition / driver tree / waterfall chart
+
+**Typical scenarios**: Strategic decision reports, deep analysis reports, consulting deliverables (MBB level)
+
+**Avoid**: Isolated data, subjective statements, decorative elements
+
+---
+
+## 3. Color Knowledge Base
+
+### Consulting Style Colors (Professional Authority)
+
+| Brand / Style | HEX | Psychological Feel |
+|---------------|-----|-------------------|
+| Deloitte Blue | `#0076A8` | Professional, reliable |
+| McKinsey Blue | `#005587` | Authoritative, deep |
+| BCG Dark Blue | `#003F6C` | Stable, trustworthy |
+| PwC Orange | `#D04A02` | Energetic, innovative |
+| EY Yellow | `#FFE600` | Optimistic, clear |
+
+### General Versatile Colors (Modern Energy)
+
+| Style | HEX | Suitable Scenarios |
+|-------|-----|-------------------|
+| Tech Blue | `#2196F3` | Technology, internet |
+| Vibrant Orange | `#FF9800` | Marketing, promotion |
+| Growth Green | `#4CAF50` | Health, environmental, growth |
+| Professional Purple | `#9C27B0` | Creative, premium |
+| Alert Red | `#F44336` | Urgent, important |
+
+### Data Visualization Colors
+
+- Positive trend (green): `#2E7D32` → `#4CAF50` → `#81C784`
+- Warning trend (yellow): `#F57C00` → `#FFA726` → `#FFD54F`
+- Negative trend (red): `#C62828` → `#EF5350` → `#E57373`
+
+---
+
+## 4. Layout Pattern Quick Reference
+
+| Layout | Suitable Scenarios | PPT 16:9 Reference Dimensions |
+|--------|-------------------|-------------------------------|
+| Single column centered | Covers, conclusions, key points | Content width 800-1000px, horizontally centered |
+| Two-column | Comparative analysis, left-image right-text | Column ratio 1:1 or 3:2, gap 40-60px |
+| Three-column | Parallel points, process steps | Column ratio 1:1:1, gap 30-40px |
+| Four-quadrant | Matrix analysis, classification | Quadrant 560x250px, gap 20-30px |
+| Top-bottom split | Ultra-wide images + text | Image full-width, text area >= 150px height |
+| Left-right split | Standard/portrait images + text | Image on side, text area >= 280px width |
+
+**PPT 16:9 (1280x720) key dimensions**: Safe area 1200x640 (40px margins); Title area 1200x100; Content area 1200x500; Footer area 1200x40.
+
+---
+
+## 5. Template Flexibility Principle
+
+> Templates are starting points, not endpoints.
+
+The Strategist should make professional judgments on the template basis generated by `scripts/project_manager.py`, considering user needs, content characteristics, and audience:
+
+1. Ratio systems are adjustable (font size ratios are reference values)
+2. Color schemes are customizable (based on brand and content)
+3. Layout modes can be combined (6 base layouts with free variation)
+4. Content structure is extensible (12-chapter framework can be expanded or reduced)
+5. Spacing / border radius details adjusted by Executor based on content density
+
+---
+
+## 6. Workflow & Deliverables
+
+### 6.1 Content Planning Strategy
+
+| Style | Content Outline | Design Spec | Speaker Notes |
+|-------|----------------|-------------|---------------|
+| A) General Versatile | Intelligently deconstruct source doc; define core theme per page | Visual theme, color scheme, layout principles | Concise presentation script |
+| B) General Consulting | Structured logical sections; data-driven insights | Consulting-style colors, structured content layout | Professional terms, data interpretation, conclusion-first |
+| C) Top Consulting | SCQA framework, pyramid principle conclusion-first | Data contextualization, strategic color usage | Highly condensed, logically rigorous, conclusion-driven |
+
+### 6.2 Outline Output Specification (Must include 12 chapters)
+
+| Chapter | Content Requirements |
+|---------|---------------------|
+| I. Project Information | Project name, canvas format, page count, style, audience, scenario, date |
+| II. Canvas Specification | Format, dimensions, viewBox, margins, content area |
+| III. Visual Theme | Style description, light/dark theme, tone, color scheme (with HEX table), gradient scheme |
+| IV. Typography System | Font plan (P1-P5), font size hierarchy (H1-Code, 7 levels) |
+| V. Layout Principles | Page structure (header/content/footer zones), 6 layout modes, spacing spec |
+| VI. Icon Usage Spec | Source description, placeholder syntax, recommended icon list |
+| VII. Chart Reference List | Chart type, reference template path, used-in pages, purpose |
+| VIII. Image Resource List | Filename, dimensions, ratio, purpose, status, generation description |
+| IX. Content Outline | Grouped by chapter; each page includes layout, title, content points, chart type (if applicable) |
+| X. Speaker Notes Requirements | File naming rules, content structure description |
+| XI. Technical Constraints Reminder | SVG generation rules, PPT compatibility rules |
+| XII. Design Checklist | Pre-generation / post-generation check items |
+| XIII. Next Steps | Clarify subsequent pipeline (Image_Generator or Executor) |
+
+**Generation steps**:
+1. Read reference template: `templates/design_spec_reference.md`
+2. Generate complete spec from scratch based on analysis
+3. Save to: `projects/<project_name>.../design_spec.md`
+
+---
+
+## 7. Project Folder
+
+The project folder should be created before entering the Strategist role. If not yet created, execute:
+
+```bash
+python3 scripts/project_manager.py init <project_name> --format <canvas_format>
+```
+
+The Strategist saves the Design Specification & Content Outline to `projects/<project_name>_<format>_<YYYYMMDD>/design_spec.md`.
+
+---
+
+## 8. Complete Design Spec and Prompt Next Steps
+
+Prompt the next step based on the confirmed template option and image usage selection.
+
+### Template Option A (Using existing template)
+
+```
+✅ Design spec complete. Template ready.
+Next step:
+- Images include AI generation → Invoke Image_Generator
+- Images do not include AI generation → Invoke Executor
+```
+
+### Template Option B (No template)
+
+```
+✅ Design spec complete.
+Next step:
+- Images include AI generation → Invoke Image_Generator
+- Images do not include AI generation → Invoke Executor (free design for every page)
+```

package/skills/ppt-master/references/svg-image-embedding.md

@@ -0,0 +1,177 @@
+> See shared-standards.md for common technical constraints.
+
+# SVG Image Embedding Guide
+
+Technical specifications and recommended workflow for adding images to SVG files.
+
+---
+
+## Image Resource List Format
+
+Defined in the Design Specification & Content Outline; each image has a status annotation. If the image approach includes "B) User-provided", you must run `analyze_images.py` immediately after the Strategist completes the Eight Confirmations, and complete the list before outputting the design spec.
+
+```markdown
+| Filename | Dimensions | Purpose | Status | Generation Description |
+|----------|-----------|---------|--------|----------------------|
+| cover_bg.png | 1280x720 | Cover background | Pending | Modern tech abstract background, deep blue gradient |
+| product.png | 600x400 | Page 3 | Existing | - |
+| team.png | 600x400 | Page 5 | Placeholder | Team collaboration scene (to be added later) |
+```
+
+### Three Status Types
+
+| Status | Meaning | Executor Handling |
+|--------|---------|-------------------|
+| **Pending** | Needs AI generation, has description | Generate image first into `images/`, then reference with `<image>` |
+| **Existing** | User already has image | Place in `images/`, reference with `<image>` |
+| **Placeholder** | Not yet processed | Use dashed border placeholder; replace later |
+
+---
+
+## Workflow
+
+```
+1. Strategist defines image needs → Add image resource list, annotate each status
+2. Image preparation (pending/existing) → Place in project/images/
+3. Executor generates SVGs (svg_output/)
+   ├── Existing/Pending → <image href="../images/xxx.png" .../>
+   └── Placeholder → Dashed border + description text
+4. Preview: python3 -m http.server -d <project_path> 8000 → /svg_output/<filename>.svg
+5. Post-processing & Export
+   ├── python3 scripts/finalize_svg.py <project_path>
+   └── python3 scripts/svg_to_pptx.py <project_path> -s final
+```
+
+> Recommended: During generation, keep external references in `svg_output/`. Post-processing via `finalize_svg.py` auto-embeds images into `svg_final/`, then export PPTX from `svg_final/`.
+
+---
+
+## External Reference vs Base64 Embedding
+
+| Method | Pros | Cons | Suitable For |
+|--------|------|------|-------------|
+| **External reference** | Small file size, fast iteration, easy to replace | Preview requires HTTP server from project root | `svg_output/` development phase |
+| **Base64 embedding** | Self-contained file, stable export | Large file size | `svg_final/` delivery phase |
+
+---
+
+## Method 1: External Reference (Recommended for Generation Phase)
+
+### Syntax
+
+```xml
+<image href="../images/image.png" x="0" y="0" width="1280" height="720"
+       preserveAspectRatio="xMidYMid slice"/>
+```
+
+### Key Attributes
+
+| Attribute | Description | Example |
+|-----------|-------------|---------|
+| `href` | Image path (relative or absolute) | `"../images/cover.png"` |
+| `x`, `y` | Image top-left corner position | `x="0" y="0"` |
+| `width`, `height` | Image display dimensions | `width="1280" height="720"` |
+| `preserveAspectRatio` | Scaling mode | `"xMidYMid slice"` |
+
+### preserveAspectRatio Common Values
+
+| Value | Effect |
+|-------|--------|
+| `xMidYMid slice` | Center crop (similar to CSS `cover`) |
+| `xMidYMid meet` | Complete display (similar to CSS `contain`) |
+| `none` | Stretch to fill, no aspect ratio preservation |
+
+### Preview Method
+
+Browser security restrictions prevent loading external images from directly opened SVGs. Start an HTTP server from the project root:
+
+```bash
+python3 -m http.server -d <project_path> 8000
+# Visit http://localhost:8000/svg_output/your_file.svg
+```
+
+---
+
+## Method 2: Base64 Embedding (Recommended for Delivery Phase)
+
+### Syntax
+
+```xml
+<image href="data:image/png;base64,iVBORw0KGgo..." x="0" y="0" width="1280" height="720"/>
+```
+
+### MIME Types
+
+| MIME Type | File Format |
+|-----------|-------------|
+| `image/png` | PNG |
+| `image/jpeg` | JPG/JPEG |
+| `image/gif` | GIF |
+| `image/webp` | WebP |
+| `image/svg+xml` | SVG |
+
+---
+
+## Conversion Process
+
+### Recommended: Use finalize_svg.py (Unified Pipeline)
+
+```bash
+python3 scripts/finalize_svg.py <project_path>         # Icons, images, text, rounded rects — all in one pass
+python3 scripts/svg_to_pptx.py <project_path> -s final  # Export PPTX from final version
+```
+
+### Standalone: embed_images.py (Advanced Usage)
+
+For processing specific SVGs without running the full pipeline:
+
+```bash
+python3 scripts/svg_finalize/embed_images.py <svg_file>                         # Single file
+python3 scripts/svg_finalize/embed_images.py <project_path>/svg_output/*.svg    # Batch
+python3 scripts/svg_finalize/embed_images.py --dry-run <project_path>/svg_output/*.svg  # Preview
+```
+
+---
+
+## Best Practices
+
+### Image Optimization
+
+Compress images before embedding to reduce file size:
+
+```bash
+convert input.png -quality 85 -resize 1920x1080\> output.png  # ImageMagick
+pngquant --quality=65-80 input.png -o output.png               # pngquant (recommended)
+```
+
+### File Organization
+
+```
+project/
+├── images/            # Image assets
+├── sources/           # Source files and their accompanying images
+│   └── article_files/
+├── svg_output/        # Raw version (external references)
+└── svg_final/         # Final version (images embedded)
+```
+
+### Rounded Corner Handling (clipPath Forbidden)
+
+Since `clipPath` is incompatible with PPT, clipping paths for image rounded corners are FORBIDDEN. Alternatives:
+- Process rounded corners during image generation (export PNG with rounded corners)
+- Or overlay a same-size rounded rectangle over the edges (visual simulation)
+
+---
+
+## FAQ
+
+**Q: Can't see images when opening SVG directly?**
+Browser security policy blocks cross-directory requests. Start an HTTP server from the project root, or run `finalize_svg.py` first then view from `svg_final/`.
+
+**Q: Base64 file too large?**
+Compress the original image, use JPEG format, reduce resolution (match actual display dimensions).
+
+**Q: How to reverse-extract a Base64 image?**
+```bash
+base64 -d image.b64 > image.png
+```