SuperAPI AI 工具集

codeguard-python

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:把“看起来没问题”变成可重复的工具证据,用于 Python 项目 lint、格式检查、自动修复和提交前质量验证,尤其适合 AI 修改 .py 后需验证,或 CI 出现 ruff check . 相关失败时使用。

主要能力:按 .py 与项目标记(pyproject.toml、setup.py、requirements.txt)识别 Python 工作区;运行 ruff check . 并保留退出码、作用域与工具版本;把失败分为格式、静态规则、配置、环境、工具内部错误;用 ruff check . --fix 处理可逆问题并复扫;分层汇报 lint、format、compile、test、security 证据。

必要用法:在仓库根确认配置文件与目标文件存在;用 ruff --version 探测工具;先只读执行 ruff check .;需要安装时 pip install ruff。项目已有配置优先于技能示例,冲突需报告。修复后必须复跑触发失败的原命令,再运行项目已有测试与构建。输出状态分 PASS、FAIL、UNVERIFIED、PLANNED。

适用场景:检查或修复 Python 代码规范;AI 修改 .py 后的提交前验证;诊断 CI 中 ruff 相关失败;判断问题能否自动修复或需人工处理。

限制:工具缺失、版本不兼容或配置无法加载均记为“无法验证”,不得声称通过;formatter 通过不代表编译、测试或安全审计通过;不静默安装工具、不升级依赖、不改团队规则、不用 ignore/suppress 掩盖问题。本技能不联网安装依赖,不收集上传代码和凭据,自动修复前先检查 diff,破坏性或大范围修改需用户明确确认。学习语法、框架设计、依赖漏洞与安全审计不属于其范围。对于扫描范围(生成目录、vendor)、CI 环境对齐等需按仓库规则确认,资料未提供默认扫描策略细节。