⚡

代码质量 quality

代码质量技能是一个专注于提升Python代码规范性与可维护性的工具集。它通过自动化代码格式化、静态代码检查、类型检查以及预提交验证，确保代码遵循统一的编码标准。核心功能包括使用Black和Ruff进行代码格式化与风格检查，基于BasedPyright进行严格的类型验证，并通过预提交钩子在代码提交前自动执行质量检查。该技能旨在帮助开发团队强制执行代码规范，减少常见错误，提升代码库的整体质量与协作效率。 关键词：代码质量，Python代码规范，代码格式化，静态代码分析，类型检查，预提交钩子，Black，Ruff，BasedPyright，代码检查，开发规范，代码审查

DevOps 0 次安装 0 次浏览 更新于 3/2/2026

name: 代码质量 描述: 代码质量验证、格式化、代码检查与预提交检查。

代码质量技能

代码质量验证、格式化、代码检查与预提交检查。

激活

自动激活关键词: 代码质量, 代码检查, 格式化, 预提交, 命名规范, black, ruff, mypy, basedpyright, 验证

工作流程

格式化

  • format.md: 使用 Black 和 Ruff 进行代码格式化

代码检查

预提交

命令

# 格式化代码
uv run black .
uv run ruff format .

# 代码检查
uv run ruff check .
uv run ruff check --fix .

# 类型检查
uv run basedpyright src/

# 运行所有预提交钩子
uv run pre-commit run --all-files

质量标准

Python 标准

  • 行长度: 88 个字符 (Black 默认值)
  • 类型检查: BasedPyright 严格模式
  • 代码检查: Ruff 与 PyStrict 对齐的规则

规则类别

  • BLE: 检测盲目的异常捕获
  • EM: 错误信息最佳实践
  • SLF: 私有成员访问违规
  • INP: 要求包中包含 __init__.py
  • T10: 禁止调试器语句
  • G: 日志记录格式字符串

按文件忽略

测试文件和脚本文件为实用开发放宽了规则。