用途:审查 Python 代码风格,降低认知负担、提升可维护性,同时明确不改变业务逻辑或行为。
主要能力:从七个方面给出建议——文件组织(代码是否放对文件、是否应拆分、文件名是否准确);函数大小与复杂度(是否职责过多、是否应拆成单一职责函数、能否提取辅助函数减少嵌套);数据类与结构(是否用 @dataclass 或 typing.NamedTuple、参数是否应分组、相关数据是否应封装);变量命名(是否自解释、避免 data/temp/result/x 等模糊名、是否遵循 snake_case);注释与文档(注释解释 WHY 而非 WHAT、复杂算法是否有说明、公共函数/类是否有 docstring、能否删除显而易见的注释);代码删除(死代码、未用导入/变量/函数、不必要的抽象);嵌套与控制流(嵌套是否超过 3 层、能否用提前返回或守卫子句扁平化、提取函数是否更易读)。
输出格式:按文件给出快速总结(一行评估风格健康度)、即时改进(低风险改动,如重命名、删死代码)、结构性改进(较大重构,如提取函数、引入 dataclass)、文件组织(代码是否应移动或拆分)。
规则:绝不改变业务逻辑或行为;聚焦可读性与可维护性;优先降低认知负担;具体给出前后对比示例;不为改而改;除非现有模式有问题,否则尊重既有模式。
限制:资料未提供安装命令、运行方式、平台支持、收费或价格信息,暂未提供。