@ia-ccun/code-agent-cli 0.0.50-beta.1 → 0.0.50-beta.2

package/README.md

@@ -217,22 +217,48 @@ aicode-cli --list-models   # 列出可用模型
 
 ### 创建自定义 Skill
 
-在 `~/.aicode-cli/skills/` 目录下创建 `.md` 文件：
+在 `~/.aicode-cli/agent/skills/<skill-name>/` 目录下创建 `SKILL.md` 文件：
+
+```bash
+# 创建技能目录
+mkdir -p ~/.aicode-cli/agent/skills/my-skill
+
+# 创建 SKILL.md
+cat > ~/.aicode-cli/agent/skills/my-skill/SKILL.md << 'EOF'
+---
+name: my-skill
+description: "技能的简短描述。Use when 触发条件描述。"
+metadata:
+  version: "1.0.0"
+  author: "your-name"
+---
 
-```markdown
 # My Skill
 
 ## 描述
-技能说明
+技能的详细说明
 
 ## 触发方式
-/skill:my-skill
+`/skill:my-skill`
 
 ## 执行步骤
 1. 步骤一
 2. 步骤二
+EOF
 ```
 
+**字段说明：**
+
+| 字段 | 必填 | 说明 |
+|------|------|------|
+| `name` | 是 | 技能标识符（小写+连字符），与目录名一致 |
+| `description` | 是 | 触发条件描述，Agent 据此判断何时使用该技能 |
+| `disable-model-invocation` | 否 | 设为 `true` 时禁止调用 LLM，纯本地执行 |
+| `metadata.version` | 否 | 版本号 |
+| `metadata.author` | 否 | 作者 |
+
+> ⚠️ 文件名必须为 `SKILL.md`，且放在独立目录中（目录名与 `name` 一致）。
+
 ## 预置 Prompts
 
 内置 Prompt 模板位于 `config/agent/prompts/`（打包在 npm 包中）

package/config/agent/help.md

@@ -31,6 +31,8 @@ npm install -g @ia-ccun/code-agent-cli
 
 ```bash
 aicode-cli
+# 或
+aicode
 ```
 
 ### 基本对话
@@ -66,6 +68,15 @@ Ctrl+Q
 Enter
 ```
 
+### Git Worktree 支持
+
+使用 `/skill:using-git-worktrees` 在多工作区间高效切换：
+
+```
+/skill:using-git-worktrees
+帮我创建一个新的 worktree 来开发登录功能
+```
+
 ---
 
 ## 3. 核心命令
@@ -90,6 +101,13 @@ Enter
 
 思考级别：`off` → `minimal` → `low` → `medium` → `high` → `xhigh`
 
+### 技能相关
+
+| 命令 | 说明 |
+|------|------|
+| `/skill:<name>` | 激活指定技能 |
+| `/skills` | 列出所有可用技能 |
+
 ---
 
 ## 4. 快捷键
@@ -224,16 +242,71 @@ Skill 是预置的 AI 技能模块，针对特定场景优化。
 
 ### 可用 Skills
 
+#### 代码开发
+
 | Skill | 说明 | 激活方式 |
 |-------|------|----------|
-| code-review | 代码审查 | `/skill:code-review` |
-| commit | Git 提交 | `/skill:commit` |
-| pr | PR 描述 | `/skill:pr` |
-| refactor | 代码重构 | `/skill:refactor` |
-| unit-test | 单元测试 | `/skill:unit-test` |
-| csv-data-summarizer | CSV 数据分析 | `/skill:csv-data-summarizer` |
-| frontend-design | 前端设计 | `/skill:frontend-design` |
-| ui-ux-pro-max | UI/UX 设计 | `/skill:ui-ux-pro-max` |
+| `code-review` | 代码审查 | `/skill:code-review` |
+| `refactor` | 代码重构 | `/skill:refactor` |
+| `unit-test` | 单元测试 | `/skill:unit-test` |
+| `test-driven-development` | 测试驱动开发 | `/skill:test-driven-development` |
+| `frontend-design` | 前端设计 | `/skill:frontend-design` |
+| `owasp-security` | OWASP 安全编码 | `/skill:owasp-security` |
+
+#### Git 相关
+
+| Skill | 说明 | 激活方式 |
+|-------|------|----------|
+| `commit` | Git 提交消息生成 | `/skill:commit` |
+| `using-git-worktrees` | Git Worktree 管理 | `/skill:using-git-worktrees` |
+
+#### 数据分析
+
+| Skill | 说明 | 激活方式 |
+|-------|------|----------|
+| `csv-data-summarizer` | CSV 数据分析 | `/skill:csv-data-summarizer` |
+| `design-md` | Markdown 设计文档 | `/skill:design-md` |
+
+#### UI/UX 设计
+
+| Skill | 说明 | 激活方式 |
+|-------|------|----------|
+| `ui-ux-pro-max` | UI/UX 专业设计 | `/skill:ui-ux-pro-max` |
+| `impeccable/*` | 完美界面系列技能 | `/skill:impeccable:polish` 等 |
+
+#### 多媒体
+
+| Skill | 说明 | 激活方式 |
+|-------|------|----------|
+| `video-generation` | 视频生成 | `/skill:video-generation` |
+| `aliyun-tts` | 阿里云 TTS | `/skill:aliyun-tts` |
+| `xiaomi-tts` | 小米 TTS | `/skill:xiaomi-tts` |
+
+#### 写作与内容
+
+| Skill | 说明 | 激活方式 |
+|-------|------|----------|
+| `khazix-writer` | 公众号长文写作 | `/skill:khazix-writer` |
+| `hv-analysis` | 横纵分析法深度研究 | `/skill:hv-analysis` |
+
+#### 开发流程
+
+| Skill | 说明 | 激活方式 |
+|-------|------|----------|
+| `brainstorming` | 头脑风暴 | `/skill:brainstorming` |
+| `writing-plans` | 编写实施计划 | `/skill:writing-plans` |
+| `executing-plans` | 执行计划 | `/skill:executing-plans` |
+| `dispatching-parallel-agents` | 并行任务分发 | `/skill:dispatching-parallel-agents` |
+| `systematic-debugning` | 系统性调试 | `/skill:systematic-debugging` |
+| `verification-before-completion` | 完成前验证 | `/skill:verification-before-completion` |
+
+#### 技能管理
+
+| Skill | 说明 | 激活方式 |
+|-------|------|----------|
+| `skill-creator` | 创建/编辑技能 | `/skill:skill-creator` |
+| `session-learning` | 会话学习总结 | `/skill:session-learning` |
+| `find-skills` | 查找技能 | `/skill:find-skills` |
 
 ### 使用方法
 
@@ -254,13 +327,11 @@ Prompt 是预置的工作流模板，用于特定任务。
 
 | Prompt | 说明 |
 |--------|------|
-| `/bmad-init` | 初始化 BMAD 项目 |
 | `/init-project` | 初始化新项目 |
 | `/feat` | 新增功能开发流程 |
 | `/git-commit` | Git 提交 |
-| `/git-rollback` | Git 回滚 |
-| `/git-worktree` | Git Worktree 管理 |
 | `/workflow` | 复杂工作流 |
+| `/code-simplifier` | 代码简化 |
 
 ### 使用示例
 
@@ -273,6 +344,9 @@ Prompt 是预置的工作流模板，用于特定任务。
 
 # Git 提交
 /git-commit
+
+# 复杂工作流
+/workflow
 ```
 
 ---
@@ -293,9 +367,11 @@ Prompt 是预置的工作流模板，用于特定任务。
 
 | 主题 | 说明 |
 |------|------|
-| dark | 暗色主题 |
-| light | 亮色主题 |
-| catppuccin-mocha | 猫puccin mocha（推荐） |
+| `catppuccin-mocha` | Catppuccin Mocha 暗色主题（推荐） |
+
+### 自定义主题
+
+主题文件位于 `~/.aicode-cli/agent/themes/`，可自定义颜色和样式。
 
 ---
 
@@ -320,6 +396,12 @@ Prompt 是预置的工作流模板，用于特定任务。
 2. **先审后改**：重要修改前先让 AI 解释代码
 3. **备份优先**：关键文件操作前手动备份
 
+### Git 工作流
+
+1. **使用 Worktree**：多分支并行开发时使用 Git Worktree
+2. **规范提交**：使用 `/skill:commit` 生成规范提交消息
+3. **代码审查**：重要变更使用 `/skill:code-review` 审查
+
 ---
 
 ## 10. 故障排除
@@ -328,10 +410,11 @@ Prompt 是预置的工作流模板，用于特定任务。
 
 | 问题 | 解决方案 |
 |------|----------|
-| 启动慢 | 检查网络连接 |
-| 模型连接失败 | 核对 models.json 配置 |
-| 扩展不生效 | 运行 `/reload` 重载 |
+| 启动慢 | 检查网络连接，确认模型 API 可达 |
+| 模型连接失败 | 核对 `models.json` 配置和 API Key |
+| 扩展不生效 | 运行 `/reload` 重载配置 |
 | Token 溢出 | 使用 `/clear` 清理上下文 |
+| Skills 找不到 | 确认技能已安装到 `~/.aicode-cli/agent/skills/` |
 
 ### 详细模式
 
@@ -339,6 +422,12 @@ Prompt 是预置的工作流模板，用于特定任务。
 aicode-cli --verbose
 ```
 
+### 查看上下文
+
+```bash
+/context
+```
+
 ---
 
 ## 附录
@@ -347,8 +436,8 @@ aicode-cli --verbose
 
 | 变量 | 说明 |
 |------|------|
-| `AICODE_CLI_CONFIG_DIR` | 配置目录 |
-| `AICODE_CLI_CODING_AGENT_DIR` | Agent 配置目录 |
+| `AICODE_CLI_CONFIG_DIR` | 配置目录路径 |
+| `AICODE_CLI_CODING_AGENT_DIR` | Agent 配置目录路径 |
 
 ### 命令行参数
 
@@ -359,6 +448,12 @@ aicode-cli --verbose
 | `--model <name>` | 指定模型 |
 | `--clear` | 启动时清理会话 |
 
+### 相关资源
+
+- **项目仓库**: https://github.com/ia-ccun/code-agent-cli
+- **npm 包**: https://www.npmjs.com/package/@ia-ccun/code-agent-cli
+- **pi-coding-agent**: 底层 Agent 框架
+
 ---
 
 *世界那么哒 · AI 实践落地 @2026*

package/config/agent/settings.json

@@ -14,6 +14,9 @@
     "npm:pi-subagents",
     "npm:pi-rewind",
     "npm:pi-btw",
-    "npm:pi-mcp-adapter"
+    "npm:pi-mcp-adapter",
+    "npm:juicesharp/rpiv-todo",
+    "npm:juicesharp/rpiv-ask-user-question",
+    "npm:@juicesharp/rpiv-advisor"
   ]
 }

package/config/agent/skills/frontend-slides/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Zara Zhang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/config/agent/skills/frontend-slides/README.md

@@ -0,0 +1,136 @@
+# Frontend Slides
+
+A Claude Code skill for creating stunning, animation-rich HTML presentations — from scratch or by converting PowerPoint files.
+
+## What This Does
+
+**Frontend Slides** helps non-designers create beautiful web presentations without knowing CSS or JavaScript. It uses a "show, don't tell" approach: instead of asking you to describe your aesthetic preferences in words, it generates visual previews and lets you pick what you like.
+
+Here is a deck about the skill, made through the skill:
+
+https://github.com/user-attachments/assets/ef57333e-f879-432a-afb9-180388982478
+
+
+### Key Features
+
+- **Zero Dependencies** — Single HTML files with inline CSS/JS. No npm, no build tools, no frameworks.
+- **Visual Style Discovery** — Can't articulate design preferences? No problem. Pick from generated visual previews.
+- **PPT Conversion** — Convert existing PowerPoint files to web, preserving all images and content.
+- **Anti-AI-Slop** — Curated distinctive styles that avoid generic AI aesthetics (bye-bye, purple gradients on white).
+- **Production Quality** — Accessible, responsive, well-commented code you can customize.
+
+## Installation
+
+### For Claude Code Users
+
+Copy the skill files to your Claude Code skills directory:
+
+```bash
+# Create the skill directory
+mkdir -p ~/.claude/skills/frontend-slides/scripts
+
+# Copy all files (or clone this repo directly)
+cp SKILL.md STYLE_PRESETS.md viewport-base.css html-template.md animation-patterns.md ~/.claude/skills/frontend-slides/
+cp scripts/extract-pptx.py ~/.claude/skills/frontend-slides/scripts/
+```
+
+Or clone directly:
+
+```bash
+git clone https://github.com/zarazhangrui/frontend-slides.git ~/.claude/skills/frontend-slides
+```
+
+Then use it by typing `/frontend-slides` in Claude Code.
+
+## Usage
+
+### Create a New Presentation
+
+```
+/frontend-slides
+
+> "I want to create a pitch deck for my AI startup"
+```
+
+The skill will:
+1. Ask about your content (slides, messages, images)
+2. Ask about the feeling you want (impressed? excited? calm?)
+3. Generate 3 visual style previews for you to compare
+4. Create the full presentation in your chosen style
+5. Open it in your browser
+
+### Convert a PowerPoint
+
+```
+/frontend-slides
+
+> "Convert my presentation.pptx to a web slideshow"
+```
+
+The skill will:
+1. Extract all text, images, and notes from your PPT
+2. Show you the extracted content for confirmation
+3. Let you pick a visual style
+4. Generate an HTML presentation with all your original assets
+
+## Included Styles
+
+### Dark Themes
+- **Bold Signal** — Confident, high-impact, vibrant card on dark
+- **Electric Studio** — Clean, professional, split-panel
+- **Creative Voltage** — Energetic, retro-modern, electric blue + neon
+- **Dark Botanical** — Elegant, sophisticated, warm accents
+
+### Light Themes
+- **Notebook Tabs** — Editorial, organized, paper with colorful tabs
+- **Pastel Geometry** — Friendly, approachable, vertical pills
+- **Split Pastel** — Playful, modern, two-color vertical split
+- **Vintage Editorial** — Witty, personality-driven, geometric shapes
+
+### Specialty
+- **Neon Cyber** — Futuristic, particle backgrounds, neon glow
+- **Terminal Green** — Developer-focused, hacker aesthetic
+- **Swiss Modern** — Minimal, Bauhaus-inspired, geometric
+- **Paper & Ink** — Literary, drop caps, pull quotes
+
+## Architecture
+
+This skill uses **progressive disclosure** — the main `SKILL.md` is a concise map (~180 lines), with supporting files loaded on-demand only when needed:
+
+| File | Purpose | Loaded When |
+|------|---------|-------------|
+| `SKILL.md` | Core workflow and rules | Always (skill invocation) |
+| `STYLE_PRESETS.md` | 12 curated visual presets | Phase 2 (style selection) |
+| `viewport-base.css` | Mandatory responsive CSS | Phase 3 (generation) |
+| `html-template.md` | HTML structure and JS features | Phase 3 (generation) |
+| `animation-patterns.md` | CSS/JS animation reference | Phase 3 (generation) |
+| `scripts/extract-pptx.py` | PPT content extraction | Phase 4 (conversion) |
+
+This design follows [OpenAI's harness engineering](https://openai.com/index/harness-engineering/) principle: "give the agent a map, not a 1,000-page instruction manual."
+
+## Philosophy
+
+This skill was born from the belief that:
+
+1. **You don't need to be a designer to make beautiful things.** You just need to react to what you see.
+
+2. **Dependencies are debt.** A single HTML file will work in 10 years. A React project from 2019? Good luck.
+
+3. **Generic is forgettable.** Every presentation should feel custom-crafted, not template-generated.
+
+4. **Comments are kindness.** Code should explain itself to future-you (or anyone else who opens it).
+
+## Requirements
+
+- [Claude Code](https://claude.ai/claude-code) CLI
+- For PPT conversion: Python with `python-pptx` library
+
+## Credits
+
+Created by [@zarazhangrui](https://github.com/zarazhangrui) with Claude Code.
+
+Inspired by the "Vibe Coding" philosophy — building beautiful things without being a traditional software engineer.
+
+## License
+
+MIT — Use it, modify it, share it.

package/config/agent/skills/frontend-slides/SKILL.md

@@ -0,0 +1,219 @@
+---
+name: frontend-slides
+description: Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.
+---
+
+# Frontend Slides
+
+Create zero-dependency, animation-rich HTML presentations that run entirely in the browser.
+
+## Core Principles
+
+1. **Zero Dependencies** — Single HTML files with inline CSS/JS. No npm, no build tools.
+2. **Show, Don't Tell** — Generate visual previews, not abstract choices. People discover what they want by seeing it.
+3. **Distinctive Design** — No generic "AI slop." Every presentation must feel custom-crafted.
+4. **Viewport Fitting (NON-NEGOTIABLE)** — Every slide MUST fit exactly within 100vh. No scrolling within slides, ever. Content overflows? Split into multiple slides.
+
+## Design Aesthetics
+
+You tend to converge toward generic, "on distribution" outputs. In frontend design, this creates what users call the "AI slop" aesthetic. Avoid this: make creative, distinctive frontends that surprise and delight.
+
+Focus on:
+- Typography: Choose fonts that are beautiful, unique, and interesting. Avoid generic fonts like Arial and Inter; opt instead for distinctive choices that elevate the frontend's aesthetics.
+- Color & Theme: Commit to a cohesive aesthetic. Use CSS variables for consistency. Dominant colors with sharp accents outperform timid, evenly-distributed palettes. Draw from IDE themes and cultural aesthetics for inspiration.
+- Motion: Use animations for effects and micro-interactions. Prioritize CSS-only solutions for HTML. Use Motion library for React when available. Focus on high-impact moments: one well-orchestrated page load with staggered reveals (animation-delay) creates more delight than scattered micro-interactions.
+- Backgrounds: Create atmosphere and depth rather than defaulting to solid colors. Layer CSS gradients, use geometric patterns, or add contextual effects that match the overall aesthetic.
+
+Avoid generic AI-generated aesthetics:
+- Overused font families (Inter, Roboto, Arial, system fonts)
+- Cliched color schemes (particularly purple gradients on white backgrounds)
+- Predictable layouts and component patterns
+- Cookie-cutter design that lacks context-specific character
+
+Interpret creatively and make unexpected choices that feel genuinely designed for the context. Vary between light and dark themes, different fonts, different aesthetics. You still tend to converge on common choices (Space Grotesk, for example) across generations. Avoid this: it is critical that you think outside the box!
+
+## Viewport Fitting Rules
+
+These invariants apply to EVERY slide in EVERY presentation:
+
+- Every `.slide` must have `height: 100vh; height: 100dvh; overflow: hidden;`
+- ALL font sizes and spacing must use `clamp(min, preferred, max)` — never fixed px/rem
+- Content containers need `max-height` constraints
+- Images: `max-height: min(50vh, 400px)`
+- Breakpoints required for heights: 700px, 600px, 500px
+- Include `prefers-reduced-motion` support
+- Never negate CSS functions directly (`-clamp()`, `-min()`, `-max()` are silently ignored) — use `calc(-1 * clamp(...))` instead
+
+**When generating, read `viewport-base.css` and include its full contents in every presentation.**
+
+### Content Density Limits Per Slide
+
+| Slide Type | Maximum Content |
+|------------|-----------------|
+| Title slide | 1 heading + 1 subtitle + optional tagline |
+| Content slide | 1 heading + 4-6 bullet points OR 1 heading + 2 paragraphs |
+| Feature grid | 1 heading + 6 cards maximum (2x3 or 3x2) |
+| Code slide | 1 heading + 8-10 lines of code |
+| Quote slide | 1 quote (max 3 lines) + attribution |
+| Image slide | 1 heading + 1 image (max 60vh height) |
+
+**Content exceeds limits? Split into multiple slides. Never cram, never scroll.**
+
+---
+
+## Phase 0: Detect Mode
+
+Determine what the user wants:
+
+- **Mode A: New Presentation** — Create from scratch. Go to Phase 1.
+- **Mode B: PPT Conversion** — Convert a .pptx file. Go to Phase 4.
+- **Mode C: Enhancement** — Improve an existing HTML presentation. Read it, understand it, enhance. **Follow Mode C modification rules below.**
+
+### Mode C: Modification Rules
+
+When enhancing existing presentations, viewport fitting is the biggest risk:
+
+1. **Before adding content:** Count existing elements, check against density limits
+2. **Adding images:** Must have `max-height: min(50vh, 400px)`. If slide already has max content, split into two slides
+3. **Adding text:** Max 4-6 bullets per slide. Exceeds limits? Split into continuation slides
+4. **After ANY modification, verify:** `.slide` has `overflow: hidden`, new elements use `clamp()`, images have viewport-relative max-height, content fits at 1280x720
+5. **Proactively reorganize:** If modifications will cause overflow, automatically split content and inform the user. Don't wait to be asked
+
+**When adding images to existing slides:** Move image to new slide or reduce other content first. Never add images without checking if existing content already fills the viewport.
+
+---
+
+## Phase 1: Content Discovery (New Presentations)
+
+**Ask ALL questions in a single AskUserQuestion call** so the user fills everything out at once:
+
+**Question 1 — Purpose** (header: "Purpose"):
+What is this presentation for? Options: Pitch deck / Teaching-Tutorial / Conference talk / Internal presentation
+
+**Question 2 — Length** (header: "Length"):
+Approximately how many slides? Options: Short 5-10 / Medium 10-20 / Long 20+
+
+**Question 3 — Content** (header: "Content"):
+Do you have content ready? Options: All content ready / Rough notes / Topic only
+
+**Question 4 — Inline Editing** (header: "Editing"):
+Do you need to edit text directly in the browser after generation? Options:
+- "Yes (Recommended)" — Can edit text in-browser, auto-save to localStorage, export file
+- "No" — Presentation only, keeps file smaller
+
+**Remember the user's editing choice — it determines whether edit-related code is included in Phase 3.**
+
+If user has content, ask them to share it.
+
+### Step 1.2: Image Evaluation (if images provided)
+
+If user selected "No images" → skip to Phase 2.
+
+If user provides an image folder:
+1. **Scan** — List all image files (.png, .jpg, .svg, .webp, etc.)
+2. **View each image** — Use the Read tool (Claude is multimodal)
+3. **Evaluate** — For each: what it shows, USABLE or NOT USABLE (with reason), what concept it represents, dominant colors
+4. **Co-design the outline** — Curated images inform slide structure alongside text. This is NOT "plan slides then add images" — design around both from the start (e.g., 3 screenshots → 3 feature slides, 1 logo → title/closing slide)
+5. **Confirm via AskUserQuestion** (header: "Outline"): "Does this slide outline and image selection look right?" Options: Looks good / Adjust images / Adjust outline
+
+**Logo in previews:** If a usable logo was identified, embed it (base64) into each style preview in Phase 2 — the user sees their brand styled three different ways.
+
+---
+
+## Phase 2: Style Discovery
+
+**This is the "show, don't tell" phase.** Most people can't articulate design preferences in words.
+
+### Step 2.0: Style Path
+
+Ask how they want to choose (header: "Style"):
+- "Show me options" (recommended) — Generate 3 previews based on mood
+- "I know what I want" — Pick from preset list directly
+
+**If direct selection:** Show preset picker and skip to Phase 3. Available presets are defined in [STYLE_PRESETS.md](STYLE_PRESETS.md).
+
+### Step 2.1: Mood Selection (Guided Discovery)
+
+Ask (header: "Vibe", multiSelect: true, max 2):
+What feeling should the audience have? Options:
+- Impressed/Confident — Professional, trustworthy
+- Excited/Energized — Innovative, bold
+- Calm/Focused — Clear, thoughtful
+- Inspired/Moved — Emotional, memorable
+
+### Step 2.2: Generate 3 Style Previews
+
+Based on mood, generate 3 distinct single-slide HTML previews showing typography, colors, animation, and overall aesthetic. Read [STYLE_PRESETS.md](STYLE_PRESETS.md) for available presets and their specifications.
+
+| Mood | Suggested Presets |
+|------|-------------------|
+| Impressed/Confident | Bold Signal, Electric Studio, Dark Botanical |
+| Excited/Energized | Creative Voltage, Neon Cyber, Split Pastel |
+| Calm/Focused | Notebook Tabs, Paper & Ink, Swiss Modern |
+| Inspired/Moved | Dark Botanical, Vintage Editorial, Pastel Geometry |
+
+Save previews to `.claude-design/slide-previews/` (style-a.html, style-b.html, style-c.html). Each should be self-contained, ~50-100 lines, showing one animated title slide.
+
+Open each preview automatically for the user.
+
+### Step 2.3: User Picks
+
+Ask (header: "Style"):
+Which style preview do you prefer? Options: Style A: [Name] / Style B: [Name] / Style C: [Name] / Mix elements
+
+If "Mix elements", ask for specifics.
+
+---
+
+## Phase 3: Generate Presentation
+
+Generate the full presentation using content from Phase 1 (text, or text + curated images) and style from Phase 2.
+
+If images were provided, the slide outline already incorporates them from Step 1.2. If not, CSS-generated visuals (gradients, shapes, patterns) provide visual interest — this is a fully supported first-class path.
+
+**Before generating, read these supporting files:**
+- [html-template.md](html-template.md) — HTML architecture and JS features
+- [viewport-base.css](viewport-base.css) — Mandatory CSS (include in full)
+- [animation-patterns.md](animation-patterns.md) — Animation reference for the chosen feeling
+
+**Key requirements:**
+- Single self-contained HTML file, all CSS/JS inline
+- Include the FULL contents of viewport-base.css in the `<style>` block
+- Use fonts from Fontshare or Google Fonts — never system fonts
+- Add detailed comments explaining each section
+- Every section needs a clear `/* === SECTION NAME === */` comment block
+
+---
+
+## Phase 4: PPT Conversion
+
+When converting PowerPoint files:
+
+1. **Extract content** — Run `python scripts/extract-pptx.py <input.pptx> <output_dir>` (install python-pptx if needed: `pip install python-pptx`)
+2. **Confirm with user** — Present extracted slide titles, content summaries, and image counts
+3. **Style selection** — Proceed to Phase 2 for style discovery
+4. **Generate HTML** — Convert to chosen style, preserving all text, images (from assets/), slide order, and speaker notes (as HTML comments)
+
+---
+
+## Phase 5: Delivery
+
+1. **Clean up** — Delete `.claude-design/slide-previews/` if it exists
+2. **Open** — Use `open [filename].html` to launch in browser
+3. **Summarize** — Tell the user:
+   - File location, style name, slide count
+   - Navigation: Arrow keys, Space, scroll/swipe, click nav dots
+   - How to customize: `:root` CSS variables for colors, font link for typography, `.reveal` class for animations
+   - If inline editing was enabled: Hover top-left corner or press E to enter edit mode, click any text to edit, Ctrl+S to save
+
+---
+
+## Supporting Files
+
+| File | Purpose | When to Read |
+|------|---------|-------------|
+| [STYLE_PRESETS.md](STYLE_PRESETS.md) | 12 curated visual presets with colors, fonts, and signature elements | Phase 2 (style selection) |
+| [viewport-base.css](viewport-base.css) | Mandatory responsive CSS — copy into every presentation | Phase 3 (generation) |
+| [html-template.md](html-template.md) | HTML structure, JS features, code quality standards | Phase 3 (generation) |
+| [animation-patterns.md](animation-patterns.md) | CSS/JS animation snippets and effect-to-feeling guide | Phase 3 (generation) |
+| [scripts/extract-pptx.py](scripts/extract-pptx.py) | Python script for PPT content extraction | Phase 4 (conversion) |