SuperAPI AI 工具集

dotnet-stylelint

前端与建站

查看项目

更新于 10-16 06:44

技能介绍

用途:在同时包含 Web 前端的 .NET 仓库中,为 CSS、SCSS 等样式表资源引入 Stylelint 作为专门的样式检查门禁,用于语义化 CSS 与选择器策略检查,而非替代站点级审计。

触发条件:仓库存在 stylelint.config.、.stylelintrc,或前端目录下有 CSS、SCSS 资源;用户要求 CSS 检查、重复样式清理、命名规范约束或设计系统护栏;仓库需要格式检查之外的样式表门禁。

不适用:JavaScript 或 TypeScript 归属(交给 dotnet-eslint 或 dotnet-biome);运行时无障碍、性能、SEO 或响应头检查(交给 dotnet-webhint);已明确只用 Biome 做 CSS 检查且不想要独立样式检查器的仓库。

主要能力:确认 Stylelint 的归属范围(纯 CSS、CSS 加 SCSS、HTML/Markdown/框架文件中的内嵌样式);优先仓库本地安装与签入配置;从 stylelint-config-standard 等共享配置起步,仅在确有需要时添加语法专用包;在 package.json 中加入可重复脚本,例如 stylelint "/*.{css,scss}" 与 stylelint "/*.{css,scss}" --fix;显式维护忽略规则,避免构建产物、第三方资源与生成 CSS 干扰信号;自动修复按受控清理处理,先限定范围、检查 diff,若仓库编译样式则重跑前端构建。

缺失时引导:用 rg --files -g 'package.json' -g 'stylelint.config.' -g '.stylelintrc' 与 rg -n '"stylelint"|"stylelint-config-"' --glob 'package.json' . 检测现状;执行 npm install --save-dev stylelint stylelint-config-standard 本地安装;按需添加 SCSS 或内嵌样式语法包;创建或完善配置文件;用 npx stylelint "/*.{css,scss}" 与 npx stylelint "/*.{css,scss}" --fix 验证。

失败处理:未知规则通常意味着配置依赖插件或不同主版本;SCSS、Vue 或混合内容文件报未知词通常需要匹配的 customSyntax 包;大规模自动修复改动通常说明生成资源或第三方 CSS 混入检查目标;设计系统规则噪音应通过调整签入配置解决,而非整体跳过检查器。

17.5 指引:17.5.0 弃用 declaration-property-value-no-unknown 下的 *syntax 规则选项,应改用 customSyntax 或解析器选择;media-feature-name-value-no-unknown 新增 ignoreMediaFeatureNameValues;修复了 Node.js API 传入 codeFilename 时的 node_modules 忽略行为;no-descending-specificity、no-duplicate-selectors、declaration-property-value-keyword-no-deprecated 修复了误报,保留旧禁用前应重跑基线。

交付与验证:明确样式检查归属、签入配置与可重复命令、CSS/SCSS/生成资源的清晰边界;验证检查目标匹配真实样式源、忽略项排除生成或第三方资源、与 Biome 归属不冲突、修复已按样式构建流程验证。结果格式为 status、plan、actions_taken、verification、remaining。