SuperAPI AI 工具集

abilities-api-implement

编程与开发

查看项目

更新于 10-16 01:13

技能介绍

用途:把 WooCommerce 扩展从“尚未注册任何 ability”推进到“草稿 PR 已开、能力面已验证”,过程消费上游 wp-abilities-audit 生成的审计文档。硬性前置:必须有可解析的有效审计文档,否则报错退出;前置校验失败即停止,不做部分脚手架。

主要能力:创建 Abilities_Registrar 协调器与 Domain 抽象基类;按“先参考能力、再读、最后写”的顺序每个 ability 一个原子提交;生成覆盖形状、权限、执行路径的单元测试;运行集成校验并留存 Markdown 产物;按目标仓库自身 PR 模板开 PR。仅到 push + PR 为止,不发布到 issue tracker 或聊天工具,不支持从中断处续跑。

使用方式:在扩展工作树内执行 /woocommerce:abilities-api-implement <审计文档路径>;不传参数时自动在 plans/ 下探测最近的 abilities-audit.md。

关键约定:采用 WC 10.9 的 AbilityDefinition 与 woocommerce_ability_definition_classes 加载器形态;结构门为 \Automattic\WooCommerce\Internal\Abilities\AbilitiesLoader 的 class_exists() 检查;发布期安全网为按插件的 <plugin_slug>_abilities_enabled 特性开关,默认关闭。分类沿用共享的 woocommerce slug,由 Woo Core 持有,不重复注册。读能力默认 Shape 3(共享服务);Shape 2(经 delegate_to_rest_controller 委派 REST)仅作明确评审后的例外;写能力强制 Shape 3。

限制:loader-only,WC < 10.9 不提供 polyfill 或回退注册;非 Woo 插件族(如 Jetpack 族、通用 WordPress 插件)不在范围内;脚手架前需先阅读 references 下多个参考文档;写入能力上线需通过行为、权限、服务路径、注解四项显式审查,存在未知即暂停。具体安装命令与官方收费信息暂未提供。