用途:审查 WooCommerce 代码改动是否符合其编码规范与约定,适用于本地代码审查、自动化 PR 审查以及代码质量检查。
主要能力:标记后端 PHP 代码中的关键违规,包括架构与结构(禁止独立函数、src/ 中由依赖注入管理的类须用 $container->get()、类默认放在 src/Internal/ 除非明确公开)、命名与约定(方法/变量/钩子须用 snake_case、遵循 WordPress 编码标准的 Yoda 条件)、文档(公共/受保护方法与钩子须有 @since、所有钩子与方法须有 docblock、docblock 应简洁)、数据完整性(删除或修改前须验证状态)、测试(测试中用 $sut 而非 $instance、测试方法 docblock 须含 @testdox、测试文件命名须符合 includes/ 与 src/ 的约定)。同时依据文案指南标记 UI 文案问题:标题式大小写须改为句子式大小写,如 "Save changes"、"Order details"、"Payment options",专有名词、缩写和品牌名除外。
使用方式:扫描上述关键违规,标记问题时引用具体技能文件,给出技能文档中的正确示例,将相关问题分组,并说明标准存在的原因。输出格式为:❌ [问题类型]:[具体问题]、位置:[文件路径与行号]、标准:[相关技能文件链接]、修复:[简要说明或示例]。
限制:详细标准位于 woocommerce-backend-dev、woocommerce-dev-cycle 和 woocommerce-copy-guidelines 技能中,需查阅这些技能获取完整上下文与示例;有疑问时参考上述具体技能文档。