WordPress项目协调器 WordPress项目协调器是一个主技能，用于全面协调所有WordPress开发技能，以实现综合项目管理。

参见： WORKFLOW.md - 完整的端到端开发工作流程文档

快速开始斜杠命令

命令	目的
`/wp-setup`	使用Docker、插件、白标设置新WordPress站点
`/wp-audit`	运行全面的站点审计（SEO、视觉、性能、安全）
`/wp-launch`	预启动检查清单和交接文档

完整的开发生命周期

1. 发现与品牌 → 2. 环境设置 → 3. 主题开发
       ↓                        ↓                       ↓
  品牌指南              wp-docker              wordpress-dev
                                                   gsap-animations
       ↓                        ↓                       ↓
4. 内容与SEO → 5. 测试与QA → 6. 打包与部署
       ↓                 ↓                    ↓
  wordpress-admin   视觉QA           GitHub + WP Pusher
  seo-optimizer      表单测试       演示内容.json
                     E2E测试          主题zip
       ↓                 ↓                    ↓
7. 白标 → 8. 客户交接
       ↓                 ↓
  白标      文档
  ASE + Branda      培训

环境检测

协调器自动检测您的WordPress环境：

Docker环境

# 检查带有WordPress的docker-compose.yml
if [ -f docker-compose.yml ] && grep -q wordpress docker-compose.yml; then
    echo "检测到Docker WordPress"
fi

# 检查运行中的容器
docker ps | grep wordpress

WordPress游乐场

# 检查Playground蓝图
if [ -f blueprint.json ] || [ -d blueprints/ ]; then
    echo "检测到Playground环境"
fi

# 使用蓝图运行Playground
npx @wp-playground/cli server --blueprint=./blueprint.json

标准WordPress

# 检查wp-config.php
if [ -f wp-config.php ]; then
    echo "检测到标准WordPress安装"
fi

可用技能

技能	目的	使用时
wordpress-dev	编码标准、CPT、安全、性能	编写WordPress代码
wordpress-admin	站点管理、WP-CLI、REST API	管理内容、设置
seo-optimizer	Yoast/Rank Math审计、关键词、元数据	SEO审查和修复
visual-qa	截图测试、响应式QA	CSS/模板更改后
brand-guide	品牌文档	开始新项目
white-label	管理员品牌化ASE + Branda	客户站点设置
gsap-animations	GSAP最佳实践、可访问性	实施动画
wp-performance	速度优化、核心Web Vitals	性能问题
wp-docker	Docker Compose环境	本地开发
wp-playground	WordPress游乐场蓝图	测试和演示

项目阶段

第1阶段：发现访谈

询问用户这些问题以了解项目：

## 项目发现

1. **项目类型**
   - 新建站点？
   - 现有站点优化？
   - 站点审计？
   - 特定功能实现？

2. **站点信息**
   - URL（暂存/生产）
   - WordPress版本
   - 主题（定制、子主题、构建器？）
   - 托管环境（Docker本地、共享、VPS、托管？）

3. **需求**
   - 需要哪些页面？
   - 自定义帖子类型？
   - 表单（联系、询问）？
   - 电子商务？
   - 多语言？

4. **品牌**
   - 您有品牌指南吗？
   - LOGO文件可用？
   - 定义了颜色调色板？
   - 选择了字体？

5. **SEO需求**
   - 确定焦点关键词？
   - 现有内容优化？
   - 连接Google Analytics/Search Console？

6. **性能目标**
   - 目标PageSpeed得分？
   - 核心Web Vitals要求？
   - CDN偏好？

7. **客户交接**
   - 需要白标管理员？
   - 需要培训文档？
   - 暴露哪些管理员功能？

第2阶段：初始审计

在现有站点上运行这些检查：

插件检查

# 通过Docker中的WP-CLI
docker exec wordpress-container wp plugin list --format=table

# 检查所需插件
REQUIRED="admin-site-enhancements litespeed-cache wordpress-seo ewww-image-optimizer"

SEO审计

# 运行SEO优化器
python3 /root/.claude/skills/seo-optimizer/audit.py --base-url https://site.com --json

视觉QA

# 拍摄所有页面的截图
python3 /root/.claude/skills/visual-qa/screenshot.py --all --base-url https://site.com

性能检查

# 检查PageSpeed（需要API密钥或使用网络工具）
curl "https://www.googleapis.com/pagespeedonline/v5/runPagespeed?url=https://site.com&strategy=mobile"

第3阶段：待办事项列表生成

根据审计结果，生成全面的待办事项列表：

## 站点设置检查清单

### 基础
- [ ] WordPress核心更新
- [ ] 主题安装并配置
- [ ] 创建子主题（如果需要）
- [ ] 安装所需插件

### 要安装的插件
- [ ] 管理员和站点增强（ASE）-管理员清理、安全
- [ ] Branda-白标、登录自定义
- [ ] LiteSpeed缓存-性能
- [ ] Yoast SEO-SEO优化
- [ ] WP Mail SMTP-电子邮件传递
- [ ] Solid Security-额外安全
- [ ] EWWW Image Optimizer-图像压缩
- [ ] WP活动日志-审计日志
- [ ] 谷歌站点套件-分析集成
- [ ] ManageWP Worker-远程管理
- [ ] 即时图像-库存照片
- [ ] 管理员菜单编辑器-菜单组织（可选）

### 要创建的页面
- [ ] 首页
- [ ] 关于
- [ ] 服务/作品集
- [ ] 联系
- [ ] 隐私政策
- [ ] 服务条款

### SEO设置
- [ ] 每个页面的焦点关键词
- [ ] 元描述（120-160字符）
- [ ] 特色图片带有ALT文本
- [ ] 生成XML站点地图
- [ ] 配置robots.txt
- [ ] 连接Google搜索控制台

### 性能
- [ ] 图像优化配置
- [ ] 启用缓存
- [ ] 配置CDN
- [ ] 启用延迟加载
- [ ] 启用压缩
- [ ] PageSpeed得分>80

### 安全
- [ ] 更改登录URL
- [ ] 禁用XML-RPC
- [ ] 为管理员启用2FA
- [ ] 配置自动更新
- [ ] 备份解决方案到位

### 白标（客户站点）-使用白标技能
- [ ] 自定义登录页面（Branda：徽标、颜色、背景）
- [ ] 品牌管理栏（Branda：隐藏WP徽标、自定义徽标）
- [ ] 替换"Howdy"（Branda：自定义问候语）
- [ ] 自定义管理员页脚（ASE或Branda）
- [ ] 隐藏仪表板小部件（ASE）
- [ ] 组织管理员菜单（管理员菜单编辑器）
- [ ] 设置自定义登录URL（ASE：/client-login）
- [ ] 禁用XML-RPC（ASE）
- [ ] 混淆作者slugs（ASE）

### 视觉QA
- [ ] 审核桌面截图
- [ ] 审核平板截图
- [ ] 审核移动截图
- [ ] 动画工作
- [ ] 无布局问题
- [ ] 表单功能

### 预启动
- [ ] 所有页面都有内容
- [ ] 测试表单
- [ ] 配置404页面
- [ ] 上传图标
- [ ] 设置社交共享图像
- [ ] 验证分析跟踪

协调命令

新项目设置

当用户说：“设置一个新的WordPress项目”

运行发现访谈
- 使用AskUserQuestion工具进行项目需求
- 文档品牌、页面、所需功能
创建待办事项列表
- 生成全面的TodoWrite列表
- 分解为阶段（基础 → 内容 → SEO → 性能 → 启动）
插件安装指导
- 从recommended-plugins.md列出插件
- 提供安装顺序
主题设置
- 指导主题安装
- 配置初始设置
ASE配置
- 应用安全设置
- 配置白标

站点审计

当用户说：“审计这个WordPress站点”

并行运行所有审计（使用Task工具与Haiku代理）
- SEO审计代理
- 视觉QA代理
- 性能检查代理
- 安全审查代理
编译结果
- 汇总发现
- 优先问题
生成行动计划
- 创建TodoWrite修复列表
- 估计工作量（简单/中等/复杂）

性能优化

当用户说：“优化站点性能”

基线测量
- 运行PageSpeed测试
- 记录当前得分
图像审计
- 检查图像大小
- 识别未优化的图像
缓存配置
- 配置LiteSpeed缓存
- 设置浏览器缓存
资产优化
- 审查CSS/JS加载
- 实施延迟
重新测试
- 再次运行PageSpeed
- 比较结果

并行代理模式

多页面审计

# 为页面审计启动并行Haiku代理
agents = [
    Task(subagent_type="Explore", prompt="审计首页SEO和视觉状态"),
    Task(subagent_type="Explore", prompt="审计关于页面SEO和视觉状态"),
    Task(subagent_type="Explore", prompt="审计作品集页面SEO和视觉状态"),
    Task(subagent_type="Explore", prompt="审计联系页面SEO和视觉状态"),
]
# 使用model="haiku"并行运行全部

全站审查

# 并行技能执行
agents = [
    Task(prompt="使用seo-optimizer技能运行SEO审计", model="haiku"),
    Task(prompt="使用visual-qa技能拍摄视觉QA截图", model="haiku"),
    Task(prompt="使用wp-performance技能检查性能", model="haiku"),
    Task(prompt="使用ase-config技能审查安全", model="haiku"),
]

访谈模板

客户启动访谈

# 项目启动问题

## 商业理解
1. 您的业务是做什么的？
2. 您的目标受众是谁？
3. 您的主要竞争对手是谁？
4. 您有什么不同？

## 网站目标
1. 这个网站的主要目标是什么？
   - 潜在客户生成
   - 电子商务销售
   - 信息/作品集
   - 品牌意识

2. 访问者应该采取什么行动？
3. 您将如何衡量成功？

## 内容
1. 您有现有内容要迁移吗？
2. 您提供内容还是需要文案？
3. 您有专业照片吗？
4. 您需要哪些页面？

## 设计偏好
1. 您喜欢哪些网站的外观？
2. 品牌颜色和字体已确定？
3. LOGO文件可用？
4. 设计风格偏好？
   - 最小化
   - 大胆
   - 企业
   - 创意

## 技术需求
1. 需要任何集成？
   - CRM
   - 电子邮件营销
   - 预订系统
   - 支付处理

2. 预期流量？
3. 需要多语言支持？
4. 需要特殊功能？

## 时间线和预算
1. 发布的截止日期？
2. 需要持续维护？
3. 预算限制？

站点审计访谈

# 站点审计问题

1. 您遇到了什么问题？
2. 您上次更新WordPress/插件是什么时候？
3. 您是否注意到性能问题？
4. 有特定页面有问题吗？
5. 您目前是否跟踪分析？
6. 您现在的托管是什么？
7. 您配置了备份吗？
8. 谁有管理员访问权限？

报告模板

审计报告

# WordPress站点审计报告

**站点**：[URL]
**日期**：[日期]
**审计员**：Claude Code

## 执行摘要
[2-3句话概述]

## 分数
| 类别 | 分数 | 目标 |
|----------|-------|--------|
| SEO | X/100 | 80+ |
| 性能 | X/100 | 80+ |
| 可访问性 | X/100 | 90+ |
| 安全 | X/10 | 10/10 |

## 重要问题
1. [问题1]
2. [问题2]

## 建议

### 高优先级
- [ ] 修复[问题]
- [ ] 实施[功能]

### 中等优先级
- [ ] 优化[方面]
- [ ] 配置[设置]

### 低优先级
- [ ] 考虑[改进]

## 下一步
1. [行动1]
2. [行动2]

交接文档

# 网站交接文档

## 登录信息
- **管理员URL**：[URL]/secure-login
- **用户名**：[单独提供]
- **密码**：[单独提供]

## 如何编辑内容

### 编辑页面
1. 登录到管理员区域
2. 点击左侧菜单中的"页面"
3. 找到您想要编辑的页面
4. 点击"编辑"
5. 进行您的更改
6. 点击"更新"保存

### 添加博客文章
1. 点击"文章" → "新建"
2. 输入标题和内容
3. 设置特色图片
4. 添加类别/标签
5. 点击"发布"

### 上传图像
1. 点击"媒体" → "新增"
2. 拖放文件或点击上传
3. 图像自动优化

## SEO指南
- 每个页面都应该有一个焦点关键词
- 元描述应该是120-160个字符
- 特色图片应该有ALT文本

## 支持
联系[您的代理]在[email]寻求帮助。

工作流集成

与Hooks一起

协调器可以自动触发其他技能：

# 示例工作流配置
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

与Claude Code斜杠命令一起

# 注册为技能
/wp-setup       # 开始新项目设置
/wp-audit       # 运行全面审计
/wp-optimize    # 性能优化
/wp-seo         # SEO审查和修复
/wp-visual      # 视觉QA截图

主题打包与分发

创建主题Zip

cd /path/to/project

# 删除旧zip
rm -f theme-name-*.zip

# 创建版本化zip（排除开发文件）
zip -r theme-name-1.0.0.zip theme-name \
  -x "*.git*" \
  -x "*node_modules*" \
  -x "*.DS_Store" \
  -x "*tests/*" \
  -x "*.env*"

导出演示内容

打包前导出当前内容：

WordPress管理员 → 主题设置 → 演示内容
点击"导出演示内容"
验证demo-content.json是否在主题文件夹中更新

GitHub仓库设置

cd /path/to/theme

# 初始化并推送
git init
git add .
git commit -m "Initial theme release v1.0.0"
gh repo create theme-name --public --source=. --push

# 推送更新
git add .
git commit -m "feat: description of changes v1.0.1"
git push origin main

WP Pusher部署（生产）

在生产站点上安装WP Pusher：

插件 → 添加新 → “WP Pusher” → 安装并激活
WP Pusher → 安装主题
输入仓库：username/theme-name
分支：main
点击"安装主题"

拉取更新：

WP Pusher → 主题 → 点击"更新主题"

自动部署（可选）：

WP Pusher → 主题 → 主题设置
启用"Push-to-Deploy"
复制webhook URL
GitHub仓库 → 设置 → Webhooks → 添加webhook
粘贴URL，选择"push"事件

演示内容系统

导出什么

数据	来源
页面	标题、内容、模板、slug
属性（CPT）	所有字段和元数据
Yoast SEO	焦点关键词、元描述、SEO标题
特色图片	重新下载的URL
主题选项	自定义设置
阅读设置	前页面配置

在新安装上导入

激活主题
设置向导第2步：“导入演示内容”
或：主题设置 → 演示内容 → 导入

WP-CLI导出/导入

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

# 触发导入
docker exec wordpress wp eval "csr_import_demo_content();" --allow-root

快速参考

常见协调器命令

用户说	协调器做
“设置一个新的WordPress站点”	`/wp-setup` → 发现访谈 → Docker/Playground → 安装插件
“审计这个站点”	`/wp-audit` → 并行运行所有审计技能 → 编制报告
“优化性能”	运行wp-performance → 应用修复
“检查SEO”	运行seo-optimizer → 显示问题
“拍摄截图”	运行visual-qa → 分析结果
“白标管理员”	运行white-label → 应用ASE + Branda设置
“准备启动”	`/wp-launch` → 运行所有检查 → 生成交接文档
“启动Docker WordPress”	复制wp-docker模板 → docker-compose up
“在Playground中测试”	运行wp-playground蓝图 → 打开浏览器
“打包主题以分发”	导出演示内容 → 创建zip → 推送到GitHub
“部署到生产”	设置WP Pusher → 连接GitHub → 拉取更新