技能介绍

要解决的具体问题

在 WordPress 中扩展 REST API 时，开发者往往会陷入几个反复出现的困境：路由注册看似简单，但 register_rest_route 的参数配置稍有偏差就会导致端点行为异常；schema 定义不严谨会让前端拿到结构混乱的数据；permission_callback 设置不当则可能留下越权访问的隐患。当这类工作由 AI 代理主导时，问题更明显——代理很容易跳过 schema 验证、认证逻辑或权限回调等关键细节，直接给出“能用但脆弱”的实现。

核心能力与工作方式

这个技能围绕 wp-rest-api 的工程实践展开，帮助代理完成自定义 REST 路由的完整生命周期：

路由设计与注册：根据业务需求规划端点结构，正确调用 register_rest_route 并设置 methods、callback 等参数
Schema 定义与验证：为请求参数和响应数据编写清晰的 schema，确保数据格式一致、校验可靠
权限防护：通过 permission_callback 实现细粒度的访问控制，结合认证机制防止未授权调用
调试与排错：定位路由未命中、回调异常、权限拒绝等常见问题，区分是配置问题还是逻辑缺陷

技能强调“不跳过细节”，每一步都会覆盖 schema、auth 和 permission 的具体要求，适合在插件、主题或核心相邻代码库中做端点级开发。

适用边界与注意点

这个技能的定位是代理主导的端点开发工作流，不是用来浏览或消费 WordPress REST API 作为产品目录的工具。它假设你已经有了 WordPress 代码库的访问权限，熟悉 PHP，并且最好有 WP-CLI 用于本地验证。如果你需要的是快速查看某个站点暴露了哪些 REST 端点，或者想做一个 REST API 浏览器，这个技能并不适合。