external-gitcode-ascend-python-refactoring

name	external-gitcode-ascend-python-refactoring
description	Python 代码重构技能，覆盖代码坏味道识别、设计模式应用、可读性改进和实战经验。当用户要求"重构代码"、"refactor"、"代码优化"、"改善代码质量"、"code smell review"、"应用设计模式"、"提升可读性"，或提交代码审查请求时使用此技能。支持在重构完成后输出结构化重构文档（"输出重构文档"、"生成重构报告"）。包含基于 vllm-ascend 仓库 20+ 个真实重构 PR 提炼的实战模式。
keywords	["重构","refactor","code smell","代码坏味道","设计模式","design pattern","可读性","可维护性","clean code","Pythonic","代码审查","code review","重构文档","重构报告","refactoring report"]
original-name	python-refactoring
synced-from	https://gitcode.com/Ascend/agent-skills
synced-date	2026-05-26
synced-commit	1f7666e7768a0ceb21bb1d40ce4b5179fcb6f1d6
license	UNKNOWN

Python 代码重构

对 Python 代码进行系统性重构，在不改变外部行为的前提下改善内部结构，提升可读性、可维护性和可扩展性。

Overview

• 适用场景：代码重构、代码审查、代码质量改善、技术债务清理
• 核心原则：重构 ≠ 重写；保持接口兼容；有测试才重构；最小改动
• 参考文档：基于 vllm-ascend 仓库 20+ 个真实重构 PR 提炼
• 约束配置：所有数值阈值（函数行数、参数个数等）集中在 refactoring-config.json，用户可自定义或禁用

Quick Reference

任务	参考文档
自定义约束阈值	refactoring-config.json
识别代码问题	references/code-smells.md
选择设计模式	references/design-patterns.md
改善可读性	references/readability.md
实战模式与案例	references/refactoring-in-practice.md
生成重构文档	references/refactoring-report.md

---

坏味道 → 重构模式 速查表

发现问题后，用此表快速定位解决方案：

坏味道	推荐模式	详细参考
过长函数	Extract Method、Guard Clause	code-smells.md §1.1
过长参数列表	dataclass 参数对象、Builder	design-patterns.md §1.3