用途:对指定 Python 范围做有边界的常规代码审查。若目标是“如何更 Pythonic、更精简、更易维护、现代化、改用生态库或对齐大型项目实践”的广泛审计,应改用 python-engineering:python-quality-audit。
主要能力:读取参数指定的目标文件,逐项检查类型安全、错误处理、安全、性能、现代模式、设计清晰度、类型边界合规、测试质量及受改动影响的文档;按严重程度与位置报告发现,并附代码示例的修复建议。
使用方式:以 $ARGUMENTS 传入审查范围;审查前先加载 python-engineering:standards-for-python-development,其优先级与上下文默认值具有权威性,本入口不得自行发明更严格的框架迁移或数值启发式。每条发现需报告严重程度、file:line、证据、后果、建议修正与验证方式。默认以约 500 物理行作为模块边界,除非有证据表明拆分反而损害内聚或 API 边界,否则应检查并考虑分解。
限制:不编辑被审查代码;对已有 unittest.mock、缺少 Hypothesis(无有用不变量或输入空间时)、直接构造或既有架构,不因存在其他偏好选项而标记问题。