WordPress 安全运维 WP-CLI 工作流 Skill 技能

技能简介

WordPress 是全球部署量最大的 CMS 系统，但其后台界面操作难以批量执行、难以复用、难以审计。WP-CLI 是 WordPress 官方提供的命令行工具，可以完成插件更新、数据库迁移、站点检查等一切操作，但直接跑命令风险极高——一条错误的 search-replace 可能让整站图片失效，一条 bulk update 可能把业务高峰期的站点打崩。

本技能来自 WordPress 生态核心贡献者 Automattic 团队，为 Claude Agent 提供一套有保护措施的 WP-CLI 工作流。技能内置多步确认、试运行（dry-run）、备份触发、环境识别等安全机制，确保每一次写操作都经过显式授权，每一条命令都有日志记录，每一个危险操作都有回滚路径。

核心能力

1. 环境探查：自动检测 WP-CLI 可用性、WordPress 根目录、核心版本、多站点（Multisite）状态、站点 URL 配置，命令执行前先搞清楚目标是谁、在哪、有没有多站点层。

2. 数据库操作保护：支持导出、导入、重置、search-replace 四类数据库操作，每一类都强制要求先做备份、先跑试运行、等用户确认后再正式执行，防止 URL 替换失误导致图片/附件批量失效。

3. 插件与主题管理：批量更新插件和主题时可预览变更范围，识别与生产环境不兼容的版本跳变，在真正写入前停下等人工确认。

4. Cron、缓存与重写规则：查看和清理定时任务、清除各类缓存（Object Cache、OPcache、CDN 缓存）、刷新永久链接规则，适合在更新发布后做健康检查。

5. 多站点（Multisite）精确靶定：区分单站点、网络全局两种作用域，指定 --url 参数确保命令作用在正确的子站或主站，防止误操作影响整个网络。

6. CI/CD 预留集成：提供 Jenkins/GitHub Actions 中的 WP-CLI 调用模板，含日志记录、写保护开关（--dry-run）、显式 apply 确认环、完成后健康检查，适合纳入发布流水线。

安装配置

1. 安装依赖：确保目标机器已安装 WP-CLI（≥2.8.0）和 Node.js（≥18）。在终端运行 wp --info 验证安装。

2. 通过 Skillstore 安装：在 Claude Code 或 Agent 终端执行 npx skillstore add automattic/wp-wpcli-and-ops，技能文件将写入本地 .claude/skills/ 目录。

3. 验证安装：运行技能提供的探查 Prompt，传入目标 WordPress 安装路径，技能会返回版本、URL、Multisite 状态，不做实际修改。

使用步骤

1. 第一步：探查站点状态 向 Agent 发送 Prompt：「Inspect the WordPress site at [path] using WP-CLI. Report its version, multisite status, URLs, and targeting problems. Do not make changes.」 技能会返回完整的站点配置快照，确认目标正确后再继续。

2. 第二步：规划操作并申请授权 发送操作目标（如：迁移域名 / 更新所有插件 / 导出数据库），技能会输出操作计划，含备份要求、试运行命令、危险操作标记，等待用户在终端输入 yes 确认。

3. 第三步：执行试运行 用户确认后，技能先跑 --dry-run 模式，演示会做什么但实际不动数据，检查输出结果是否符合预期。

4. 第四步：正式执行与验证 试运行结果满意后，技能执行真实命令，最后检查站点健康状态（版本、URL、缓存、Cron）并报告结果。

适用场景

1. WordPress 站点域名迁移：需要同时替换数据库内所有旧域名为新域名，URL 替换错误会导致图片/附件链接全部失效。本技能提供多步试运行、备份触发、迁移后健康检查的完整流程。

2. 生产环境插件批量更新：在业务低峰期更新插件，担心版本跳变导致兼容问题。技能在更新前列出所有待更新项及版本变化，用户逐个确认后才执行写入。

3. WordPress Multisite 网络运维：管理一个包含数十个子站的 Multisite 网络，需要对特定子站执行维护操作而不能影响其他站点。技能自动识别多站点结构，精确靶定目标站点。

4. 纳入 CI/CD 发布流水线：在 GitHub Actions 中运行站点的自动化测试和部署，技能提供带日志、保护开关和健康检查的 CI 模板，防止发布流程自动执行危险操作。

适用人群

• 负责 WordPress 站点运维的开发者和 DevOps 工程师
• 管理多个 WordPress 站点的技术负责人
• 需要在 CI/CD 环境中安全操作 WordPress 的自动化流水线开发者
• WordPress 主题/插件开发者，需要在本地和스테이징 环境验证兼容性

工作原理

本技能并非直接操作 WordPress，而是为 Claude Agent 提供一套经过安全设计的 Prompt 模板和工作流规范。技能内部维护一套「危险分级」规则：

• 读取操作（wp plugin list、wp site list）：可直接执行
• 试运行操作（加 --dry-run 参数）：展示意图，用户确认后才继续
• 写操作（wp plugin update、wp db import）：强制要求：① 已有备份；② 用户输入 confirm 显式授权；③ 完成后触发健康检查

通过这种方式，即使 Agent 在复杂的多站点环境中运行，也能保证每一次写操作都有人的参与。

官方链接

• Skill 主页：https://skillstore.io/skills/automattic-wp-wpcli-and-ops
• 安装命令：npx skillstore add automattic/wp-wpcli-and-ops
• GitHub 源码：https://github.com/Automattic/agent-skills/tree/trunk/skills/wp-wpcli-and-ops