Agent Skills
返回列表
💻

WordPress 主题.json 设计令牌管理器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_3c6cb52e/wp-theme-json-design-token-manager

技能介绍

解决的问题

WordPress 的 theme.json 文件控制着整个站点的设计系统,但手动维护颜色调色板、字体预设与间距刻度往往非常繁琐,且容易在多次覆盖和继承中产生冲突。当主题和插件都在修改这些全局样式时,开发者很难追踪最终生效的设计令牌是什么。

核心能力与工作流

该技能通过封装 WordPress 原生的解析机制,将设计令牌的管理标准化。在执行过程中,它主要依赖两个关键接口进行动态令牌解析:

  • WP_Theme_JSON_Resolver:负责读取并合并来自 WordPress 核心、主题及插件的 theme.json 配置,理清不同层级的继承关系。
  • wp_get_global_settings():获取当前环境最终解析出的全局设置,确保开发者能够拿到精确生效的排版和颜色数据。

适用边界与注意点

此技能专注于读取和解析设计令牌,不涉及直接修改主题文件。由于目前上游项目尚未提供经过源码验证的详细安装与使用说明,建议在将其接入敏感工作流之前,务必审查上游代码库的具体实现。此外,使用 wp_get_global_settings() 需要特定版本的 WordPress 环境支持,请确保你的运行环境满足这些原生条件。

使用场景

  • 排查主题颜色冲突时,需用技能解析当前生效的调色板来源
  • 检查字体预设冲突时,要求动态获取wp_get_global_settings的解析结果
  • 迁移设计系统时,需要读取主题所有间距刻度配置
  • 审查插件样式覆盖时,定位被插件修改的字体预设项

适合人员

  • 需要排查主题样式冲突的WordPress主题开发者,想快速定位设计令牌覆盖来源
  • 负责迁移WordPress站点设计系统的前端工程师,需完整读取现有主题的令牌配置
  • 开发WordPress插件且需适配主题样式的开发者,要获取当前生效的全局设置
  • 审查主题设计规范一致性的设计师,需核对字体和间距令牌的实际取值