用途:在审查 Gutenberg、插件或应用界面时,判断其是否正确使用 WordPress Design System,包括自定义 UI。
主要能力:识别重复推荐组件的自定义控件(如通知、按钮、对话框、菜单);发现应遵循设计系统的硬编码颜色、间距、圆角、字体和阴影;判断语义令牌 --wpds-* 与 --wp--preset--* 是否用于正确目的;标记对包私有路径、私有类或标记的依赖;检查自定义控件或组合中的无障碍问题(可访问名称、键盘行为、焦点指示与处理);检查渲染目标处样式或主题丢失;对照 Storybook 或包文档判断组件是否超出文档用途。
使用方式:在 Gutenberg 检出中读取相对链接;在检出外从 GitHub 的 .agents/skills/design-system-ui-review/ 解析。先阅读 Working with WordPress Design System packages,检查变更的 UI、样式及受影响的消费者。混合包与消费者变更时,对包源码同时使用 design-system-code-review。可用 Design System MCP 服务器的 get_components 与 get_component_details 验证推荐组件的行为、props 和导入;无 MCP 时使用指南的推荐来源。可用 get_design_tokens 查找语义令牌;无 MCP 时使用令牌参考。
适用场景:Gutenberg、WordPress 插件或应用的前端 UI 审查,尤其是涉及设计系统包或自定义 UI 的变更。
限制:不要请求无关清理,也不要为窄范围文案或 prop 编辑迁移现有受支持组件;因变更导致的下游破坏仍在范围内。不要仅因缺少覆盖就要求测试,仅针对具体且有意义的回归风险要求本地测试。应指出已验证的组件或令牌及其改进,合并可被同一替换解决的发现;若正确结果是识别设计系统缺口,不要编造替换方案。外部项目使用不同包或 WordPress 版本时,遵循指南的目标版本检查;替换时使用其契约比较,包括外部扩展点。