codewave-openclaw-installer 1.0.2 → 2.1.1

package/skills/ppt-master/references/executor-general.md

@@ -0,0 +1,122 @@
+# Executor General — Creative Versatile Style
+
+> Common guidelines: executor-base.md. Technical constraints: shared-standards.md.
+
+---
+
+## Role Definition
+
+A creative, versatile-style SVG design executor. Suitable for product introductions, training materials, proposal presentations, marketing campaigns, and other **non-consulting** scenarios. Emphasizes visual impact and information engagement, striking a balance between professionalism and approachability.
+
+---
+
+## General-specific Layout Techniques
+
+### 1. Flexible and Varied Layouts
+
+The General style is not confined to fixed templates; layouts can be freely chosen based on content:
+
+| Layout | Use Case | Layout Details (1280x720) |
+|--------|----------|--------------------------|
+| Full-image background + text overlay | Covers, emotional pages | `<image>` fills canvas + semi-transparent overlay + centered title |
+| Left-right split (image-text mix) | Feature introductions, comparisons | Left x=40,w=580 / Right x=660,w=580 |
+| Three-column cards | Feature lists, team introductions | x=40,450,860 each w=380, equal-height cards |
+| Top-bottom split | Timelines, process flows | Top area: title+description h=250 / Bottom area: charts+content h=420 |
+| Center-radiating | Core concepts, ecosystem diagrams | Center element + 4-6 surrounding nodes, lines pointing to center |
+| Waterfall / Z-pattern | Storytelling, case studies | Content blocks alternate left-right, guiding the eye in a Z-pattern |
+
+### 2. Visual Rhythm Control
+
+- **Information density alternation**: Follow a data-heavy page with a "breathing page" (large image / quote / transition) to prevent audience fatigue
+- **Visual weight balance**: Dark/large-area elements are "heavy", light/small elements are "light" — balance left-right/top-bottom
+- **Repetition and variation**: Maintain layout consistency within a chapter; vary between chapters to maintain freshness
+
+### 3. Decorative Element Usage
+
+| Element | Usage | Notes |
+|---------|-------|-------|
+| Gradient blocks | Background zones, title backing | Use `<linearGradient>` / `<radialGradient>`, limit to 2-3 colors |
+| Rounded rectangle cards | Content containers, feature modules | `rx="12"` with light shadow (simulate with lighter rect) |
+| Icon accents | List item prefixes, feature markers | Use `data-icon` placeholders, size 32-48px |
+| Numbered circles | Step flows, ranked lists | `<circle>` + centered `<text>`, theme color fill |
+| Divider lines | Content separation | `<line>` or `<rect height="2">`, opacity 0.2-0.3 |
+
+---
+
+## Visual Strategy
+
+### Color Usage
+
+- **Bold use of theme color**: Covers and chapter pages can use large areas of theme color background
+- **Gradients enhance depth**: Title bars and card backgrounds can use same-hue gradients
+- **Contrast creates focus**: Key numbers/words use accent color, creating contrast with surroundings
+- **Color-mood matching**: Cool tones for tech feel, warm tones for energy, dark tones for gravitas
+
+### Image Handling Strategy
+
+| Scenario | Strategy | SVG Implementation |
+|----------|----------|-------------------|
+| Full-screen background | Image fills + dark gradient overlay | `preserveAspectRatio="xMidYMid slice"` + gradient rect |
+| Portrait image display | Place left/right, maintain original ratio | Control width, height adapts |
+| Multi-image grid | Grid arrangement, uniform sizing | Equal-width equal-height `<image>` matrix |
+| Person photo | Circular crop effect | `<circle>` background + square image overlay (post-processing crops) |
+
+### Typography Hierarchy
+
+```
+Title layer   → 28-36px, bold, theme color or white
+Subtitle layer → 20-24px, medium weight, secondary color
+Body layer    → 16-18px, regular, dark gray
+Annotation layer → 12-14px, light gray, bottom-aligned
+```
+
+---
+
+## Speaker Notes Style
+
+### Narrative Tone
+
+General style speaker notes use **conversational narration** — like talking with the audience, not reading a report. Natural tone with rhythm, using rhetorical devices where appropriate.
+
+### Stage Direction Markers
+
+| Marker | Purpose | Example |
+|--------|---------|---------|
+| `[Pause]` | Silence after key reveal, letting the audience absorb | "What does this number mean? [Pause] It means 1 in every 3 users..." |
+| `[Interactive]` | Ask questions or guide audience participation | "[Interactive] How many of you have used this feature?" |
+| `[Transition]` | Bridge from previous page, must be at start of each page's text | "[Transition] Now that we understand the context, let's see how it works." |
+
+### Notes Writing Guidelines
+
+- **Tell stories**: Use "scenario-conflict-resolution" structure for each page's narrative
+- **Use metaphors**: Make abstract concepts tangible ("It's like adding a turbocharger to the system")
+- **Create suspense**: Pose questions at the right time, answer on the next page
+- **Conversational data**: 30% → "nearly one-third", 2.5x → "more than doubled"
+- **Key points structure**: `Key points: (1) Core message (2) Supporting evidence (3) Call to action`
+
+### Notes Example
+
+```markdown
+# 03_key_advantages
+
+[Transition] Having covered the market landscape, you might be wondering: where is our opportunity?
+
+Our core advantages can be summed up in three words: Fast, Accurate, Efficient.
+Fast — deployment time cut from 3 months to 2 weeks; [Pause]
+Accurate — recognition accuracy at 97.3%, far exceeding the industry average of 82%;
+Efficient — overall costs reduced by nearly one-third.
+
+[Interactive] If you were the decision-maker, which of these three numbers would impress you most?
+
+Key points: (1) Three differentiating advantages (2) Quantitative data support (3) Prompt for reflection
+Duration: 2 minutes
+```
+
+---
+
+## Self-check Supplement (General-specific)
+
+- [ ] Visual rhythm is reasonable: data-dense pages alternate with breathing pages
+- [ ] Decorative elements are moderate: serving content, not overshadowing it
+- [ ] Image-text ratio is appropriate: not just text walls, visual highlights present
+- [ ] Notes are conversational: reads like speaking, not reading a script

package/skills/ppt-master/references/image-generator.md

@@ -0,0 +1,444 @@
+# Image_Generator Reference Manual
+
+> This file is the streamlined reference for the Image_Generator role. Common standards (SVG technical constraints, canvas formats, post-processing pipeline, etc.) are in [shared-standards.md](./shared-standards.md).
+
+## Core Mission
+
+Receive the "Image Resource List" from the Design Specification & Content Outline output by the Strategist, create optimized prompts for each image pending generation, generate images via AI tools, and save them to the project's `images/` directory.
+
+**Trigger condition**: When AI image generation is needed (standalone use or invoked within pipeline)
+
+| Mode | Trigger | Description |
+|------|---------|-------------|
+| **Standalone** | Directly describe image needs | Generate single or multiple AI images |
+| **In-pipeline** | `generate-ppt` with AI image generation selected | Batch-generate image assets for a project |
+
+> Next step in pipeline: Executor generates SVGs
+
+---
+
+## 1. Input & Output
+
+### Input
+
+- **Design Specification & Content Outline** (from Strategist): project theme, target audience, design style, color scheme, canvas format
+- **Image Resource List** (key input):
+
+  | Filename | Dimensions | Purpose | Type | Status | Generation Description |
+  |----------|-----------|---------|------|--------|----------------------|
+  | cover_bg.png | 1920x1080 | Cover background | Background | Pending | Modern tech abstract background, deep blue gradient |
+
+### Output
+
+| Deliverable | Path / Description | Requirements |
+|------------|-------------------|--------------|
+| Prompt document | `project/images/image_prompts.md` | **Must** be saved using file write tool — cannot just be output in conversation |
+| Optimized prompts | Individual prompt per image | Directly usable with AI image generation tools; doubles as alt text |
+| Image files | `project/images/` directory | Named per the resource list filenames |
+| Updated list | Status changes | "Pending" → "Generated" |
+
+---
+
+## 2. Unified Prompt Structure
+
+### 2.1 Standard Output Format
+
+Every image must be output in the following format:
+
+```markdown
+### Image N: {filename}
+
+| Attribute | Value |
+| --------- | ----- |
+| Purpose   | {which page / what function} |
+| Type      | {Background / Illustration / Photography / Diagram / Decorative} |
+| Dimensions | {width}x{height} ({aspect ratio}) |
+| Original description | {description provided by user in the list} |
+
+**Prompt**:
+{subject description}, {style directive}, {color directive}, {composition directive}, {quality directive}
+
+**Negative Prompt**:
+{elements to exclude}
+
+**Alt Text**:
+> {Description for accessibility and image captions}
+```
+
+### 2.2 Prompt Components
+
+| Component | Description | Example |
+|-----------|-------------|---------|
+| Subject description | Core content | `Abstract geometric shapes`, `Team collaboration scene` |
+| Style directive | Visual style | `flat design`, `3D isometric`, `watercolor style` |
+| Color directive | Color scheme | `color palette: navy blue (#1E3A5F), gold (#D4AF37)` |
+| Composition directive | Layout ratio | `16:9 aspect ratio`, `centered composition` |
+| Quality directive | Resolution quality | `high quality`, `4K resolution`, `sharp details` |
+| Negative prompt | Exclude elements | `text, watermark, blurry, low quality` |
+
+### 2.3 Style Keywords Quick Reference
+
+| Design Style | Recommended Image Style | Core Keywords |
+|-------------|------------------------|---------------|
+| General Versatile | Modern illustration, flat design | `modern`, `flat design`, `gradient`, `vibrant colors` |
+| General Consulting | Clean professional, corporate | `professional`, `clean`, `corporate`, `minimalist` |
+| Top Consulting | Premium minimal, abstract geometric | `premium`, `sophisticated`, `geometric`, `abstract`, `elegant` |
+
+### 2.4 Color Integration Method
+
+Extract colors from design spec, convert to prompt directives:
+
+```
+Primary: #1E3A5F (Deep Navy)  →  "deep navy blue (#1E3A5F)"
+Secondary: #F8F9FA (Light Gray) →  "light gray (#F8F9FA)"
+Accent: #D4AF37 (Gold)        →  "gold accent (#D4AF37)"
+
+Full directive: "color palette: deep navy blue (#1E3A5F), light gray (#F8F9FA), gold accent (#D4AF37)"
+```
+
+### 2.5 Canvas Format & Aspect Ratio
+
+| Canvas Format | Background Aspect Ratio | Recommended Resolution |
+|--------------|------------------------|----------------------|
+| PPT 16:9 | 16:9 | 1920x1080 or 2560x1440 |
+| PPT 4:3 | 4:3 | 1600x1200 |
+| Xiaohongshu (RED) | 3:4 | 1242x1660 |
+| WeChat Moments | 1:1 | 1080x1080 |
+| Story | 9:16 | 1080x1920 |
+
+> Supported aspect ratios: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` (Gemini also supports `1:4`, `1:8`, `4:1`, `8:1`)
+
+---
+
+## 3. Image Type Classification & Handling
+
+### Type Determination Flow
+
+1. Full-page / large-area backdrop → **Background** (3.1)
+2. Real scenes / people / products → **Photography** (3.2)
+3. Flat / illustration / cartoon style → **Illustration** (3.3)
+4. Process / architecture / relationships → **Diagram** (3.4)
+5. Partial decoration / texture → **Decorative Pattern** (3.5)
+
+### 3.1 Background
+
+**Identifying characteristics**: Full-page background for covers or chapter pages; must support text overlay
+
+| Key Point | Description |
+|-----------|-------------|
+| Emphasize background nature | Add `background`, `backdrop` |
+| Reserve text area | `negative space in center for text overlay` |
+| Avoid strong subjects | Use abstract, gradient, geometric elements |
+| Low-contrast details | `subtle`, `soft`, `muted` |
+
+**Template**: `Abstract {theme element} background, {style} style, {primary color} to {secondary color} gradient, subtle {decorative elements}, clean negative space in center for text overlay, {aspect ratio} aspect ratio, high resolution, professional presentation background`
+
+**Negative prompt**: `text, letters, watermark, faces, busy patterns, high contrast details`
+
+### 3.2 Photography
+
+**Identifying characteristics**: Real scenes, people, products, architecture — photographic quality
+
+| Key Point | Description |
+|-----------|-------------|
+| Emphasize realism | `photography`, `photorealistic`, `real photo` |
+| Lighting effects | `natural lighting`, `soft shadows`, `studio lighting` |
+| Background handling | `white background` / `blurred background` / `contextual setting` |
+| People diversity | `diverse`, `professional attire` |
+
+**Template**: `{subject description}, professional photography, {lighting type} lighting, {background type} background, color grading matching {color scheme}, high quality, sharp focus, 8K resolution`
+
+**Negative prompt**: `watermark, text overlay, artificial, CGI, illustration, cartoon, distorted faces`
+
+### 3.3 Illustration
+
+**Identifying characteristics**: Flat design, vector style, cartoon, concept diagrams
+
+| Key Point | Description |
+|-----------|-------------|
+| Specify style | `flat design`, `isometric`, `vector style`, `hand-drawn` |
+| Simplify details | `simplified`, `clean lines`, `minimal details` |
+| Unified palette | Strictly use design spec colors |
+| Background choice | `white background` or `transparent background` |
+
+**Template**: `{subject description}, {illustration style} illustration style, {detail level} with clean lines, color palette: {color list}, {background type} background, professional {purpose} illustration`
+
+**Negative prompt**: `realistic, photography, 3D render, complex textures, watermark`
+
+### 3.4 Diagram
+
+**Identifying characteristics**: Flowcharts, architecture diagrams, concept relationship maps, data visualizations
+
+| Key Point | Description |
+|-----------|-------------|
+| Clear structure | `clear structure`, `organized layout`, `logical flow` |
+| Connection representation | `arrows indicating flow`, `connecting lines` |
+| Academic / professional feel | `suitable for academic publication`, `professional diagram` |
+| Light background | `white background` or `light gray background` |
+
+**Template**: `{diagram type} diagram showing {content description}, {component description} connected by {connection method}, {style} style with {color scheme}, white background, clear labels, professional technical diagram`
+
+**Negative prompt**: `cluttered, messy, overlapping elements, dark background, realistic, photography`
+
+### 3.5 Decorative Pattern
+
+**Identifying characteristics**: Partial decoration, textures, borders, divider elements
+
+| Key Point | Description |
+|-----------|-------------|
+| Repeatability | `seamless`, `tileable`, `repeatable` (if needed) |
+| Understated support | `subtle`, `understated`, `supporting element` |
+| Transparency-friendly | `transparent background` or `isolated element` |
+| Small-size readability | Consider legibility at small dimensions |
+
+**Template**: `{pattern type} decorative pattern, {style} style, {color scheme}, {background type} background, subtle and elegant, suitable for {purpose}`
+
+**Negative prompt**: `busy, cluttered, high contrast, distracting, photorealistic`
+
+---
+
+## 4. Image Generation Workflow
+
+### 4.1 Analysis Phase
+
+1. Read the design spec; understand overall project style
+2. Extract color scheme, canvas format, target audience
+3. Analyze each image in the resource list individually
+4. Determine each image's type (refer to Section 3)
+
+### 4.2 Prompt Generation Phase
+
+For each image with "Pending" status:
+
+1. **Determine type** → Background / Photography / Illustration / Diagram / Decorative
+2. **Understand purpose** → Which page? What function?
+3. **Analyze original description** → Information from the user's "Generation description"
+4. **Apply type-specific key points** → Reference the corresponding type's table
+5. **Generate optimized prompt** → Use the 2.1 standard output format
+6. **Save prompt document** → **Must** write to `project/images/image_prompts.md`
+
+### 4.3 Image Generation Phase
+
+> Prerequisite: Section 4.2 must be complete; `images/image_prompts.md` must exist
+
+#### Method 1: Unified CLI Tool (Recommended)
+
+```bash
+python3 scripts/image_gen.py "your prompt" \
+  --aspect_ratio 16:9 --image_size 1K \
+  --output project/images --filename cover_bg
+```
+
+**Parameters**:
+
+| Parameter | Short | Description | Default |
+|-----------|-------|-------------|---------|
+| `prompt` | - | Positive prompt (positional arg) | - |
+| `--negative_prompt` | `-n` | Negative prompt | None |
+| `--aspect_ratio` | - | Image aspect ratio | `1:1` |
+| `--image_size` | - | Size (`1K`/`2K`/`4K`) | `1K` |
+| `--output` | `-o` | Output directory | Current directory |
+| `--filename` | `-f` | Output filename (no extension) | Auto-named |
+| `--backend` | `-b` | Override backend (`gemini`/`openai`/`stability`/`bfl`/`ideogram`/`qwen`/`zhipu`/`volcengine`/`siliconflow`/`fal`/`replicate`) | None |
+| `--model` | `-m` | Model name | Backend default |
+| `--list-backends` | - | Print support tiers and exit | `false` |
+
+**Configuration sources**:
+- Current process environment variables
+- Project-root `.env` as fallback
+
+Precedence:
+- Current process environment wins
+- `.env` fills missing values only
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `IMAGE_BACKEND` | Required | `gemini` / `openai` / `stability` / `bfl` / `ideogram` / `qwen` / `zhipu` / `volcengine` / `siliconflow` / `fal` / `replicate` |
+| `{PROVIDER}_API_KEY` | Required | Provider-specific API key, e.g. `GEMINI_API_KEY`, `ZHIPU_API_KEY` |
+| `{PROVIDER}_BASE_URL` | Optional | Provider-specific custom endpoint |
+| `{PROVIDER}_MODEL` | Optional | Provider-specific model override |
+
+> Use provider-specific names only: `GEMINI_API_KEY`, `OPENAI_API_KEY`, `STABILITY_API_KEY`, `BFL_API_KEY`, `IDEOGRAM_API_KEY`, `QWEN_API_KEY` / `DASHSCOPE_API_KEY`, `ZHIPU_API_KEY` / `BIGMODEL_API_KEY`, `VOLCENGINE_API_KEY` / `ARK_API_KEY`, `SILICONFLOW_API_KEY`, `FAL_KEY`, and `REPLICATE_API_TOKEN`.
+
+> `IMAGE_API_KEY`, `IMAGE_MODEL`, and `IMAGE_BASE_URL` are intentionally unsupported.
+
+> If `.env` or the current environment contains multiple provider configs, `IMAGE_BACKEND` explicitly selects the active one.
+
+**Support tiers (recommended usage)**:
+- Core: `gemini`, `openai`, `qwen`, `zhipu`, `volcengine`
+- Extended: `stability`, `bfl`, `ideogram`
+- Experimental: `siliconflow`, `fal`, `replicate`
+
+**Generation pacing (mandatory)**:
+- Execute only one generation command at a time; wait for file confirmation before the next
+- Recommend 2-5 second intervals between images to avoid concurrency failures
+- If failure/no output occurs, halt the queue, check `IMAGE_BACKEND`, provider-specific credentials, and the output directory, then resume
+
+#### Method 2: Auto-generation
+
+Directly call image generation API, download and save to `project/images/` directory.
+
+#### Method 3: Gemini Web Interface
+
+1. Generate images in [Gemini](https://gemini.google.com/)
+2. Select **Download full size** for high-resolution version
+3. Remove watermark: `python3 scripts/gemini_watermark_remover.py <image_path>`
+4. Place processed images in `project/images/` directory
+
+#### Method 4: Manual Generation (Other AI Platforms)
+
+Prompts are saved in `images/image_prompts.md`; inform the user of the file location. User generates on Midjourney, DALL-E, Stable Diffusion, etc. and places images in `project/images/` directory.
+
+### 4.4 Verification Phase
+
+- Confirm all images are saved to `images/` directory
+- Check filenames match the resource list
+- Update image resource list status to "Generated"
+
+---
+
+## 5. Prompt Document Template
+
+Use the following structure when creating `project/images/image_prompts.md`:
+
+```markdown
+# Image Generation Prompts
+
+> Project: {project_name}
+> Generated: {date}
+> Color scheme: Primary {#HEX} | Secondary {#HEX} | Accent {#HEX}
+
+---
+
+## Image List Overview
+
+| # | Filename | Type | Dimensions | Status |
+|---|----------|------|-----------|--------|
+| 1 | cover_bg.png | Background | 1920x1080 | Pending |
+
+---
+
+## Detailed Prompts
+
+### Image 1: cover_bg.png
+
+| Attribute | Value |
+|-----------|-------|
+| Purpose | Cover background |
+| Type | Background |
+| Dimensions | 1920x1080 (16:9) |
+| Original description | Modern tech abstract background, deep blue gradient |
+
+**Prompt**:
+Abstract futuristic background with flowing digital waves...
+
+**Alt Text**:
+> Modern tech abstract background with deep blue gradient, digital waves, and particle effects
+
+---
+
+## Usage Instructions
+
+1. Copy the "Prompt" above into an AI image generation tool
+2. Recommended platforms: Midjourney / DALL-E 3 / Gemini / Stable Diffusion
+3. Rename generated images to the corresponding filenames
+4. Place in the `images/` directory
+```
+
+---
+
+## 6. Negative Prompt Quick Reference
+
+### By Image Type
+
+| Type | Recommended Negative Prompt |
+|------|---------------------------|
+| Background | `text, letters, watermark, faces, busy patterns, high contrast details` |
+| Photography | `watermark, text overlay, artificial, CGI, illustration, cartoon, distorted faces` |
+| Illustration | `realistic, photography, 3D render, complex textures, watermark` |
+| Diagram | `cluttered, messy, overlapping elements, dark background, realistic` |
+| Decorative pattern | `busy, cluttered, high contrast, distracting, photorealistic` |
+
+### Universal Negative Prompts
+
+- **Standard**: `text, watermark, signature, blurry, distorted, low quality`
+- **Extended** (people scenarios): `text, watermark, signature, blurry, low quality, distorted, extra fingers, mutated hands, poorly drawn face, bad anatomy, extra limbs, disfigured, deformed`
+
+---
+
+## 7. Common Issues
+
+### Default Inference When No "Generation Description" Provided
+
+| Purpose | Default Inference |
+|---------|------------------|
+| Cover background | Abstract gradient background, reserve central text area |
+| Chapter page background | Clean geometric pattern, monochrome focus |
+| Team introduction page | Team collaboration scene illustration (flat style) |
+| Data display page | Clean geometric pattern or solid color background |
+| Product showcase | Product photography style, white or gradient background |
+
+### When Images Are Unsatisfactory
+
+Provide prompt variants for user selection: Variant A (more abstract), Variant B (more concrete), Variant C (different color tone).
+
+---
+
+## 8. Role Collaboration
+
+### Handoff with Strategist
+
+| Direction | Content |
+|-----------|---------|
+| Receives | Design Specification & Content Outline (with image resource list) |
+| Trigger condition | User selected "C) AI generation" in "Image usage" |
+| Key information | Color scheme, design style, canvas format |
+
+### Handoff with Executor
+
+| Direction | Content |
+|-----------|---------|
+| Delivers | All images placed in `project/images/` directory |
+| Executor reference | `<image href="../images/xxx.png" .../>` |
+| Path note | SVGs in `svg_output/`, images in `images/`; use relative path `../images/` |
+
+---
+
+## 9. Task Completion Checkpoint
+
+### Must-complete Items
+
+- [ ] Created prompt document `project/images/image_prompts.md`
+- [ ] Each image has: type determination + optimized prompt + negative prompt + Alt Text
+- [ ] Uses unified output format (2.1 standard format)
+- [ ] Phase completion confirmation output
+
+### Image Readiness (at least one must be satisfied)
+
+- [ ] All images saved to `project/images/` directory
+- [ ] Or: User clearly informed to self-generate using `image_prompts.md`
+
+### Pipeline Flow
+
+- [ ] User prompted to proceed to next step (switch to Executor role)
+
+> **Critical check**: If `images/image_prompts.md` was not created, or the output format does not comply with 2.1 standard, the task is NOT complete.
+
+### Completion Confirmation Output Format
+
+```markdown
+## Image_Generator Phase Complete
+
+- [x] Created prompt document `project/images/image_prompts.md`
+- [x] Generated optimized prompts for X images
+- [x] All images saved to `images/` directory
+- [x] Updated image resource list status
+
+**Image Status Summary**:
+
+| Filename | Type | Dimensions | Status |
+|----------|------|-----------|--------|
+| cover_bg.png | Background | 1920x1080 | Generated |
+
+**Next step**: Switch to Executor role to begin SVG generation
+```