关于 qlty-check
qlty-check 是通过 qlty CLI 执行代码质量检查的技能,面向需要统一处理代码检查、格式化和度量的开发者。它可检查变更文件或整个项目,并支持修复问题和发现代码异味。
主要功能
- 01运行代码检查并自动修复
- 02格式化代码
- 03计算复杂度与重复度指标
- 04查找代码异味
- 05指定文件、路径和问题级别
适用场景
- 01提交或交接前检查变更代码
- 02自动修复风格与格式问题
- 03评估复杂度并定位代码异味
MCP 相关
项目提及 `servers/qlty/server.py` 用于封装 qlty CLI,供 MCP 客户端使用。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ parcadei/ continuous-claude-v3 --skill qlty-check安装后在 Claude Code 中输入/qlty-check确认已加载。
详细介绍
Qlty 代码质量
通过 qlty CLI 为 40 多种语言提供支持 70 多种 linter 的通用代码质量工具。
使用场景
- 在提交或交接前检查代码中的 lint 问题
- 自动修复格式和风格问题
- 计算代码指标(复杂度、重复率)
- 查找代码异味
快速参考
# Check changed files with auto-fix
uv run python -m runtime.harness scripts/qlty_check.py --fix
# Check all files
uv run python -m runtime.harness scripts/qlty_check.py --all
# Format files
uv run python -m runtime.harness scripts/qlty_check.py --fmt
# Get metrics
uv run python -m runtime.harness scripts/qlty_check.py --metrics
# Find code smells
uv run python -m runtime.harness scripts/qlty_check.py --smells
参数
| 参数 | 描述 |
|---|---|
--check | 运行 linter(默认) |
--fix | 自动修复问题 |
--all | 处理所有文件,而不只是已更改的文件 |
--fmt | 改为格式化文件 |
--metrics | 计算代码指标 |
--smells | 查找代码异味 |
--paths | 指定文件/目录 |
--level | 最低问题级别:note/low/medium/high |
--cwd | 工作目录 |
--init | 在代码仓库中初始化 qlty |
--plugins | 列出可用插件 |
常见工作流
实现后
# Auto-fix what's possible, see what remains
uv run python -m runtime.harness scripts/qlty_check.py --fix
质量报告
# Get metrics for changed code
uv run python -m runtime.harness scripts/qlty_check.py --metrics
# Find complexity hotspots
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)
# Check changed files
qlty check
# Auto-fix
qlty check --fix
# JSON output
qlty check --json
# Format
qlty fmt
要求
- qlty CLI:https://github.com/qltysh/qlty
- MCP 服务:
servers/qlty/server.py封装 CLI - 配置:代码仓库中的
.qlty/qlty.toml(先运行qlty init)
与其他工具对比
| 工具 | 使用场景 |
|---|---|
| qlty | 适用于任何语言的统一 lint、格式化和指标工具 |
| ast-grep | 结构化代码模式和重构 |
| morph | 快速文本搜索 |
评论
支持 Markdown