用途：对 Python 代码进行系统性重构，在不改变外部行为的前提下改善内部结构与可维护性，适用于要求重构、代码优化、改善代码质量、code smell review、应用设计模式或提交代码审查的场景。核心原则为重构不等于重写、保持接口兼容、有测试才重构、最小改动。
主要能力：提供坏味道到重构模式的速查表，例如过长函数用 Extract Method 或 Guard Clause，过长参数列表用 dataclass 参数对象或 Builder，重复代码用装饰器、模板方法或策略模式，上帝类按职责拆分，过度继承用组合加 Protocol，if-elif 创建实例用工厂模式，类型分发用多态或 singledispatch。参考文档包括 code-smells.md、design-patterns.md、readability.md、refactoring-in-practice.md 和 refactoring-report.md，约束阈值集中在 refactoring-config.json 中，可自定义或禁用。
使用方式：按前置检查、识别问题、选择策略、结构重构、打磨优化、验证的流程执行，建议确认测试覆盖与代码可运行后再动手，并运行已有测试与 linter 或类型检查确认无回归。重构粒度分为单函数、单类模块和跨模块三种规模，可对应单次提交、拆分两到三次提交或分阶段执行。用户请求输出重构文档时，在验证后按模板生成，可按 PR 描述、团队分享或项目归档裁剪，小型重构可用精简格式。输出建议按问题类型、位置、问题、方案、实战参考、修复前后片段和依据组织。
限制：基于 vllm-ascend 仓库重构 PR 提炼，未提供具体命令与安装方式，具体配置字段和模板细节暂未提供。即将废弃、无测试覆盖、紧急修复或虽不完美但稳定清晰的代码不建议重构。