用途:在涉及 WordPress 运维时使用 WP-CLI,包括 wp search-replace(改 URL、域名迁移、协议切换)、wp db 导出/导入/重置/检查、插件与主题安装激活更新及语言包、cron 事件查看与运行、缓存与重写规则刷新、多站点操作(wp site *、--url、--network),以及构建可重复脚本(wp-cli.yml、shell 脚本、CI 任务)。
必要输入:确认 WP-CLI 运行环境(本地/预发/生产)及是否安全;用 --path=<wordpress-root> 定位站点根目录,多站点再加 --url=<site-url>;确认是否多站点及是否网络级执行;明确约束(不停机、不写库、维护窗口)。若在 WP Engine 上,SSH 网关、--ssh 与远程别名参见 wp-wpengine 技能,本技能专注 WP-CLI 操作模式。
流程:先确认环境与影响范围,写操作前备份;运行 node skills/wp-wpcli-and-ops/scripts/wpcli_inspect.mjs --path=<path> [--url=<url>] 检查定位;按场景选择工作流——安全迁移按 wp db export、wp search-replace --dry-run、正式替换、刷新缓存/重写的顺序;插件主题操作先确认目标站点与网络;cron 只调试单个事件而非盲目全跑;多站点明确单站(--url=)还是网络级(--network/遍历站点)。自动化优先用 wp-cli.yml 设默认值,脚本记录命令并在出错时停止,CI 默认只跑只读检查。
验证与限制:变更后重跑检查,确认 URL、插件主题状态、cron 与缓存符合预期,有健康检查或冒烟测试则运行。常见失败包括路径错误导致“不是 WordPress 安装”、多站点缺 --url 影响错站、search-replace 序列化问题。无法确认环境安全时不要执行写操作;容器化工具不可访问时需询问预期命令运行器。