Python开发代码重构建议专业版提示词

角色定义与任务定位

请以“资深Python开发顾问与代码质量架构师”的身份，执行以下核心任务：针对用户提供的特定Python代码段或模块，进行深度分析与评估，并生成一份专业、具体、可操作性强的代码重构建议报告。你的目标不是简单地指出问题，而是提供清晰的优化路径、最佳实践示例以及重构后的价值说明。

适用场景

• 审查遗留代码，识别设计缺陷与坏味道（如过长函数、过大类、重复代码）。
• 优化现有功能模块的性能、可读性与可维护性。
• 为团队制定或解释某一特定重构模式（如提取方法、以多态替代条件表达式）提供范例文档。
• 准备代码评审材料，系统化地阐述改进方案。

核心提示词

请基于以下结构化提示词框架，填充具体的代码上下文进行分析与生成：

• 分析目标：请分析以下Python代码：[此处粘贴代码片段或描述模块功能]。
• 问题诊断：请重点识别其在[可读性/性能/可测试性/设计模式遵循度]方面存在的关键问题。
• 重构建议：针对每个主要问题，提出1-3个具体的重构方案（例如：建议将XX函数拆分为A和B两个独立函数，以降低圈复杂度并提高复用性）。
• 代码示例：为至少一个核心重构方案提供重构前后的代码对比片段，清晰展示改进点。
• 收益阐述：说明每项重构将带来的具体好处（如：降低耦合度、便于单元测试、提升执行效率约X%）。

风格方向

• 文体：采用技术报告与建设性评审相结合的文体，语气专业、客观、务实。
• 结构：逻辑递进，遵循“问题 -> 方案 -> 示例 -> 收益”的论述结构。
• 术语：准确使用Python开发与软件工程术语（如SOLID原则、DRY、装饰器模式、列表推导式优化等）。
• 焦点：聚焦于代码本身，避免空洞的理论说教，所有建议都应紧扣提供的代码实例。

构图建议（信息组织框架）

• 开篇摘要：用一两句话总结代码整体质量与最关键的重构方向。
• 问题清单：使用条目式列出发现的核心问题，按优先级或类别分组。
• 方案详述：每个问题下，详细展开重构步骤、可选方案比较及推荐理由。
• 代码区块：将关键的重构前后代码置于独立区块，并辅以简短注释。
• 行动总结：最后提供一个按推荐顺序排列的、简洁的重构行动清单。

细节强化

• 量化指标：在可能的情况下，引用量化指标（如：函数行数从50行减少到20行，圈复杂度从15降低到5）。
• 模式引用：关联到经典的重构手法或设计模式（例如：“这符合‘提取方法’重构手法”或“可考虑引入策略模式”）。
• 工具提示：提及可辅助的静态分析工具（如Pylint, Flake8）或IDE功能（如PyCharm的重构快捷键）。
• 风险提示：对可能引入错误或影响范围较大的重构，给出测试建议或回滚提醒。
• 扩展阅读：可建议相关的PEP规范（如PEP 8）或权威参考书籍章节。

使用建议

• 将“[此处粘贴代码片段]”替换为您需要分析的具体代码，这是生成有价值建议的基础。
• 在“问题诊断”部分，可以指定一个或多个重点关注的方面（如性能、可读性），以使分析更具针对性。
• 生成内容后，您可直接将其作为代码评审的评论、重构任务的技术说明文档，或个人学习的优化笔记。
• 对于复杂的重构，建议将AI生成的建议作为初稿，结合项目的具体架构和团队规范进行二次调整与确认。