技能介绍

问题从哪来

在终端里用 curl 直接调 WordPress REST API 时，最容易踩坑的是误发上线、误删文章和把应用密码写进命令历史。SKILL.md 里写得很直白：作者第三次手抄博客到终端之后，决定把流程固化成脚本。

技能怎么工作

所有操作走 scripts/wp.sh：统一鉴权、JSON 处理，并内置安全规则。

默认草稿：POST 创建文章时强制 status: draft，除非 JSON 里显式带 "status":"publish" 且调用方确认意图。
不硬删：用 PUT posts/ID 把状态改为 trash，不用 DELETE。
凭证：WP_URL、WP_USER、WP_APP_PASSWORD 从 .env 读取，命令里不硬编码。

常见流程包括：草稿博文/页面、列表查询、分类与标签、scripts/wp-upload.sh 上传媒体（返回 ID 供 featured_media 使用）、插件安装与列表、以及 Yoast 下的 yoast_head_json / post meta。正文可走 HTML 或 Gutenberg 块注释格式，便于和块编辑器对齐。

出错时按状态码排查：401 查用户与应用密码，403 查能力权限，404 查 URL 与路径；rest_cannot_create 多与 REST 开关或角色有关。更细的端点与 SEO 模式见资料中的 reference 文档。

适用边界

这是运维向的 API 封装，不是 WordPress 主题开发或 PHP 插件编写指南。未安装 Yoast 时，SEO 相关字段可能无效。与 coding-agent 搭配可先生成内容再草稿发布；与 outlook-hack 同属「浏览器/终端中继」一类工作流，但本技能只覆盖博客站点侧。