用途:把 Kotlin 项目的代码规范检查变成可重复的工具证据,并诚实区分通过、失败、无法验证与 planned。适用于用户要求 lint、格式检查、自动修复、提交前质量验证,或 CI 出现 ./gradlew detekt 相关失败时。
主要能力:根据 .kt、.kts 与项目标记识别 Kotlin 工作区;执行 ./gradlew detekt 并保留退出码、作用域和工具版本;区分格式、静态规则、配置、依赖与环境类失败;使用 ./gradlew ktlintFormat 处理可逆问题并复扫;把本地结果与 CI、构建、测试证据分层汇报。
使用方式:在仓库根确认目标文件存在;用 ./gradlew --version 探测工具;先只读运行 ./gradlew detekt;将结果分为代码违规、配置缺失、工具缺失、工具内部错误;只对可安全修复项执行 ./gradlew ktlintFormat;复跑 lint 并执行项目已有测试与构建门禁。接入配置涉及 build.gradle、build.gradle.kts、settings.gradle、pom.xml,项目需配置 detekt / ktlint 插件。
限制:目标工具必须已安装且版本兼容,必须从正确仓库或模块根执行,自定义配置以已提交配置为准。不把 formatter 通过当作编译、测试或安全审计通过;不静默安装工具、升级依赖或修改团队规则;不用 suppress/ignore/调高阈值掩盖问题;缺少工具或配置时不得声称检查通过。本技能不收集、上传或存储用户代码和凭据,默认只读本地配置并运行本地工具,不联网安装依赖。自动修复前先检查 diff,破坏性或大范围修改须用户明确确认。
状态:stable(自 Codeguard V0.2)。