SuperAPI AI 工具集

code-quality

测试与质量

查看项目

更新于 10-16 03:03

技能介绍

用途:在代码审查、lint/格式化配置、可维护性检查、复杂度治理、告警清理和编码规范等场景调用,帮助保持代码库健康。

主要能力:

  • 快速检查流程:运行静态分析(linter、类型检查器、格式化器),按语言清单逐项审查,检查复杂度指标,输出带严重级别的结构化报告。
  • lint 配置参考:Rust 的 Clippy 配置(cognitive_complexity 警告、pedantic/nursery 拒绝、unwrap_used 拒绝)及命令 cargo fmt、cargo clippy --all-targets --all-features -- -D warnings、cargo check、cargo test -- --test-threads=1;TypeScript 严格模式与 ESLint;Python 的 Ruff + Mypy 配置(target-version、line-length、select 规则集、mypy strict 等)。
  • 规则要点:Rust 非测试代码禁用 .unwrap()、公共项需 rustdoc、#[allow(...)] 需注明理由;TypeScript 禁用 any 与 @ts-ignore、优先 const、导出函数显式返回类型;Python 公共接口需类型注解与 docstring、用 pathlib.Path、禁止裸 except。
  • 审查清单:通用清单覆盖正确性(边界、错误路径、off-by-one)、清晰性、架构、测试和安全(硬编码密钥、输入校验、SQL 注入/XSS/路径穿越);另有 Rust、TypeScript/React、Django/Python 专项清单。
  • 复杂度指标:圈复杂度与数据流复杂度建议阈值小于 25,附带风险分级和降低方法(提取辅助函数、卫语句、查表/模式匹配、策略模式、参数分组等),并给出测量工具(如 radon cc <file> -s -a、eslint-plugin-sonarjs、Ruff C901)。
  • 输出格式:包含总结、发现表格(编号/严重级别/文件/行号/问题/建议)、正面观察、指标和安全说明。

使用方式与限制:可依项目 AGENTS.md/CLAUDE.md 的执行策略直接运行 linter、格式化器和类型检查器;与同包 code-reviewer、design-patterns 技能交叉参考。资料未提供安装命令、定价、平台支持范围和实测效果,具体阈值与规则可按项目调整。