SuperAPI AI 工具集

wp-abilities-audit

通用与其它

查看项目

更新于 10-16 07:22

技能介绍

用途:针对 WordPress 插件暴露的 REST 接口生成标准化审计文档,作为实施前的规划产物,记录控制器清单、能力门禁与拟注册 Abilities API 的形态,便于审查者直接界定工作量。适用于为插件注册 Abilities、多插件能力推广的规划协作、实施前检查插件 agent 就绪度,以及非实施者先行评估范围。

主要能力:枚举 REST 控制器并记录类、文件、REST base 与路由;提取 HTTP 方法、路由注册行号、回调名与行号、权限回调、回调是否接收 WP_REST_Request、返回类型等字段;追踪权限回调到 current_user_can() 或文章类型能力机制;按语义意图分组提出能力,而非按每个 HTTP 方法拆分;标记排除项、暴露缺口与每个能力的风险;输出符合审计 schema 的 Markdown 文档,含 YAML 元数据、Controller Inventory 表与 Notes and Surprises 段落。

使用方式:需先运行 wp-project-triage 并成功分类插件,输入插件检出路径、审计者身份与显式输出路径;随后按文档流程枚举控制器、提取字段、确认能力门禁、提出能力、整理缺口并写出文档,可选指定 reference_ability: true。

限制:插件需至少有一个 REST 控制器,否则审计不适用;继承自其他仓库的控制器需标注 inherited_from,行号字段可为 null;区分读写的能力门禁用 {read, write} 对象表示;零参数且 permission_callback => '__return_true' 的端点不得照搬进能力注册;输出路径须显式询问,避免写入插件工作树。