SuperAPI AI 工具集

css-debug

前端与建站

查看项目

更新于 10-16 00:01

技能介绍

用途:css-debug 是一个系统化 CSS 调试技能,帮助开发者按流程定位并修复 CSS 问题,而不是靠猜测。它把问题分为特异性、继承、布局、层叠、自定义属性、包含与性能等类别,并给出对应的诊断技术。

主要能力:

  • 特异性分析:计算选择器权重,检查源码顺序、@layer 与 !important 的影响,用 :where() 归零或 @layer 控制优先级。
  • 继承追踪:沿 DOM 向上查找继承属性来源,并区分不继承属性(如 background、border、padding、display、opacity)。
  • 布局调试:诊断溢出、意外尺寸、外边距折叠,检查 box-sizing、flex/grid 尺寸、min-width 与 contain。
  • 层叠上下文:列出创建层叠上下文的条件,强调 z-index 只在同一上下文内比较,可用 isolation: isolate 建立显式上下文。
  • 自定义属性:追踪 --var 声明、继承、@property 注册与 var() 回退。
  • 性能:识别布局抖动、CLS 与绘制开销,建议只动画 transform/opacity,使用 contain、content-visibility 与 aspect-ratio。

使用方式:按六步工作流执行——分类问题、隔离范围、应用诊断技术、定位根因、应用修复、验证无回归。隔离时可用 outline 技术,例如 * { outline: 1px solid red; },或给元素加 data-debug 属性配合 [data-debug] 规则可视化盒模型;outline 不影响布局,优于 border。输出采用结构化诊断格式:BUG、CATEGORY、ROOT CAUSE、FILE、BEFORE、AFTER、WHY。

适用场景:样式被覆盖、子元素值异常、页面横向滚动、元素尺寸错误、z-index 失效、变量不解析、动画卡顿与 CLS 等。

限制:资料未提供安装命令、平台支持、收费与价格信息;该技能依赖人工或 AI 按流程诊断,不保证自动修复所有问题。