SuperAPI AI 工具集

python-code-quality

编程与开发

查看项目

更新于 10-15 23:49

技能介绍

用途:这是 Python 质量工具栈的编排索引类技能,本身不重复各工具的命令,而是把 lint、format、type-check、测试等工具串联起来,用于一次性搭建或理解整套质量流水线;当只需调整某一个工具时,应改用对应的聚焦技能。

主要能力与路由:该索引提供关注点与聚焦技能的路由表。包内引用标识形如 python-plugin:ruff-linting(lint 规则选择与自动修复)、python-plugin:ruff-formatting(引号风格、行宽等格式化)、python-plugin:ty-type-checking(ty 类型检查)、python-plugin:basedpyright-type-checking(basedpyright 类型检查)、python-plugin:vulture-dead-code(死代码检测)、python-plugin:python-testing 与 python-plugin:pytest-advanced(测试质量与覆盖率)、python-plugin:python-development(现代类型注解语法与惯用法)、python-plugin:uv-project-management(把工具加入项目)。ruff 的编辑器、pre-commit、CI、Docker 接线见 ruff-linting 的 REFERENCE.md。

使用方式:索引自身负责的是各工具在 pre-commit 中协同运行。示例配置在 .pre-commit-config.yaml 中同时接入 ruff(lint+format)与 ty:ruff-pre-commit 使用 id 为 ruff-check(args: [--fix])和 ruff-format 的钩子,ty 使用 id 为 ty 的钩子。典型 CI 质量门执行同样三步:ruff check、ruff format --check、ty check。各工具的具体 flag 与配置需跟随上述路由表查阅对应技能。

适用场景:新项目从零搭建完整质量栈;需要理解或比较各工具如何配合;以及把 lint 与类型检查一起接入 pre-commit 和 CI。

限制:资料未提供除上述路由与 pre-commit/CI 骨架之外的命令细节、版本兼容性、授权或收费信息;工具名称与示例命令需以对应聚焦技能和官方文档为准。