用途：对 Groovy 项目执行并诊断代码规范门禁，把主观判断转成可重复的工具证据，并诚实区分 PASS、FAIL、UNVERIFIED 与 PLANNED。适用于用户要求 lint、格式检查、自动修复、提交前验证，或 CI 出现 npm-groovy-lint '{file}' 相关失败时。
主要能力：识别 .groovy 文件与 build.gradle、build.gradle.kts、pom.xml 等项目标记；运行 npm-groovy-lint '{file}' 并保留退出码、作用域与工具版本；把失败分为格式、静态规则、配置、环境和工具内部错误；用 npm-groovy-lint --fix 处理可逆问题并复扫；将 lint、format、compile、test、安全证据分层汇报。
必要用法：先在仓库根探测 npm-groovy-lint --version，只读检查用 bash -c 'find . -name '.groovy' -type f -not -path '/node_modules/*' -print0 | xargs -0 -r npm-groovy-lint --no-insight'，修复用 npm-groovy-lint --fix，随后必须复跑原命令及项目已有测试与构建。工具缺失记为 UNVERIFIED，不得静默安装或声称通过。
适用场景：检查或修复 Groovy 代码规范；AI 修改 .groovy 后的提交前验证；判断问题能否自动修复；需要按退出码与工作目录留证的 CI 诊断。
限制：不把 formatter 通过当作编译、测试或安全审计通过；不静默安装工具、升级依赖或修改团队规则；不用 suppress、ignore 或调高阈值掩盖问题；仓库配置优先于技能示例；生成代码、vendor 与缓存目录需按仓库规则处理；Groovy 动态特性使静态 lint 覆盖有限，Gradle/Jenkins DSL 需结合宿主验证。技能不收集或上传用户代码与凭据，默认只读本地配置并运行本地工具，不联网安装依赖，自动修复前需检查 diff。