SuperAPI AI 工具集

woocommerce-finalize

编程与开发

查看项目

更新于 10-15 17:21

技能介绍

用途:在 WooCommerce 插件发布前做代码健康与可追溯性审计。该技能在代码评审之后运行,UX 合规与安全审计由其他检查清单负责,不在此重复。

依赖参考:运行前需阅读 references/coding-standards.md(WordPress PHP 编码标准)、references/security.md(安全基线与数据库模式)、references/woocommerce-apis.md(HPOS、CRUD、数据存储、支付网关模式)、references/ux-guidelines.md(UX/文案约定)。

流程:先定位插件根目录(含 Plugin Name: 头的主 PHP 文件),建立文件清单,识别架构(经典 PHP+jQuery、React+REST 或混合),映射 WooCommerce 集成点,检查自定义文章类型、分类法、表、REST 端点、AJAX 处理器。若有根目录下的 testing-report.md,需为 12 小时内且状态通过、PHPStan 等级 7 或以上;否则建议先运行测试套件。

两条评审轨道:一、代码健康,查找未被调用的函数、未使用导入/变量、超过 3 行的注释代码块、return/throw/exit/die 之后不可达代码、无用私有方法;相似度超过 80% 的函数、跨文件复制块、重复内联 SQL、雷同 AJAX/REST 处理器;超过 50 行的函数、嵌套超过 3 层、超过 10 个公共方法或 300 行的上帝类、职责混杂的类、类间循环依赖。二、可追溯性,沿 UI→AJAX/REST→业务逻辑→数据访问→数据库追踪每个交互,核对连接存在性、签名、参数命名、序列化对称性与空值处理;支付插件还必须追踪支付、退款、设置、令牌、Webhook 五条路径。报告分已验证、断裂、可疑路径。

产出:finalization-tasks.md,含 Critical/High 等优先级,任务编号 TASK-OPT-### 与 TASK-TRC-###,每项含文件、行号、问题、修复建议与状态。限制:不做 UX 与安全审计;证据不足应标注为不确定;管理员面向与客户面向代码的严重度加权不同;不给出价格与平台信息(资料暂未提供)。