其他
提交或交接前需要多语言代码质量检查、自动修复…
在提交、交接或实现完成后,对多语言代码运行 qlty 做 lint、自动修复、格式化和质量度量。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 38/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 59/100 ×0.15
适用场景
提交或交接前需要多语言代码质量检查、自动特定
解决思路
- 检查变更文件并自动修复:运行 `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`。
- 运行 linter:使用 `--check`,这是默认行为。
- 自动修复问题:使用 `--fix`。
- 处理全部文件而非仅变更文件:使用 `--all`。
- 格式化文件:使用 `--fmt`。
- 计算代码指标:使用 `--metrics`。
- 查找代码异味:使用 `--smells`。
- 指定具体文件或目录:使用 `--paths`。
- 设置最低问题级别:使用 `--level`,可选值为 note/low/medium/high。
- 设置工作目录:使用 `--cwd`。
- 在仓库中初始化 qlty:使用 `--init`。
- 列出可用插件:使用 `--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`。
- 在新仓库初始化 qlty:运行 `uv run python -m runtime.harness scripts/qlty_check.py --init --cwd /path/to/repo`。
- 如果已直接安装 qlty CLI,检查变更文件:运行 `qlty check`。
- 如果已直接安装 qlty CLI,自动修复:运行 `qlty check --fix`。
- 如果已直接安装 qlty CLI,输出 JSON:运行 `qlty check --json`。
- 如果已直接安装 qlty CLI,格式化:运行 `qlty fmt`。
适用边界 · 注意事项
- 未安装 qlty CLI,或无法使用 `servers/qlty/server.py` 包装的 MCP server 时,不要使用本流程。
- 仓库中没有 `.qlty/qlty.toml` 且未运行 `qlty init` 时,先初始化再检查。
- 需要结构化代码模式、重构或快速文本搜索时,分别使用 ast-grep 或 morph,不要用 qlty 替代。