WP Abilities API

要解决的问题

WordPress 插件生态里一直缺少一套统一的能力声明机制。传统做法是各自维护 admin_menu、rest_api_init、init 等钩子，能力边界模糊，排查问题时很难快速判断某个功能究竟由哪个模块提供、依赖哪些前置条件。Abilities API 试图用声明式的方式把能力（ability）的注册、暴露与调用规范统一起来，但缺少配套的工程化工具时，开发者要手写大量样板代码，调试阶段还得反复核对钩子执行顺序和能力元数据。

这个技能做什么

该技能围绕 Abilities API 的三个核心环节提供支持：

• 定义能力：协助按 API 约定编写能力注册逻辑，包括名称、描述、参数 schema 和权限回调
• 暴露能力：梳理能力如何通过 Abilities API 暴露给调用方，检查元数据完整性
• 调试能力：针对能力无法被发现、权限校验失败、参数不匹配等典型问题，给出定位路径

典型的排查思路是先确认能力是否已正确注册，再核对暴露阶段的元数据是否符合规范，最后通过调用链定位权限或参数层面的阻断点。

适用边界

技能本身只覆盖 Abilities API 的工程实践，不替代 WordPress 核心或插件层面的运行时环境。它假设目标环境已具备：

• 可用的 WordPress 安装，且 PHP 版本满足 Abilities API 要求
• 通过 Composer 管理依赖的能力，依赖包需自行验证来源

SKILL.md 中未提供经过验证的安装命令，首次接入前应先审阅上游仓库的代码与文档，确认与现有插件架构兼容后再引入敏感工作流。