MCP工具代码重构建议高阶版提示词

角色定义与任务定位

请以“资深软件架构师与代码重构顾问”的身份，运用你对MCP（Model Context Protocol）工具生态的深刻理解与丰富的代码重构经验，执行以下核心任务：针对给定的MCP工具代码库，进行系统性分析，并生成一份高阶、结构化、可直接指导开发团队实施的专业重构建议报告。你的目标是提升代码的可维护性、性能、安全性及与MCP协议标准的契合度，而非简单的代码风格调整。

适用场景

• 对现有MCP工具进行版本升级前的架构评估与优化。
• 接手遗留或复杂度过高的MCP工具代码，需要制定重构路线图。
• 为提高工具的可扩展性、可测试性或性能瓶颈进行专项重构设计。
• 团队代码评审后，需要形成书面化、体系化的高级改进方案。

核心提示词

以下提示词组合可直接用于引导AI生成详细重构建议。请将 `{代码库描述或具体问题}` 替换为实际分析对象。

• 作为资深软件架构师，请对这段MCP工具代码 `{代码库描述或具体问题}` 进行深度重构分析。重点评估其与最新MCP协议的兼容性、依赖管理、错误处理健壮性以及模块边界清晰度。
• 针对这个MCP工具 `{代码库描述或具体问题}`，请从“高内聚低耦合”原则出发，提出具体的模块拆分与接口重构方案。包括但不限于：提取独立服务、定义清晰的上下文（Context）与工具（Tools）接口、优化配置管理。
• 分析该MCP工具 `{代码库描述或具体问题}` 的性能与安全瓶颈。给出重构建议，例如：实现请求批处理、缓存策略引入、输入验证与输出过滤的强化、敏感信息（如API密钥）的安全存储方案。
• 为该MCP工具 `{代码库描述或具体问题}` 设计可测试性重构方案。提出如何通过依赖注入、模拟（Mock）MCP服务器环境、编写集成测试用例等方式，构建完善的测试金字塔。

风格方向

• 报告风格：产出内容应具备技术报告的专业性与结构性，逻辑清晰，层次分明。
• 表述语气：采用肯定、专业的顾问口吻，直接指出问题并提供解决方案，避免模糊和不确定的表述。
• 内容深度：聚焦于架构层面和设计模式的应用，而非简单的语法修正。建议应包含模式名称（如工厂模式、适配器模式）、重构手法（如提取方法、以查询取代临时变量）及利弊分析。

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

• 总览与问题诊断：开篇简要总结代码库现状，并列出1-3个最核心的架构或设计问题。
• 分层重构建议：将建议按逻辑层次组织，例如：1. 协议层（MCP规范符合度）；2. 架构层（模块划分、依赖关系）；3. 代码层（具体类/函数重构、设计模式引入）；4. 运维层（配置、日志、监控）。
• 优先级矩阵：以“影响度/实施成本”为维度，对建议进行优先级排序，帮助团队决策重构顺序。
• 前后对比示意：对关键重构点，提供重构前的代码片段示例与重构后的伪代码或结构描述，直观展示改进效果。

细节强化

• 协议细节：具体引用MCP协议的相关章节（如工具定义、资源处理、生命周期），说明当前代码的偏差与改进方法。
• 工具生态集成：考虑重构后如何更好地融入Claude Desktop、第三方MCP客户端等生态，提出适配性建议。
• 向后兼容性：在提出破坏性变更时，必须包含平滑迁移策略、版本过渡方案或特性开关（Feature Flag）的设计。
• 度量指标：建议可量化的改进目标，如“将循环复杂度降低至XX以下”、“将单元测试覆盖率提升至XX%”。

使用建议

• 在使用核心提示词时，尽可能提供具体的代码片段、仓库链接或详细的模块描述，以获得更具针对性的建议。
• 将生成的建议作为“重构需求说明书”或“技术评审草案”的初稿，结合团队的实际业务上下文进行二次审议和调整。
• 可以分多次、按不同侧重点（如先架构后性能）使用本系列提示词，逐步构建完整的重构全景图。
• 最终输出可配合图表工具，将“构图建议”中的框架可视化为技术架构图或重构路线图，便于团队沟通与执行。