Back to Details

wp-orchestrator

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

WordPress Project Orchestrator

WordPress项目编排器

Master skill that coordinates all WordPress development skills for comprehensive project management.
See Also: WORKFLOW.md - Complete end-to-end development workflow documentation
统筹所有WordPress开发技能的核心工具，用于全面项目管理。
另请参阅： WORKFLOW.md - 完整端到端开发工作流文档

Quick Start Slash Commands

快速开始斜杠命令

CommandPurpose
/wp-setup
Set up a new WordPress site with Docker, plugins, white-labeling
/wp-audit
Run comprehensive site audit (SEO, visual, performance, security)
/wp-launch
Pre-launch checklist and handoff documentation
命令用途
/wp-setup
使用Docker、插件和白标功能搭建新WordPress网站
/wp-audit
执行全面网站审计（SEO、视觉、性能、安全）
/wp-launch
启动前检查清单与交付文档

Complete Development Lifecycle

完整开发生命周期

1. Discovery & Branding → 2. Environment Setup → 3. Theme Development
       ↓                        ↓                       ↓
   brand-guide              wp-docker              wordpress-dev
                                                   gsap-animations
       ↓                        ↓                       ↓
4. Content & SEO → 5. Testing & QA → 6. Packaging & Deploy
       ↓                 ↓                    ↓
  wordpress-admin    visual-qa           GitHub + WP Pusher
  seo-optimizer      form-testing        demo-content.json
                     E2E tests           theme zip
       ↓                 ↓                    ↓
7. White-Label → 8. Client Handoff
       ↓                 ↓
  white-label       Documentation
  ASE + Branda      Training
1. 调研与品牌设计 → 2. 环境搭建 → 3. 主题开发
       ↓                        ↓                       ↓
   brand-guide              wp-docker              wordpress-dev
                                                   gsap-animations
       ↓                        ↓                       ↓
4. 内容与SEO → 5. 测试与QA → 6. 打包与部署
       ↓                 ↓                    ↓
  wordpress-admin    visual-qa           GitHub + WP Pusher
  seo-optimizer      form-testing        demo-content.json
                     E2E tests           theme zip
       ↓                 ↓                    ↓
7. 白标配置 → 8. 客户交付
       ↓                 ↓
  white-label       文档交付
  ASE + Branda      培训指导

Environment Detection

环境检测

The orchestrator automatically detects your WordPress environment:
编排器会自动检测你的WordPress环境：

Docker Environment

Docker环境

bash
undefined
bash
undefined

Check for docker-compose.yml with WordPress

检查包含WordPress的docker-compose.yml

if [ -f docker-compose.yml ] && grep -q wordpress docker-compose.yml; then echo "Docker WordPress detected" fi
if [ -f docker-compose.yml ] && grep -q wordpress docker-compose.yml; then echo "Docker WordPress detected" fi

Check running containers

检查运行中的容器

docker ps | grep wordpress
undefined
docker ps | grep wordpress
undefined

WordPress Playground

WordPress Playground

bash
undefined
bash
undefined

Check for Playground blueprints

检查Playground蓝图

if [ -f blueprint.json ] || [ -d blueprints/ ]; then echo "Playground environment detected" fi
if [ -f blueprint.json ] || [ -d blueprints/ ]; then echo "Playground environment detected" fi

Run Playground with blueprint

使用蓝图启动Playground

npx @wp-playground/cli server --blueprint=./blueprint.json
undefined
npx @wp-playground/cli server --blueprint=./blueprint.json
undefined

Standard WordPress

标准WordPress

bash
undefined
bash
undefined

Check for wp-config.php

检查wp-config.php

if [ -f wp-config.php ]; then echo "Standard WordPress installation detected" fi
undefined
if [ -f wp-config.php ]; then echo "Standard WordPress installation detected" fi
undefined

Available Skills

可用技能

SkillPurposeUse When
wordpress-devCoding standards, CPT, security, performanceWriting WordPress code
wordpress-adminSite management, WP-CLI, REST APIManaging content, settings
seo-optimizerYoast/Rank Math audit, keywords, metaSEO review and fixes
visual-qaScreenshot testing, responsive QAAfter CSS/template changes
brand-guideBrand documentationStarting new project
white-labelAdmin branding with ASE + BrandaClient site setup
gsap-animationsGSAP best practices, accessibilityImplementing animations
wp-performanceSpeed optimization, Core Web VitalsPerformance issues
wp-dockerDocker Compose environmentLocal development
wp-playgroundWordPress Playground blueprintsTesting and demos
技能用途使用场景
wordpress-dev编码规范、自定义文章类型（CPT）、安全、性能编写WordPress代码时
wordpress-admin网站管理、WP-CLI、REST API管理内容、设置时
seo-optimizerYoast/Rank Math审计、关键词、元数据SEO评估与修复时
visual-qa截图测试、响应式QACSS/模板修改后
brand-guide品牌文档新项目启动时
white-label使用ASE + Branda配置后台品牌客户网站搭建时
gsap-animationsGSAP最佳实践、可访问性实现动画效果时
wp-performance速度优化、核心Web指标存在性能问题时
wp-dockerDocker Compose环境本地开发时
wp-playgroundWordPress Playground蓝图测试与演示时

Project Phases

项目阶段

Phase 1: Discovery Interview

阶段1：调研访谈

Ask the user these questions to understand the project:
markdown
undefined
向用户询问以下问题以了解项目需求：
markdown
undefined

Project Discovery

项目调研

  1. Project Type
    • New site build?
    • Existing site optimization?
    • Site audit?
    • Specific feature implementation?
  2. Site Information
    • URL (staging/production)
    • WordPress version
    • Theme (custom, child, builder?)
    • Hosting environment (Docker local, shared, VPS, managed?)
  3. Requirements
    • What pages are needed?
    • Custom post types?
    • Forms (contact, inquiry)?
    • E-commerce?
    • Multilingual?
  4. Brand
    • Do you have brand guidelines?
    • Logo files available?
    • Color palette defined?
    • Typography chosen?
  5. SEO Requirements
    • Focus keywords identified?
    • Existing content to optimize?
    • Google Analytics/Search Console connected?
  6. Performance Goals
    • Target PageSpeed score?
    • Core Web Vitals requirements?
    • CDN preferences?
  7. Client Handoff
    • Need white-labeled admin?
    • Training documentation needed?
    • Which admin features to expose?
undefined
  1. 项目类型
    • 新网站搭建？
    • 现有网站优化？
    • 网站审计？
    • 特定功能开发？
  2. 网站信息
    • URL（ staging/生产环境）
    • WordPress版本
    • 主题（自定义、子主题、页面构建器？）
    • 托管环境（本地Docker、虚拟主机、VPS、托管WordPress？）
  3. 需求
    • 需要哪些页面？
    • 需要自定义文章类型吗？
    • 需要表单（联系、咨询）吗？
    • 需要电商功能吗？
    • 需要多语言支持吗？
  4. 品牌
    • 有品牌指南吗？
    • 有Logo文件吗？
    • 已定义配色方案？
    • 已选定字体？
  5. SEO需求
    • 已确定核心关键词？
    • 有需要优化的现有内容？
    • 已连接Google Analytics/搜索控制台？
  6. 性能目标
    • 目标PageSpeed分数？
    • 核心Web指标要求？
    • CDN偏好？
  7. 客户交付
    • 需要白标后台吗？
    • 需要培训文档吗？
    • 要开放哪些后台功能？
undefined

Phase 2: Initial Audit

阶段2：初始审计

Run these checks on existing sites:
对现有网站执行以下检查：

Plugin Check

插件检查

bash
undefined
bash
undefined

Via WP-CLI in Docker

在Docker中通过WP-CLI执行

docker exec wordpress-container wp plugin list --format=table
docker exec wordpress-container wp plugin list --format=table

Check for required plugins

检查必备插件

REQUIRED="admin-site-enhancements litespeed-cache wordpress-seo ewww-image-optimizer"
undefined
REQUIRED="admin-site-enhancements litespeed-cache wordpress-seo ewww-image-optimizer"
undefined

SEO Audit

SEO审计

bash
undefined
bash
undefined

Run SEO optimizer

运行SEO优化器

python3 /root/.claude/skills/seo-optimizer/audit.py --base-url https://site.com --json
undefined
python3 /root/.claude/skills/seo-optimizer/audit.py --base-url https://site.com --json
undefined

Visual QA

视觉QA

bash
undefined
bash
undefined

Take screenshots of all pages

截取所有页面的截图

python3 /root/.claude/skills/visual-qa/screenshot.py --all --base-url https://site.com
undefined
python3 /root/.claude/skills/visual-qa/screenshot.py --all --base-url https://site.com
undefined

Performance Check

性能检查

bash
undefined
bash
undefined

Check PageSpeed (requires API key or use web tool)

检查PageSpeed（需要API密钥或使用在线工具）

curl "https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url=https://site.com&strategy=mobile"
undefined
curl "https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url=https://site.com&strategy=mobile"
undefined

Phase 3: Todo List Generation

阶段3：生成任务清单

Based on audit results, generate comprehensive todo list:
markdown
undefined
基于审计结果，生成全面的任务清单：
markdown
undefined

Site Setup Checklist

网站搭建检查清单

Foundation

基础配置

  • WordPress core updated
  • Theme installed and configured
  • Child theme created (if needed)
  • Required plugins installed
  • WordPress核心已更新
  • 主题已安装并配置
  • 创建子主题（如需要）
  • 安装必备插件

Plugins to Install

待安装插件

  • Admin and Site Enhancements (ASE) - Admin cleanup, security
  • Branda - White labeling, login customization
  • LiteSpeed Cache - Performance
  • Yoast SEO - SEO optimization
  • WP Mail SMTP - Email delivery
  • Solid Security - Additional security
  • EWWW Image Optimizer - Image compression
  • WP Activity Log - Audit logging
  • Site Kit by Google - Analytics integration
  • ManageWP Worker - Remote management
  • Instant Images - Stock photos
  • Admin Menu Editor - Menu organization (optional)
  • Admin and Site Enhancements (ASE) - 后台清理、安全
  • Branda - 白标、登录页面定制
  • LiteSpeed Cache - 性能优化
  • Yoast SEO - SEO优化
  • WP Mail SMTP - 邮件发送
  • Solid Security - 额外安全防护
  • EWWW Image Optimizer - 图片压缩
  • WP Activity Log - 审计日志
  • Site Kit by Google - Analytics集成
  • ManageWP Worker - 远程管理
  • Instant Images - 库存图片
  • Admin Menu Editor - 菜单组织（可选）

Pages to Create

待创建页面

  • Home
  • About
  • Services/Portfolio
  • Contact
  • Privacy Policy
  • Terms of Service
  • 首页
  • 关于我们
  • 服务/作品集
  • 联系我们
  • 隐私政策
  • 服务条款

SEO Setup

SEO设置

  • Focus keyword for each page
  • Meta descriptions (120-160 chars)
  • Featured images with ALT text
  • XML sitemap generated
  • Robots.txt configured
  • Google Search Console connected
  • 为每个页面设置核心关键词
  • 元描述（120-160字符）
  • 特色图片添加ALT文本
  • 生成XML站点地图
  • 配置Robots.txt
  • 连接Google搜索控制台

Performance

性能优化

  • Image optimization configured
  • Caching enabled
  • CDN configured
  • Lazy loading enabled
  • Minification enabled
  • PageSpeed score >80
  • 配置图片优化
  • 启用缓存
  • 配置CDN
  • 启用懒加载
  • 启用资源压缩
  • PageSpeed分数>80

Security

安全配置

  • Login URL changed
  • XML-RPC disabled
  • 2FA enabled for admins
  • Automatic updates configured
  • Backup solution in place
  • 修改登录URL
  • 禁用XML-RPC
  • 为管理员启用双因素认证（2FA）
  • 配置自动更新
  • 启用备份方案

White Label (Client Sites) - Using white-label skill

白标配置（客户网站）- 使用white-label技能

  • Login page customized (Branda: logo, colors, background)
  • Admin bar branded (Branda: hide WP logo, custom logo)
  • "Howdy" replaced (Branda: custom greeting)
  • Admin footer customized (ASE or Branda)
  • Dashboard widgets hidden (ASE)
  • Admin menu organized (Admin Menu Editor)
  • Custom login URL set (ASE: /client-login)
  • XML-RPC disabled (ASE)
  • Author slugs obfuscated (ASE)
  • 定制登录页面（Branda：Logo、配色、背景）
  • 定制后台顶部栏（Branda：隐藏WP Logo、添加自定义Logo）
  • 替换"Howdy"问候语（Branda：自定义问候）
  • 定制后台页脚（ASE或Branda）
  • 隐藏仪表盘小部件（ASE）
  • 组织后台菜单（Admin Menu Editor）
  • 设置自定义登录URL（ASE：/client-login）
  • 禁用XML-RPC（ASE）
  • 混淆作者别名（ASE）

Visual QA

视觉QA

  • Desktop screenshots reviewed
  • Tablet screenshots reviewed
  • Mobile screenshots reviewed
  • Animations working
  • No layout issues
  • Forms functional
  • 审核桌面端截图
  • 审核平板端截图
  • 审核移动端截图
  • 动画效果正常运行
  • 无布局问题
  • 表单功能正常

Pre-Launch

启动前检查

  • All pages have content
  • Forms tested
  • 404 page configured
  • Favicon uploaded
  • Social sharing images set
  • Analytics tracking verified

---
  • 所有页面已填充内容
  • 表单已测试
  • 配置404页面
  • 上传网站图标（Favicon）
  • 设置社交分享图片
  • 验证分析跟踪

---

Orchestration Commands

编排命令

New Project Setup

新项目搭建

When user says: "Set up a new WordPress project"
  1. Run Discovery Interview
    • Use AskUserQuestion tool for project requirements
    • Document brand, pages, features needed
  2. Create Todo List
    • Generate comprehensive TodoWrite list
    • Break into phases (Foundation → Content → SEO → Performance → Launch)
  3. Plugin Installation Guidance
    • List plugins from recommended-plugins.md
    • Provide installation order
  4. Theme Setup
    • Guide through theme installation
    • Configure initial settings
  5. ASE Configuration
    • Apply security settings
    • Configure white labeling
当用户说："Set up a new WordPress project"
  1. 执行调研访谈
    • 使用AskUserQuestion工具收集项目需求
    • 记录品牌、页面、所需功能
  2. 创建任务清单
    • 生成全面的TodoWrite任务清单
    • 拆分为多个阶段（基础配置 → 内容 → SEO → 性能 → 启动）
  3. 插件安装指导
    • 列出recommended-plugins.md中的插件
    • 提供安装顺序
  4. 主题设置
    • 指导主题安装流程
    • 配置初始设置
  5. ASE配置
    • 应用安全设置
    • 配置白标功能

Site Audit

网站审计

When user says: "Audit this WordPress site"
  1. Run All Audits in Parallel (using Task tool with Haiku agents)
    • SEO audit agent
    • Visual QA agent
    • Performance check agent
    • Security review agent
  2. Compile Results
    • Aggregate findings
    • Prioritize issues
  3. Generate Action Plan
    • Create TodoWrite list of fixes
    • Estimate effort (simple/moderate/complex)
当用户说："Audit this WordPress site"
  1. 并行执行所有审计（使用Task工具和Haiku代理）
    • SEO审计代理
    • 视觉QA代理
    • 性能检查代理
    • 安全审查代理
  2. 汇总结果
    • 整合所有发现
    • 对问题进行优先级排序
  3. 生成行动计划
    • 创建TodoWrite修复任务清单
    • 评估工作量（简单/中等/复杂）

Performance Optimization

性能优化

When user says: "Optimize site performance"
  1. Baseline Measurement
    • Run PageSpeed test
    • Record current scores
  2. Image Audit
    • Check image sizes
    • Identify unoptimized images
  3. Caching Configuration
    • Configure LiteSpeed Cache
    • Set up browser caching
  4. Asset Optimization
    • Review CSS/JS loading
    • Implement deferring
  5. Re-test
    • Run PageSpeed again
    • Compare results
当用户说："Optimize site performance"
  1. 基准测试
    • 运行PageSpeed测试
    • 记录当前分数
  2. 图片审计
    • 检查图片大小
    • 识别未优化的图片
  3. 缓存配置
    • 配置LiteSpeed Cache
    • 设置浏览器缓存
  4. 资源优化
    • 审查CSS/JS加载
    • 实现延迟加载
  5. 重新测试
    • 再次运行PageSpeed测试
    • 对比结果

Parallel Agent Patterns

并行代理模式

Multi-Page Audit

多页面审计

python
undefined
python
undefined

Launch parallel Haiku agents for page audits

启动并行Haiku代理进行页面审计

agents = [ Task(subagent_type="Explore", prompt="Audit home page SEO and visual state"), Task(subagent_type="Explore", prompt="Audit about page SEO and visual state"), Task(subagent_type="Explore", prompt="Audit portfolio page SEO and visual state"), Task(subagent_type="Explore", prompt="Audit contact page SEO and visual state"), ]
agents = [ Task(subagent_type="Explore", prompt="Audit home page SEO and visual state"), Task(subagent_type="Explore", prompt="Audit about page SEO and visual state"), Task(subagent_type="Explore", prompt="Audit portfolio page SEO and visual state"), Task(subagent_type="Explore", prompt="Audit contact page SEO and visual state"), ]

Run all in parallel using model="haiku"

使用model="haiku"并行运行所有任务

undefined
undefined

Full Site Review

全站审查

python
undefined
python
undefined

Parallel skill execution

并行执行技能

agents = [ Task(prompt="Run SEO audit using seo-optimizer skill", model="haiku"), Task(prompt="Take visual QA screenshots using visual-qa skill", model="haiku"), Task(prompt="Check performance using wp-performance skill", model="haiku"), Task(prompt="Review security using ase-config skill", model="haiku"), ]

---
agents = [ Task(prompt="Run SEO audit using seo-optimizer skill", model="haiku"), Task(prompt="Take visual QA screenshots using visual-qa skill", model="haiku"), Task(prompt="Check performance using wp-performance skill", model="haiku"), Task(prompt="Review security using ase-config skill", model="haiku"), ]

---

Interview Templates

访谈模板

Client Kickoff Interview

客户启动访谈

markdown
undefined
markdown
undefined

Project Kickoff Questions

项目启动问题清单

Business Understanding

业务理解

  1. What does your business do?
  2. Who is your target audience?
  3. What are your main competitors?
  4. What makes you different?
  1. 你的业务是做什么的？
  2. 目标受众是谁？
  3. 主要竞争对手有哪些？
  4. 你的差异化优势是什么？

Website Goals

网站目标

  1. What is the primary goal of this website?
    • Lead generation
    • E-commerce sales
    • Information/portfolio
    • Brand awareness
  2. What actions should visitors take?
  3. How will you measure success?
  1. 这个网站的主要目标是什么？
    • 线索生成
    • 电商销售
    • 信息展示/作品集
    • 品牌曝光
  2. 希望访客执行哪些操作？
  3. 如何衡量成功？

Content

内容

  1. Do you have existing content to migrate?
  2. Will you provide content or need copywriting?
  3. Do you have professional photos?
  4. What pages do you need?
  1. 有需要迁移的现有内容吗？
  2. 你会提供内容还是需要文案服务？
  3. 有专业图片吗？
  4. 需要哪些页面？

Design Preferences

设计偏好

  1. Any websites you like the look of?
  2. Brand colors and fonts established?
  3. Logo files available?
  4. Design style preference?
    • Minimal
    • Bold
    • Corporate
    • Creative
  1. 有没有喜欢的网站风格？
  2. 已确定品牌配色和字体？
  3. 有Logo文件吗？
  4. 设计风格偏好？
    • 极简
    • 醒目
    • 企业风
    • 创意风

Technical Requirements

技术需求

  1. Need any integrations?
    • CRM
    • Email marketing
    • Booking system
    • Payment processing
  2. Expected traffic volume?
  3. Need multilingual support?
  4. Special functionality needed?
  1. 需要哪些集成？
    • CRM
    • 邮件营销
    • 预订系统
    • 支付处理
  2. 预期流量规模？
  3. 需要多语言支持吗？
  4. 需要特殊功能吗？

Timeline & Budget

时间线与预算

  1. Deadline for launch?
  2. Ongoing maintenance needed?
  3. Budget constraints?
undefined
  1. 启动截止日期？
  2. 需要持续维护吗？
  3. 预算限制？
undefined

Site Audit Interview

网站审计访谈

markdown
undefined
markdown
undefined

Site Audit Questions

网站审计问题清单

  1. What issues are you experiencing?
  2. When did you last update WordPress/plugins?
  3. Have you noticed performance problems?
  4. Any specific pages with issues?
  5. Are you tracking analytics currently?
  6. What is your current hosting?
  7. Do you have backups configured?
  8. Who has admin access?

---
  1. 你遇到了哪些问题？
  2. 上次更新WordPress/插件是什么时候？
  3. 有没有注意到性能问题？
  4. 有没有特定页面存在问题？
  5. 当前是否在跟踪分析数据？
  6. 当前使用的是哪种托管服务？
  7. 已配置备份吗？
  8. 哪些人拥有管理员权限？

---

Reporting Templates

报告模板

Audit Report

审计报告

markdown
undefined
markdown
undefined

WordPress Site Audit Report

WordPress网站审计报告

Site: [URL] Date: [Date] Auditor: Claude Code
网站: [URL] 日期: [日期] 审计者: Claude Code

Executive Summary

执行摘要

[2-3 sentence overview]
[2-3句话概述]

Scores

评分

CategoryScoreTarget
SEOX/10080+
PerformanceX/10080+
AccessibilityX/10090+
SecurityX/1010/10
类别分数目标
SEOX/10080+
性能X/10080+
可访问性X/10090+
安全X/1010/10

Critical Issues

关键问题

  1. [Issue 1]
  2. [Issue 2]
  1. [问题1]
  2. [问题2]

Recommendations

建议

High Priority

高优先级

  • Fix [issue]
  • Implement [feature]
  • 修复[问题]
  • 实现[功能]

Medium Priority

中优先级

  • Optimize [aspect]
  • Configure [setting]
  • 优化[方面]
  • 配置[设置]

Low Priority

低优先级

  • Consider [improvement]
  • 考虑[改进]

Next Steps

下一步行动

  1. [Action 1]
  2. [Action 2]
undefined
  1. [行动1]
  2. [行动2]
undefined

Handoff Documentation

交付文档

markdown
undefined
markdown
undefined

Website Handoff Documentation

网站交付文档

Login Information

登录信息

  • Admin URL: [URL]/secure-login
  • Username: [provided separately]
  • Password: [provided separately]
  • 后台URL: [URL]/secure-login
  • 用户名: [单独提供]
  • 密码: [单独提供]

How to Edit Content

内容编辑指南

Editing Pages

编辑页面

  1. Log in to the admin area
  2. Click "Pages" in the left menu
  3. Find the page you want to edit
  4. Click "Edit"
  5. Make your changes
  6. Click "Update" to save
  1. 登录后台
  2. 点击左侧菜单的"页面"
  3. 找到要编辑的页面
  4. 点击"编辑"
  5. 修改内容
  6. 点击"更新"保存

Adding Blog Posts

添加博客文章

  1. Click "Posts" → "Add New"
  2. Enter title and content
  3. Set featured image
  4. Add categories/tags
  5. Click "Publish"
  1. 点击"文章" → "新建"
  2. 输入标题和内容
  3. 设置特色图片
  4. 添加分类/标签
  5. 点击"发布"

Uploading Images

上传图片

  1. Click "Media" → "Add New"
  2. Drop files or click to upload
  3. Images are automatically optimized
  1. 点击"媒体" → "新建"
  2. 拖拽文件或点击上传
  3. 图片会自动优化

SEO Guidelines

SEO指南

  • Each page should have a focus keyword
  • Meta descriptions should be 120-160 characters
  • Featured images should have ALT text
  • 每个页面应设置一个核心关键词
  • 元描述应在120-160字符之间
  • 特色图片应添加ALT文本

Support

支持

Contact [Your Agency] at [email] for assistance.

---
联系[你的代理机构]：[邮箱]获取协助。

---

Workflow Integration

工作流集成

With Hooks

使用钩子

The orchestrator can trigger other skills automatically:
yaml
undefined
编排器可以自动触发其他技能：
yaml
undefined

Example workflow configuration

示例工作流配置

on_new_project:
  • run: discovery_interview
  • run: wordpress-dev/scaffold_theme
  • run: ase-config/apply_defaults
  • run: seo-optimizer/initial_setup
on_pre_launch:
  • run: seo-optimizer/audit
  • run: visual-qa/full_site
  • run: wp-performance/speed_test
  • run: generate_report
undefined
on_new_project:
  • run: discovery_interview
  • run: wordpress-dev/scaffold_theme
  • run: ase-config/apply_defaults
  • run: seo-optimizer/initial_setup
on_pre_launch:
  • run: seo-optimizer/audit
  • run: visual-qa/full_site
  • run: wp-performance/speed_test
  • run: generate_report
undefined

With Claude Code Slash Commands

使用Claude Code斜杠命令

bash
undefined
bash
undefined

Register as skill

注册为技能

/wp-setup # Start new project setup /wp-audit # Run comprehensive audit /wp-optimize # Performance optimization /wp-seo # SEO review and fixes /wp-visual # Visual QA screenshots

---
/wp-setup # 启动新项目搭建 /wp-audit # 执行全面审计 /wp-optimize # 性能优化 /wp-seo # SEO评估与修复 /wp-visual # 视觉QA截图

---

Theme Packaging & Distribution

主题打包与分发

Create Theme Zip

创建主题压缩包

bash
cd /path/to/project
bash
cd /path/to/project

Remove old zips

删除旧压缩包

rm -f theme-name-*.zip
rm -f theme-name-*.zip

Create versioned zip (exclude dev files)

创建带版本号的压缩包（排除开发文件）

zip -r theme-name-1.0.0.zip theme-name
-x ".git"
-x "node_modules"
-x ".DS_Store"
-x "tests/"
-x ".env*"
undefined
zip -r theme-name-1.0.0.zip theme-name
-x ".git"
-x "node_modules"
-x ".DS_Store"
-x "tests/"
-x ".env*"
undefined

Export Demo Content

导出演示内容

Before packaging, export current content:
  1. WordPress Admin → Theme Settings → Demo Content
  2. Click "Export Demo Content"
  3. Verify 
    demo-content.json
    is updated in theme folder
打包前，导出当前内容：
  1. WordPress后台 → 主题设置 → 演示内容
  2. 点击"导出演示内容"
  3. 验证
    demo-content.json
    已在主题文件夹中更新

GitHub Repository Setup

GitHub仓库设置

bash
cd /path/to/theme
bash
cd /path/to/theme

Initialize and push

初始化并推送

git init git add . git commit -m "Initial theme release v1.0.0" gh repo create theme-name --public --source=. --push
git init git add . git commit -m "Initial theme release v1.0.0" gh repo create theme-name --public --source=. --push

Push updates

推送更新

git add . git commit -m "feat: description of changes v1.0.1" git push origin main
undefined
git add . git commit -m "feat: description of changes v1.0.1" git push origin main
undefined

WP Pusher Deployment (Production)

WP Pusher部署（生产环境）

Install WP Pusher on production site:
  1. Plugins → Add New → "WP Pusher" → Install & Activate
  2. WP Pusher → Install Theme
  3. Enter repository: 
    username/theme-name
  4. Branch: 
    main
  5. Click "Install Theme"
Pull Updates:
  • WP Pusher → Themes → Click "Update Theme"
Auto-Deploy (Optional):
  1. WP Pusher → Themes → Theme Settings
  2. Enable "Push-to-Deploy"
  3. Copy webhook URL
  4. GitHub repo → Settings → Webhooks → Add webhook
  5. Paste URL, select "push" events
在生产环境安装WP Pusher：
  1. 插件 → 添加新插件 → 搜索"WP Pusher" → 安装并激活
  2. WP Pusher → 安装主题
  3. 输入仓库地址：
    username/theme-name
  4. 分支：
    main
  5. 点击"安装主题"
拉取更新：
  • WP Pusher → 主题 → 点击"更新主题"
自动部署（可选）：
  1. WP Pusher → 主题 → 主题设置
  2. 启用"Push-to-Deploy"
  3. 复制Webhook URL
  4. GitHub仓库 → 设置 → Webhooks → 添加Webhook
  5. 粘贴URL，选择"push"事件

Demo Content System

演示内容系统

What Gets Exported

导出内容包含

DataSource
PagesTitle, content, template, slug
Properties (CPT)All fields and meta
Yoast SEOFocus keyword, meta desc, SEO title
Featured ImagesURLs for re-download
Theme OptionsCustom settings
Reading SettingsFront page config
数据来源
页面标题、内容、模板、别名
自定义文章类型（CPT）所有字段和元数据
Yoast SEO核心关键词、元描述、SEO标题
特色图片重新下载的URL
主题选项自定义设置
阅读设置首页配置

Import on Fresh Install

全新安装时导入

  1. Activate theme
  2. Setup Wizard Step 2: "Import Demo Content"
  3. Or: Theme Settings → Demo Content → Import
  1. 激活主题
  2. 设置向导第2步："导入演示内容"
  3. 或：主题设置 → 演示内容 → 导入

WP-CLI Export/Import

WP-CLI导出/导入

bash
undefined
bash
undefined

Export

导出

docker exec wordpress wp eval "print_r(csr_export_demo_content());" --allow-root
docker exec wordpress wp eval "print_r(csr_export_demo_content());" --allow-root

Trigger import

触发导入

docker exec wordpress wp eval "csr_import_demo_content();" --allow-root

---
docker exec wordpress wp eval "csr_import_demo_content();" --allow-root

---

Quick Reference

快速参考

Common Orchestrator Commands

常用编排器命令

User SaysOrchestrator Does
"Set up a new WordPress site"
/wp-setup
→ Discovery interview → Docker/Playground → Install plugins
"Audit this site"
/wp-audit
→ Run all audit skills in parallel → Compile report
"Optimize performance"Run wp-performance → Apply fixes
"Check SEO"Run seo-optimizer → Show issues
"Take screenshots"Run visual-qa → Analyze results
"White label admin"Run white-label → Apply ASE + Branda settings
"Prepare for launch"
/wp-launch
→ Run all checks → Generate handoff docs
"Start Docker WordPress"Copy wp-docker templates → docker-compose up
"Test in Playground"Run wp-playground blueprint → Open browser
"Package theme for distribution"Export demo content → Create zip → Push to GitHub
"Deploy to production"Setup WP Pusher → Connect GitHub → Pull updates
用户指令编排器操作
"Set up a new WordPress site"
/wp-setup
→ 调研访谈 → Docker/Playground → 安装插件
"Audit this site"
/wp-audit
→ 并行运行所有审计技能 → 编译报告
"Optimize performance"运行wp-performance → 应用修复
"Check SEO"运行seo-optimizer → 显示问题
"Take screenshots"运行visual-qa → 分析结果
"White label admin"运行white-label → 应用ASE + Branda设置
"Prepare for launch"
/wp-launch
→ 运行所有检查 → 生成交付文档
"Start Docker WordPress"复制wp-docker模板 → docker-compose up
"Test in Playground"运行wp-playground蓝图 → 打开浏览器
"Package theme for distribution"导出演示内容 → 创建压缩包 → 推送到GitHub
"Deploy to production"配置WP Pusher → 连接GitHub → 拉取更新

Related Skills

相关技能

All skills are documented at:
  • /root/.claude/skills/wordpress-dev/
    - Development best practices
  • /root/.claude/skills/wordpress-admin/
    - Site management
  • /root/.claude/skills/seo-optimizer/
    - SEO auditing
  • /root/.claude/skills/visual-qa/
    - Visual testing
  • /root/.claude/skills/brand-guide/
    - Brand documentation
  • /root/.claude/skills/white-label/
    - Admin white-labeling (ASE + Branda)
  • /root/.claude/skills/gsap-animations/
    - Animation best practices
  • /root/.claude/skills/wp-performance/
    - Performance optimization
  • /root/.claude/skills/wp-docker/
    - Docker environment
  • /root/.claude/skills/wp-playground/
    - WordPress Playground
Slash commands at:
  • /root/.claude/commands/wp-setup.md
  • /root/.claude/commands/wp-audit.md
  • /root/.claude/commands/wp-launch.md
Plugin bundle at:
  • /root/.claude/plugins/wordpress-dev-skills/
所有技能文档位于：
  • /root/.claude/skills/wordpress-dev/
    - 开发最佳实践
  • /root/.claude/skills/wordpress-admin/
    - 网站管理
  • /root/.claude/skills/seo-optimizer/
    - SEO审计
  • /root/.claude/skills/visual-qa/
    - 视觉测试
  • /root/.claude/skills/brand-guide/
    - 品牌文档
  • /root/.claude/skills/white-label/
    - 后台白标配置（ASE + Branda）
  • /root/.claude/skills/gsap-animations/
    - 动画最佳实践
  • /root/.claude/skills/wp-performance/
    - 性能优化
  • /root/.claude/skills/wp-docker/
    - Docker环境
  • /root/.claude/skills/wp-playground/
    - WordPress Playground
斜杠命令文档位于：
  • /root/.claude/commands/wp-setup.md
  • /root/.claude/commands/wp-audit.md
  • /root/.claude/commands/wp-launch.md
插件包位于：
  • /root/.claude/plugins/wordpress-dev-skills/