Python 代码简化与重构指南

概述

当 Python 代码的可读性、层次结构或重复度已经影响理解和维护，但又不能改变既有行为时，使用此 skill。

目标不是“写得更短”，而是在完全保留原有功能、输出、副作用、异常行为和公开接口的前提下，降低复杂度、提升可读性，并让后续修改更安全。

适用场景

在出现以下一种或多种情况时使用：

• 存在重复的校验、转换或分支逻辑
• 条件嵌套较深，主流程不清晰
• if/elif 分支链很长，且大多是值分发
• 存在没有表达额外语义的中间变量
• 数据类或样板代码过多，掩盖了核心意图
• 手动循环比推导式或内置函数更啰嗦
• 魔法数字、魔法字符串降低了代码可理解性