SuperAPI AI 工具集

wp-theme-development

编程与开发

查看项目

更新于 10-15 23:41

技能介绍

用途:对 WordPress 6.6+ 主题做系统性代码审查,主攻区块主题(全站编辑),并附带经典主题向区块主题迁移的指导。核心前提是主题范式已转变:区块主题用 HTML 模板加区块标记、以 theme.json 作为全局设置与样式的唯一来源,取代 PHP 模板与 add_theme_support() 调用。

主要能力:校验 theme.json v3 结构与 schema(version 必须为 3,v1 视为严重、v2 建议升级;检查 settings、styles、templateParts、customTemplates、$schema、useRootPaddingAwareAlignments 等);审查模板层级(区块主题 templates/index.html 必需,经典主题 index.php 必需);检查模板部件(parts/header.html、footer.html、sidebar.html)与 theme.json 注册是否一致;分析全局样式、样式变体(styles/.json)、主题内区块图案(patterns/.php)、子主题兼容性;检测硬编码样式;评估 WordPress.org 提交就绪度。

使用方式:按七步流程执行——识别主题类型与上下文、校验 theme.json、检查模板层级、检查模板部件、扫描严重/警告/提示模式、按上下文调整严重级别、按文件分组报告(含行号与 BAD/GOOD 对照)。可用 shell 与 rg 命令快速检测,例如 [ -f templates/index.html ] && [ -f theme.json ] 判断区块主题,grep -q "^Template:" style.css 判断子主题。

适用场景:区块主题审查、theme.json 校验、模板层级审计、模板部件与全局样式分析、样式变体校验、区块图案审查、子主题兼容检查、经典转区块迁移评估、WordPress.org 提交准备。

限制:不用于区块编辑器组件(React/JSX)审查、插件架构审计、纯安全或纯性能审计、WooCommerce 主题集成、视觉设计评估。发现安全、插件式或区块标记问题时,会建议转用相应专项审查。本技能仅做代码审查,不做 UI/UX 评审。