SuperAPI AI 工具集

code-quality

编程与开发

查看项目

更新于 10-16 03:58

技能介绍

用途

Code Quality Review 用于审查用户所提供目录中的代码质量。它面向 Python/Django 项目,通过自动化工具与人工复核清单相结合的方式,输出按严重程度分级的检查结果。

主要能力

识别待审查文件

  • 查找目录下所有 .py 文件
  • 排除 migrations、pycache 及生成文件

运行自动化检查

该技能会执行以下命令:

uv run ruff check <directory>
uv run ruff format --check <directory>
uv run pyright <directory>
uv run pytest <directory> -v

人工复核清单

  • 无未经说明的 Any 类型
  • 适当的错误处理(无静默异常)
  • 避免 N+1 查询(select_related/prefetch_related)
  • 表单具有适当的验证
  • 视图返回正确的 HTTP 状态码
  • HTMX partials 处理 HX-Request 请求头
  • Celery 任务具备幂等性
  • 测试使用 factories,而非直接创建原始对象

报告结果

检查结果按严重程度组织:

  • Critical(必须修复)
  • Warning(应当修复)
  • Suggestion(可以改进)

使用方式

用户提供需要审查的目录,该技能在该目录上运行上述自动化检查并执行人工复核清单,最终输出分级报告。

适用场景

  • 对代码库进行质量审计
  • 在代码提交或评审前发现潜在问题
  • Django 项目中 ruff、pyright、pytest 工具链的集中检查

限制

关于具体的收费、价格、支持平台、检查效果等事实,资料中暂未提供。