用途:对 CSS / SCSS / Sass / LESS 项目执行代码规范门禁,把“看起来没问题”变成可重复的工具证据,并诚实区分通过、失败、无法验证和 planned。适用于用户要求 lint、格式检查、自动修复、提交前质量验证,或 CI 出现 Stylelint 相关失败时。
主要能力:根据 .css、.scss、.sass、.less 与项目标记识别工作区;执行 Stylelint 并保留退出码、作用域和工具版本;区分格式、静态规则、配置、依赖和环境类失败;对可逆问题执行自动修复并复扫;把本地结果与 CI/构建/测试证据分层汇报。
使用方式:在仓库根确认目标文件存在;探测工具 npx --no-install stylelint --version;先只读检查 npx --no-install stylelint '/*.css';将结果分为代码违规、配置缺失、工具缺失、工具内部错误;只对可安全修复项执行 npx stylelint '/*.css' --fix;复跑 lint 并执行项目已有测试/构建门禁。工具准备可用 npm install --save-dev stylelint stylelint-config-standard。
适用场景:检查或修复 CSS 系列代码规范;AI 修改样式文件后提交前验证;CI 出现 Stylelint 失败;判断问题能否自动修复或需人工处理。
限制:目标工具须已安装且版本兼容,须从正确仓库或模块根执行,以已提交配置为准;不静默安装工具、升级依赖或修改团队规则;不用 suppress/ignore/调高阈值掩盖问题;缺少工具或配置时不得声称检查通过;formatter 通过不等于编译、测试或安全审计通过;默认 **/*.css 不自动覆盖全部预处理器,需显式扩展 glob。本技能不收集、上传或存储用户代码和凭据,默认只读本地配置并运行本地工具,不联网安装依赖。自动修复前先检查 diff,破坏性或大范围修改须用户明确确认。