用途:对 Crystal 项目执行并诊断代码规范门禁,把“看起来没问题”变成可重复的工具证据,并诚实区分通过、失败、无法验证和 planned。适用于用户要求 lint、格式检查、自动修复、提交前质量验证,或 CI 出现 ameba 相关失败时。
主要能力:根据 .cr 与 shard.yml 识别 Crystal 工作区;执行 ameba 并保留退出码、作用域和工具版本;区分格式、静态规则、配置、依赖与环境类失败;用 crystal tool format 处理可逆问题并复扫;把本地结果与 CI、构建、测试证据分层汇报。
使用方式:在仓库根确认 shard.yml 或目标文件存在;探测 ameba --version;先只读运行 ameba;将结果分为代码违规、配置缺失、工具缺失、工具内部错误;只对可安全修复项执行 crystal tool format;复跑 lint 并执行项目已有测试与构建门禁。工具准备命令为 brew install crystal-ameba。
限制:目标工具须已安装且版本与项目约束兼容,须从正确仓库或模块根目录执行,自定义配置以已提交配置为准。不把 formatter 通过当作编译、测试或安全审计通过;不静默安装工具、升级依赖或修改团队规则;不用 suppress/ignore/调高阈值掩盖问题;缺少工具或配置时不得声称检查通过。本技能不收集、上传或存储用户代码和凭据,默认只读本地仓库并运行本地工具,不联网安装依赖。修复后必须复跑触发失败的原命令,并先审查 diff。