SuperAPI AI 工具集

wp-block-themes

通用与其它

查看项目

更新于 10-16 07:22

技能介绍

用途:在开发 WordPress 区块主题时使用,处理 theme.json(预设、设置、样式、按区块样式)、模板(templates/.html)与模板部件(parts/.html)、图案(patterns/.php)、样式变体(styles/.json),以及排查“样式不生效”“编辑器未反映 theme.json”等问题。

主要能力:

  • 定位项目与区块主题根目录;
  • 创建新区块主题(或从经典主题转换);
  • 安全修改 theme.json 的 settings(UI 允许项)与 styles(默认外观);
  • 管理模板与模板部件(部件不得放入子目录);
  • 通过文件系统 patterns/ 定义主题自有图案并控制插入器显示;
  • 管理 styles/ 下的样式变体;
  • 调试样式层级:核心默认 → theme.json → 子主题 → 用户自定义。

必要用法与前置输入:需提供仓库根目录与目标主题目录(多主题时需指定)、目标 WordPress 版本范围(theme.json 版本随核心版本变化)、问题表现位置(站点编辑器、文章编辑器、前台或全部)。可运行 node skills/wp-project-triage/scripts/detect_wp_project.mjs 做项目分诊,运行 node skills/wp-block-themes/scripts/detect_block_themes.mjs 检测主题根与关键文件夹。

验证与限制:确认站点编辑器与前台按预期生效;样式不变时先排查用户自定义是否覆盖主题默认值。常见失败原因为编辑了未启用主题、用户自定义覆盖、theme.json 格式错误、模板/部件放错位置或部件嵌套。资料未提供安装命令、收费与价格信息。若上游行为不明确,可查阅 Theme Handbook 与 Block Editor Handbook。