用途：面向 WordPress 区块主题开发，处理 theme.json（预设、设置、样式、按区块样式）、templates/.html 模板与 parts/.html 模板部件、patterns/.php 图案及其在插入器中的显示控制、styles/.json 样式变体，以及“样式不生效”“编辑器不反映 theme.json”等调试。
用法：先运行 node skills/wp-project-triage/scripts/detect_wp_project.mjs 做项目甄别，再运行 node skills/wp-block-themes/scripts/detect_block_themes.mjs 探测主题根与关键目录；多主题时选定一个并限定改动范围。新建主题优先使用可靠脚手架，并明确最低支持的 WordPress 版本。注意样式层级：核心默认 → theme.json → 子主题 → 用户自定义，用户自定义可能让 theme.json 改动看似被忽略；styles/ 下样式变体一旦被用户选择会存入数据库，改文件不一定会自动更新显示。模板放在 templates/，模板部件放在 parts/ 且不得嵌套子目录。
限制：需提供仓库根、目标主题、WordPress 版本范围与问题出现的界面；上游行为不明时查阅 Theme Handbook 与 Block Editor Handbook。