用途:对 Elixir 项目执行并诊断代码规范门禁,适用于用户要求 lint、格式检查、自动修复、提交前质量验证,或出现 mix credo --strict 相关失败时。先确认仓库配置与工具可用性,修复后必须复跑同一命令。
主要能力:根据 .ex、.exs 与 mix.exs 项目标记识别 Elixir 工作区;执行 mix credo --strict 并保留退出码、作用域和工具版本;区分格式、静态规则、配置、依赖与环境类失败;使用 mix format 处理可逆问题并复扫;把本地结果与 CI/构建/测试证据分层汇报。
使用方式:在仓库根确认 mix.exs 或目标文件存在;探测工具 mix --version;先只读检查 mix credo --strict;对可安全修复项执行 mix format;复跑 lint 并执行项目已有测试与构建门禁。项目级 gate 为 mix credo --strict。修复前检查 diff,破坏性或大范围修改需用户明确确认。输出采用 PASS、FAIL、UNVERIFIED、PLANNED 状态并分层报告。
适用场景:AI 修改 .ex、.exs 后的提交前验证;CI 出现与 mix credo --strict 相关的失败;判断某问题能否自动修复或必须人工处理。
限制:工具缺失或版本不兼容记为无法验证,不等于通过;formatter 通过不代表编译、测试或安全审计通过;不静默安装工具、升级依赖或修改团队规则;不用 suppress、ignore 或调高阈值掩盖问题;不覆盖项目已有 ignore、dialect、target 或版本约束。需从正确仓库或模块根执行,生成代码与 vendor 目录是否扫描遵循仓库规则。不收集、上传或存储用户代码与凭据,默认只读本地配置并运行本地工具,不联网安装依赖。
分类依据其代码规范与质量门禁用途归入测试与质量。