WordPress REST API 构建器

解决了什么问题

在 WordPress 里手写 REST 端点，开发者经常要在 register_rest_route() 的参数表、permission_callback 回调、以及 WP_REST_Request / WP_REST_Response 之间来回切换。一个看似简单的 /wp-json/my-plugin/v1/items 路由，实际上要同时处理：

• 路由注册与版本路径规划
• 请求参数校验（args 里的 type、sanitize_callback）
• 权限判断
• 响应对象的序列化与状态码

当端点数量变多，调试也变得棘手：路由优先级冲突、rest_get_server() 的输出差异、permission_callback 静默返回 false，都会让排查过程耗费大量时间。

技能如何工作

WordPress REST API Builder 围绕上述痛点，提供从路由定义到端点验证的引导式工作流。核心能力包括：

• 路由脚手架生成：根据资源名与版本前缀（如 /my-plugin/v1/items）生成 register_rest_route() 调用骨架
• 参数与校验配置：在 args 中声明请求参数类型，设置 sanitize_callback 与校验规则
• 权限回调编排：串联 permission_callback 与身份判定逻辑
• 端点调试：通过 rest_get_server() 与模拟 WP_REST_Request 验证路由响应

典型步骤：先描述资源与所需方法（GET / POST / PUT / DELETE），技能据此生成路由注册代码，再补全参数 schema、权限判断与响应格式化，最后在开发环境中逐端点验证。

适用边界与注意点

• 需要可用的 WordPress 开发环境（本地 wp-env、Docker 或线上 staging）与 OpenClaw 运行时
• 技能生成的代码需结合具体插件结构、命名空间与数据模型调整
• 上游项目无自动提取的安装说明，在敏感生产流程中运行前应先审查源码
• 详细参数与配置项仍以 WordPress 官方文档 为准