后端接口代码重构建议高阶版提示词

角色定义与任务定位

请以“资深后端架构师与代码质量顾问”的身份进行思考与输出。你的核心目标是：针对给定的后端接口代码库，进行系统性诊断，并生成一份具备高可行性、兼顾性能、可维护性与安全性的高阶重构方案。你的输出不是泛泛而谈的原则，而是可直接用于指导下一步开发行动的具体建议。

适用场景

• 对历史遗留接口进行现代化改造前的评估与规划。
• 在系统性能瓶颈排查后，针对接口层进行深度优化。
• 为提升团队代码规范与可维护性，制定接口重构标准与范例。
• 在微服务拆分或架构演进过程中，重新定义接口契约与实现。

核心提示词

将以下提示词组合与变量（如 `[具体接口名]`、`[特定技术栈]`）结合，作为与AI模型交互的核心指令：

• “作为资深后端架构师，请对 `[具体接口名]` 接口的代码进行重构分析。重点评估其RESTful设计规范性、业务逻辑分层（Controller/Service/DAO）的清晰度、异常处理机制完整性、以及数据库交互效率。”
• “针对基于 `[特定技术栈，如Spring Boot]` 的接口，提出具体的重构建议。包括：使用 `[如：ResponseEntity]` 统一响应体；利用 `[如：AOP]` 实现全局日志与鉴权；将硬编码参数抽取至配置中心；以及优化 `[如：MyBatis]` 查询语句以避免N+1问题。”
• “生成一份重构清单，涵盖：1. 接口契约标准化（OpenAPI/Swagger）；2. 引入设计模式（如策略模式处理不同业务分支）；3. 增加单元测试与集成测试覆盖率的具体方法；4. 性能优化点（如缓存策略、异步处理）。”

风格方向

• 专业严谨：采用技术文档的表述方式，使用标准术语（如“单一职责”、“防腐层”、“幂等性”），避免口语化。
• 结构化与清单化：输出内容应层次分明，优先使用编号列表或模块化标题，便于逐项审查与执行。
• 权衡与取舍：在建议中应体现架构师的权衡思维，例如：“在方案A（高性能）与方案B（高可读性）之间，根据当前业务阶段建议选择方案B，并附上未来演进路径。”

构图建议（方案结构）

重构建议报告应遵循以下逻辑结构展开，形成清晰的“构图”：

• 现状诊断：快速勾勒现有代码的核心问题（如“上帝类”、循环依赖）。
• 重构目标：明确列出本次重构希望达成的具体、可衡量的目标（如“响应时间降低50%”、“代码重复率降至5%以下”）。
• 核心重构策略：作为视觉焦点，分模块阐述重大改进方向。
• 具体实施步骤：提供可分阶段执行的详细任务列表。
• 风险与回滚方案：预判重构可能带来的风险及应对策略。

细节强化

在生成建议时，主动融入以下细节，使方案更具深度和可操作性：

• 代码片段示例：提供“重构前”与“重构后”的关键代码对比，而非仅仅描述概念。
• 工具链集成：推荐具体的静态分析工具（如SonarQube）、性能剖析工具（如Arthas）或API测试工具（如Postman Collections）。
• 度量指标：指明如何量化重构效果，例如：“建议监控接口的P99延迟、错误率以及单元测试的代码行覆盖率变化。”
• 团队协作建议：如“建议在重构前建立团队共识的代码规范文档，并利用Git分支策略进行渐进式重构。”

使用建议

• 将“核心提示词”部分的内容，替换上您项目的具体技术栈和接口名称后，直接输入给高级AI模型（如GPT-4、Claude 3），以获取初步重构分析报告。
• 将AI生成的报告作为讨论蓝本，结合“构图建议”调整结构，利用“细节强化”中的要点进行补充和深化，形成最终的技术方案。
• 本方案提示词同样适用于在团队内部发起重构讨论时，作为结构化思考框架，确保讨论聚焦于技术实质，避免发散。