SuperAPI AI 工具集

python-quality-audit

编程与开发

查看项目

更新于 10-15 22:41

技能介绍

用途:对 Python 代码做只读、可执行的审计,覆盖代码质量、现代化、维护负担、生态替代机会与 Pythonic 设计。审计不修改目标,先并行收集独立证据,再汇总为一份去重、可验证、可执行的报告。

主要能力:先加载 python-engineering:standards-for-python-development 获取共享工程默认规则与仓库优先级规则。解析范围时把参数视为单一审查面:PR、diff、staged(git diff --cached)、unstaged(git diff 加相关未跟踪 Python 文件)、file/directory。记录仓库实际 Python 下限;用户显式给出目标下限时,现代化建议按 PROPOSED 处理,除非仓库配置已确立该下限。

审计通道:在隔离代理中运行适用通道,只给范围和起始路径,不给其他通道结论,通道只报告证据与候选,不编辑。1)Smell and standards lane(StinkySnake):检查偏离共享标准与 Pythonic 设计之处,如 lint/类型/测试逃逸与抑制、无理由前导下划线、接近或超过约 500 物理行的文件、重复逻辑、不必要包装、推测性抽象、死分支、兼容脚手架、弱类型、未检查外部边界、误导性转换、异常误用、同步/异步错误、违反既有架构/公共契约/依赖策略/工具配置。2)Python modernization lane(SnakePolish):在权威/目标 Python 下限上寻找更小、更清晰、更 Pythonic、更低维护的写法,如可移除的过时兼容代码、可替代自定义机制的新标准库/语言特性、可合并简化的模块函数、可删除而非重写的代码。3)Ecosystem substitution lane:识别可由成熟外部库或工具接管的本地维护代码/流程,推荐前须从一手来源核实维护状态与能力,并比较消失的本地代码、引入的依赖/API/兼容成本、Python 下限与平台约束、迁移/破坏性风险。4)Large-project practice lane:研究活跃维护的大型开源 Python 项目如何解决同类问题,仅报告针对本目标已观察到问题的实践。5)Removal and process-debt lane:挑战可消失项,如冗余校验、重复工作流阶段、手工维护的生成产物、触发条件已不存在的兼容步骤、被项目工具取代的脚本、仅耦合已删除实现细节的测试、描述过时行为的文档。

汇总:对照实际仓库与各通道输出,按根因合并重复项,拒绝违反仓库约束或只是转移维护负担的建议。证据分类为 OBSERVED、DERIVED、VERIFIED-EXTERNAL、HYPOTHESIS。每条重要发现给出 [P1|P2|P3] 标题、Evidence、Current burden、Recommendation、Why better、Protected behavior、Verification、Affected surface。优先级表示后果/机会而非确定性:P1 为正确性/安全/发布风险或大幅维护削减;P2 为有意义的设计/维护改进;P3 为有界后果的清理。正确性/契约发现、定性设计判断与效率遥测分开,不计算聚合分数。

可执行性门槛:建议只有在受影响面与验证路径已知时才可执行;若库替换、删除、Python 下限迁移或流程移除证据不足,应报告缺失证据与所需最小实验,而非当作就绪工作。结尾按后果排序发现、删除/替换机会、假设/实验,以及保持行为的最小合理实施顺序。

限制:不编辑、暂存、提交或发布评审评论,除非用户另行要求。