SuperAPI AI 工具集

code-quality

测试与质量

查看项目

更新于 10-15 20:30

技能介绍

用途:这是一个面向 Rust 项目的统一代码质量技能,通过格式化、lint、静态分析与整洁代码原则来维持高质量代码,可用于 rustfmt、clippy、cargo audit 和代码审查等场景。

主要能力与质量门禁:格式化要求 100% 合规;lint 要求零警告;安全审计要求无已知漏洞;覆盖率目标不低于 90%;文档要求覆盖所有公开 API。

使用方式(命令保持原样): ./scripts/code-quality.sh fmt ./scripts/code-quality.sh clippy --workspace ./scripts/code-quality.sh audit ./scripts/code-quality.sh check ./scripts/quality-gates.sh 依赖监控可用:cargo tree -d | grep -cE "^[a-z]"、cargo machete && cargo shear。

质量维度:结构上文件小于 500 LOC、模块清晰;错误处理使用自定义 Error、Result 与 ? 运算符,避免 unwrap;异步中 CPU 工作使用 spawn_blocking,避免阻塞;测试覆盖率不低于 90%,采用 AAA 模式,结合 cargo nextest 与 doctests;安全上使用参数化 SQL、环境变量,不硬编码密钥。整洁代码遵循 SOLID 与 DRY/KISS/YAGNI。常见反模式包括过度 clone、不必要的 unwrap、深层嵌套、超大函数和死锁,对应改用借用或 Arc、? 运算符、提取方法、拆分函数、在 .await 前释放锁。

代码审查输出格式为:Code Quality Report,包含 Score、Critical Issues、Warnings,以及结构、错误处理、测试状态和逐条问题(文件:行号与修复建议)。

限制:资料未提供该技能的安装方式、支持平台、收费与价格信息,暂未提供。