用途
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 工具链的集中检查
限制
关于具体的收费、价格、支持平台、检查效果等事实,资料中暂未提供。