用途：对 Java 项目执行代码规范门禁并诊断结果，把主观判断转为可重复的工具证据，明确区分 PASS、FAIL、UNVERIFIED、PLANNED。适用于用户要求 lint、格式检查、自动修复、提交前验证，或 CI 出现 mvn -q javadoc:jar -DskipTests 相关失败时。
主要能力：依据 .java 与 pom.xml、build.gradle 等标记识别 Java 工作区；执行 mvn -q javadoc:jar -DskipTests 并保留退出码、作用域与工具版本；将失败分为格式、静态规则、配置、环境、工具内部错误；用 mvn -q spotless:apply 处理可逆问题并复扫；分层汇报 lint、format、compile、test、security 证据。
使用方式：先在仓库根确认 pom.xml、build.gradle 或目标文件存在，探测 mvn --version，再只读运行 mvn -q javadoc:jar -DskipTests；读取 pom.xml、build.gradle、build.gradle.kts、settings.gradle 及 CI 实际命令，仓库配置优先；仅对可安全修复项执行 mvn -q spotless:apply，修复后必须复跑原命令并运行项目已有测试与构建。
适用场景：检查或修复 Java 代码规范；AI 修改 .java 后提交前验证；判断问题能否自动修复或需人工处理。
限制：不把 formatter 通过当作编译、测试或安全审计通过；不静默安装工具、升级依赖或修改团队规则；不用 suppress/ignore 掩盖问题；工具缺失或配置无法加载时记为 UNVERIFIED，不得声称通过。不适用于语言语法学习、框架设计、业务建模及依赖漏洞、安全审计、许可证治理。本技能不收集、上传或存储用户代码与凭据，默认只读本地配置并运行本地工具，不联网安装依赖；破坏性或大范围修改须用户明确确认。JDK 版本会影响 doclint 严格度，本地与 CI 应使用同一主版本。