用途:验证 WordPress 插件中 Abilities API 的注册。核心是“对抗性标注正确性检查”:若某能力标注 readonly:true,其回调却通过 $wpdb->update、update_option 或非 GET 委托等实际写入,会带来安全与 UX 风险,因为智能体会依据标注来规划动作。该技能通过阅读回调体,比对实际行为与标注声明来发现问题。
主要能力:
- 静态模式下从插件检出目录运行,无需环境:通过源码枚举能力、执行标注正确性检查、运行 schema 与权限 lint,并校验审计文档。
- 运行时模式需要可运行环境,额外通过 wp_get_abilities() 权威枚举,用精选输入执行每个能力,针对真实用户确认权限往返,并对 idempotent:true 能力运行双次调用启发式检查(返回值相等仅作信号,不作定论)。
- 两种模式输出相同的结构化报告格式。
必要用法与输入:需要插件检出路径;模式(static 或 runtime,默认 static);运行时模式需环境启动命令(应读取插件 AGENTS.md,常见如 npm run wp-env start,但不可假设其可用);可选审计文档路径;报告输出路径。前提是已运行 wp-project-triage,且源码中至少有一个已注册能力(零命中应返回“无能力注册”报告,而非空 PASS)。
检查内容:静态枚举 wp_register_ability() 调用及其注解与回调;对抗性核对 readonly 不得写库/文件系统/定时任务/非 GET 委托,destructive:false 不得删除或作废,idempotent:true 重复调用不得对环境产生额外影响;权限回调按六种形态分类;六条 schema 规则;错误码词汇表比对。误报可用 // verify-ignore: <annotation> -- <reason> 注释抑制。
限制:静态模式 PASS 仅表示“无明显形态违规”,不等于已验证无写入;高风险插件应在合并前运行运行时模式。运行时模式需环境可达,否则不应静默回退静态。令牌预算测量属于另一独立验证维度,不在本技能的 PASS/FAIL 判定范围内。分类依据其用于插件能力验证与安全检查,归入安全与审计。