docs: enhance documentation with examples and fix package names

- Fix incorrect package names (@ccw/cli, @anthropic/claude-code-workflow) to claude-code-workflow
- Add workflow examples page with 8 practical artifact samples
- Optimize sidebar navigation with emoji icons and second-level grouping
- Add usage examples to commands and skills documentation
- Update qa/issues.md with current status
- Sync Chinese documentation changes

Author: catlog22

docs/.vitepress/config.ts

@@ -207,6 +207,7 @@ export default defineConfig({
           items: [
             { text: 'Overview', link: '/workflows/' },
             { text: '4-Level System', link: '/workflows/4-level' },
+            { text: 'Examples', link: '/workflows/examples' },
             { text: 'Best Practices', link: '/workflows/best-practices' },
             { text: 'Teams', link: '/workflows/teams' }
           ]

docs/.vitepress/theme/index.ts

@@ -5,6 +5,7 @@ import DarkModeToggle from './components/DarkModeToggle.vue'
 import CopyCodeButton from './components/CopyCodeButton.vue'
 import Breadcrumb from './components/Breadcrumb.vue'
 import PageToc from './components/PageToc.vue'
+import ProfessionalHome from './components/ProfessionalHome.vue'
 import Layout from './layouts/Layout.vue'
 import './styles/variables.css'
 import './styles/custom.css'
@@ -21,5 +22,6 @@ export default {
     app.component('CopyCodeButton', CopyCodeButton)
     app.component('Breadcrumb', Breadcrumb)
     app.component('PageToc', PageToc)
+    app.component('ProfessionalHome', ProfessionalHome)
   }
 }

docs/commands/claude/index.md

@@ -111,6 +111,110 @@ Most commands support the `--yes` or `-y` flag to enable auto mode and skip conf
 /ccw "implement user authentication" --yes
 ```
 
+## Usage Examples
+
+### Quick Analysis
+
+```bash
+# Analyze codebase structure
+/ccw "Analyze the authentication module architecture"
+
+# Quick bug diagnosis
+/ccw "Diagnose why the login timeout issue occurs"
+```
+
+### Planning & Implementation
+
+```bash
+# Create implementation plan
+/workflow:plan "Add OAuth2 authentication with Google and GitHub providers"
+
+# Execute with auto mode
+/workflow:execute --yes
+```
+
+### Code Review
+
+```bash
+# Review current changes
+/cli:codex-review
+
+# Focus on specific area
+/cli:codex-review "Focus on security vulnerabilities in auth module"
+```
+
+### Session Management
+
+```bash
+# List all sessions
+/workflow:session:list
+
+# Resume a paused session
+/workflow:session:resume "WFS-001"
+
+# Mark session as complete
+/workflow:session:complete "WFS-001"
+```
+
+### Issue Workflow
+
+```bash
+# Discover issues from codebase
+/issue:discover
+
+# Create plan for specific issue
+/issue:plan "ISSUE-001"
+
+# Execute the fix
+/issue:execute --commit
+```
+
+### Memory Management
+
+```bash
+# Capture current session learnings
+/memory:capture "Key insights from authentication refactoring"
+
+# List all memories
+/memory:list
+
+# Search memories
+/memory:search "authentication patterns"
+```
+
+### CLI Tool Invocation
+
+```bash
+# Initialize CLI configuration
+/cli:cli-init
+
+# Run Gemini analysis
+ccw cli -p "Analyze code patterns in src/auth" --tool gemini --mode analysis
+
+# Run with specific rule template
+ccw cli -p "Review code quality" --tool gemini --mode analysis --rule analysis-review-code-quality
+```
+
+### UI Design Workflow
+
+```bash
+# Extract styles from reference image
+/workflow:ui-design:style-extract --input "path/to/reference.png"
+
+# Generate prototype
+/workflow:ui-design:generate --layout "dashboard" --tokens "design-tokens.json"
+```
+
+## Tips
+
+1. **Use Auto Mode Sparingly**: Only use `--yes` or `-y` for routine tasks. Keep manual confirmation for complex decisions.
+
+2. **Session Persistence**: Always complete sessions with `/workflow:session:complete` to preserve learnings.
+
+3. **Memory Capture**: Regularly capture important insights with `/memory:capture` to build project knowledge.
+
+4. **CLI Tool Selection**: Let `/ccw` auto-select the appropriate tool, or explicitly specify with `--tool gemini|qwen|codex`.
+
 ## Related Documentation
 
 - [Skills Reference](../skills/)

docs/guide/installation.md

@@ -144,3 +144,48 @@ echo 'set -gx PATH (npm config get prefix)/bin $PATH' >> ~/.config/fish/config.f
 ::: info Next Steps
 After installation, check out the [First Workflow](./first-workflow.md) guide.
 :::
+
+## Quick Start Example
+
+After installation, try these commands to verify everything works:
+
+```bash
+# 1. Initialize in your project
+cd your-project
+ccw init
+
+# 2. Try a simple analysis
+ccw cli -p "Analyze the project structure" --tool gemini --mode analysis
+
+# 3. Run the main orchestrator
+/ccw "Summarize the codebase architecture"
+
+# 4. Check available commands
+ccw --help
+```
+
+### Expected Output
+
+```
+$ ccw --version
+CCW v7.0.5
+
+$ ccw init
+✔ Created .claude/CLAUDE.md
+✔ Created .ccw/workflows/
+✔ Configuration complete
+
+$ ccw cli -p "Analyze project" --tool gemini --mode analysis
+Analyzing with Gemini...
+✔ Analysis complete
+```
+
+### Common First-Time Issues
+
+| Issue | Solution |
+|-------|----------|
+| `ccw: command not found` | Add npm global bin to PATH, or reinstall |
+| `Permission denied` | Use `sudo` or fix npm permissions |
+| `API key not found` | Configure API keys in `~/.claude/cli-tools.json` |
+| `Node version mismatch` | Update to Node.js >= 18.0.0 |
+

docs/index.md

@@ -4,8 +4,4 @@ title: CCW Documentation
 titleTemplate: Claude Code Workspace
 ---
 
-<script setup>
-import ProfessionalHome from './.vitepress/theme/components/ProfessionalHome.vue'
-</script>
-
 <ProfessionalHome lang="en" />

docs/skills/index.md

@@ -165,6 +165,96 @@ Skill(skill="my-custom-skill", args="input")
 4. **Compact Recovery**: Use TodoWrite for progress tracking
 5. **Documentation**: Include usage examples and expected outputs
 
+## Practical Examples
+
+### Example 1: Feature Development
+
+**Scenario**: Implement a new user dashboard feature
+
+```bash
+# Step 1: Brainstorm the feature
+ccw brainstorm
+# Follow prompts to define:
+# - Dashboard widgets (stats, charts, recent activity)
+# - Layout preferences
+# - Data refresh intervals
+
+# Step 2: Plan implementation
+ccw workflow:plan "Build user dashboard with configurable widgets"
+# Outputs: IMPL-001.json with task breakdown
+
+# Step 3: Execute with team
+ccw team lifecycle
+# Or use quick iteration:
+ccw workflow:lite-plan && ccw workflow:execute
+
+# Step 4: Review and refine
+ccw review-code
+# Fix any issues found
+```
+
+### Example 2: Bug Investigation
+
+**Scenario**: Debug performance issue in API endpoint
+
+```bash
+# Step 1: Quick analysis
+ccw cli -p "Analyze /api/users endpoint for N+1 query issues" --tool gemini --mode analysis
+
+# Step 2: Deep dive if needed
+ccw workflow:debug-with-file
+# Creates hypothesis, instruments code, analyzes logs
+
+# Step 3: Apply fix
+ccw workflow:execute --task "Fix N+1 query in user endpoint"
+```
+
+### Example 3: Code Migration
+
+**Scenario**: Migrate from JavaScript to TypeScript
+
+```bash
+# Step 1: Analyze codebase
+ccw workflow:refactor-cycle
+# Identifies tech debt and creates migration plan
+
+# Step 2: Execute migration in phases
+ccw team roadmap-dev --epic "ts-migration"
+# Progressively migrates modules with tests
+```
+
+### Example 4: Documentation Generation
+
+**Scenario**: Generate API documentation
+
+```bash
+# Step 1: Capture existing patterns
+ccw memory:capture "API patterns: REST, versioning, error handling"
+
+# Step 2: Generate docs
+ccw software-manual --output ./docs/api/
+```
+
+### Example 5: Code Review Pipeline
+
+**Scenario**: Review PR changes
+
+```bash
+# Comprehensive review
+ccw review-code --focus security,performance
+
+# Or use cycle for auto-fix
+ccw review-cycle --max-iterations 3
+```
+
+### Tips for Best Results
+
+1. **Start Small**: Begin with `workflow:lite-plan` for simple tasks
+2. **Use Memory**: Capture insights with `memory:capture` for future reference
+3. **Verify Plans**: Always review generated plans before execution
+4. **Iterate**: Use `review-cycle` for continuous improvement
+5. **Check Sessions**: Use `workflow:session:list` to track progress
+
 ## Design Patterns
 
 Skills use these proven patterns: