SuperAPI AI 工具集

ameba-configuration

测试与质量

查看项目

更新于 10-16 04:30

技能介绍

用途:为 Crystal 项目配置 Ameba 静态分析工具,统一代码风格、发现代码异味与错误写法,并将质量检查接入开发与 CI 流程。

主要能力:通过 .ameba.yml 定义分析范围与规则。Globs 指定包含文件(如 /*.cr、/*.ecr),Excluded 排除目录(如 lib、src/legacy/**)。规则分 Lint(正确性,如 Lint/UnusedArgument、Lint/UselessAssign、Lint/UnreachableCode、Lint/Syntax、Lint/EmptyBlock、Lint/DebuggerStatement)、Style(约定,如 Style/RedundantReturn、Style/LargeNumbers、Style/MethodNames、Style/PredicateName)、Performance(性能,如 Performance/AnyInsteadOfEmpty、Performance/SizeAfterFilter、Performance/CompactAfterMap、Performance/FlattenAfterMap)。每条规则可设 Enabled、Severity(Error、Warning、Convention)及规则专属选项(如 Style/LargeNumbers 的 IntMinDigits、Lint/UnusedArgument 的 IgnoreParameterNames)。

使用方式:运行 ameba --gen-config 生成含全部默认规则的 .ameba.yml,再按需精简。可在代码内用行内注释临时禁用,如 # ameba:disable Style/LargeNumbers 与 # ameba:enable Style/LargeNumbers,也可按规则或类别禁用。配置建议纳入版本控制,先宽松后逐步收紧,按问题类型区分严重级别,排除生成代码,并同步维护 spec 与 ECR 文件的包含。

适用场景:新 Crystal 项目初始化、团队代码标准制定、CI/CD 严重级别定制、遗留或生成代码排除、误报与规则冲突排查、跨版本迁移。

限制:资料未提供 Ameba 的安装命令、版本兼容细节、具体运行参数与性能数据;规则完整清单与默认值需以 ameba --gen-config 生成结果为准,本说明未逐一列举。技能本身未说明收费、平台与效果承诺。