name: qlty-check
description: 通过qlty CLI进行代码质量检查、格式化和指标计算
allowed-tools: [Bash, Read]
Qlty代码质量
通用代码质量工具，支持70+种linters覆盖40+种语言，通过qlty CLI。
何时使用
- 在提交/交付前检查代码的linting问题
- 自动修复格式和样式问题
- 计算代码指标（复杂度、重复度）
- 发现代码异味
快速参考
# 检查更改的文件并自动修复
uv run python -m runtime.harness scripts/qlty_check.py --fix
# 检查所有文件
uv run python -m runtime.harness scripts/qlty_check.py --all
# 格式化文件
uv run python -m runtime.harness scripts/qlty_check.py --fmt
# 获取指标
uv run python -m runtime.harness scripts/qlty_check.py --metrics
# 发现代码异味
uv run python -m runtime.harness scripts/qlty_check.py --smells
参数
| 参数 |
描述 |
--check |
运行linters（默认） |
--fix |
自动修复问题 |
--all |
处理所有文件，不仅仅是更改的 |
--fmt |
格式化文件 |
--metrics |
计算代码指标 |
--smells |
发现代码异味 |
--paths |
特定文件/目录 |
--level |
最小问题级别：note/low/medium/high |
--cwd |
工作目录 |
--init |
在仓库中初始化qlty |
--plugins |
列出可用插件 |
常见工作流
实施后
# 自动修复可能的，查看剩余的
uv run python -m runtime.harness scripts/qlty_check.py --fix
质量报告
# 为更改的代码获取指标
uv run python -m runtime.harness scripts/qlty_check.py --metrics
# 发现复杂度热点
uv run python -m runtime.harness scripts/qlty_check.py --smells
在新仓库中初始化
uv run python -m runtime.harness scripts/qlty_check.py --init --cwd /path/to/repo
直接CLI（如果qlty已安装）
# 检查更改的文件
qlty check
# 自动修复
qlty check --fix
# JSON输出
qlty check --json
# 格式化
qlty fmt
要求
vs 其他工具
| 工具 |
使用场景 |
| qlty |
统一 linting、格式化、指标，适用于任何语言 |
| ast-grep |
结构性代码模式和重构 |
| morph |
快速文本搜索 |