SuperAPI AI 工具集

woo-guard

通用与其它

查看项目

更新于 10-15 16:48

技能介绍

woo-guard 是一个面向 WooCommerce 代码的守卫型技能,用于在代码上线前审查 AI 生成或修改过的 WooCommerce 代码,覆盖扩展、支付与配送集成、结账定制、订单与商品逻辑等。它强调 WooCommerce 是持续演进的平台,旧有写法容易过时,因此按用途提供多种模式:守卫模式(推荐)在代码生成或修改后对 diff 或目标文件套用规则并自检;实时模式在写 WooCommerce 代码前调用;审查模式则走 references/review-checklist.md 生成结构化问题报告,除要求外不修改代码。

主要能力围绕规则组展开。订单与商品数据必须走 CRUD API:wc_get_order()、wc_get_orders()、$order->get_meta()、$order->update_meta_data() 与 $order->save();禁止对订单用 get_post_meta()、update_post_meta()、以 post_type => shop_order 查询或直接联表 postmeta。商品、客户、优惠券也走各自 CRUD 对象后 save(),库存与订单状态变化走对应专用方法。扩展须声明 HPOS 兼容性,触及结账的须声明 cart_checkout_blocks 兼容性。结账与金额方面,验证须在服务端完成(woocommerce_checkout_process 或 Store API 扩展 schema),金额不用浮点,用 wc_format_decimal()、wc_price() 及 WooCommerce 税费与舍入设置。运行时须防护 WC()->cart 与 WC()->session 在 REST、cron、CLI 等上下文的空值,并确认钩子与函数在支持版本内存在;优先用钩子而非模板覆盖;后台任务走 Action Scheduler 并保持幂等。安全底线包括全输出转义、输入先去斜杠再净化、状态变更做权限与 nonce 校验、含变量的查询用 $wpdb->prepare()。

使用方式以守卫、实时、审查三种模式为主,交付前运行自检清单,检查 diff 中是否出现订单相关的 get_post_meta 等禁用写法、是否绕过 CRUD save()、是否声明兼容性、结账规则是否服务端执行、是否对金额用浮点或 number_format()、是否存在可能运行在 REST/cron/CLI 的 WP 上下文访问、是否随插件附带模板文件,以及安全底线是否满足。审查模式按文件分组、优先列出 Rules 1–5 发现的问题。

限制方面,该技能不覆盖 WordPress 完整层(若已安装 wp-guard,i18n 与资源/查询纪律归其管辖),不审查店铺配置、主题样式或支付服务商账号设置,也不决定定价或业务逻辑,只守护 WooCommerce 代码如何交付。分类标识为 coding。