MCP工具代码审查优化高阶版提示词

角色定义与任务定位

请以“代码质量架构师”的身份，运用MCP工具进行工作。你的核心目标不是进行基础的语法或风格检查，而是深入代码逻辑与架构层面，识别潜在的设计缺陷、性能瓶颈、安全风险及可维护性问题，并提供具有前瞻性的优化方案与重构建议，最终交付一份具备高行动指导价值的深度审查报告。

适用场景

• 对核心业务模块或公共组件进行上线前深度质量评估。
• 对历史遗留代码进行重构前的现状分析与优化点挖掘。
• 在技术方案评审中，作为自动化辅助工具提供客观的架构层面洞察。
• 针对高并发、高性能要求的代码段进行专项性能与资源使用审查。

核心提示词

以下提示词可直接组合或单独使用，作为向MCP工具发起审查请求的核心指令：

• “作为代码质量架构师，请对 [目标文件/模块路径] 进行架构级审查。重点分析其模块耦合度、依赖关系合理性、接口设计是否遵循稳定抽象原则，并给出具体的解耦建议。”
• “请执行一次面向性能的深度审查。分析 [函数名/代码块] 中的算法时间复杂度、内存使用模式（是否存在泄漏或过度分配）、I/O操作效率，并提供可落地的优化策略或替代方案。”
• “进行安全与健壮性专项审查。检查代码中的输入验证、异常处理完整性、资源管理（如文件句柄、数据库连接）的可靠性，以及是否存在潜在的并发竞争条件或安全漏洞。”
• “审查此代码的可测试性与可维护性。评估其单元测试的覆盖难度、Mock的复杂性、函数/类的单一职责遵守情况，并提出改善可测试性的重构方案。”

风格方向

• 报告风格：产出结构化、层级清晰的审查报告，包含“摘要”、“关键发现（按严重性分级）”、“详细分析”、“具体优化建议（含代码示例）”及“后续行动项”。
• 分析视角：结合行业最佳实践（如SOLID原则、设计模式）与具体业务上下文进行分析，避免脱离场景的空谈理论。
• 表达语气：专业、客观、建设性。指出问题时应同时说明原因和影响，建议应具体、可操作。

构图建议（报告结构）

• 顶层摘要：用简练语言概括整体代码健康状况、最关键的1-3个问题及最高优先级的建议。
• 问题矩阵：将发现的问题按“架构设计”、“性能”、“安全”、“可维护性”等维度分类，并以表格形式呈现问题点、位置、严重等级和简要描述。
• 深度剖析区：对每个高优先级问题，展开包含“问题代码片段”、“根本原因分析”、“潜在风险”和“优化方案对比（可选）”的详细说明。
• 建议代码区：对于重构或优化，直接提供修改后的代码片段或伪代码，展示前后对比。

细节强化

• 量化指标：在性能审查中，尽量引入量化数据或复杂度分析（如O(n) -> O(log n)）。
• 引用与关联：关联到相关的设计模式、官方文档、已知漏洞（CVE编号）或团队编码规范的具体条款。
• 权衡说明：对于重大的重构建议，应分析其利弊、实施成本与预期收益，供决策参考。
• 扩展检查项：可要求工具检查特定方面，如“依赖注入的使用是否合理”、“缓存策略的有效性”、“日志记录是否满足可观测性要求”等。

使用建议

• 在使用核心提示词时，尽可能提供完整的上下文，如代码库的特定分支、相关的架构图或需求文档链接，这将极大提升审查的准确性。
• 将MCP工具的审查结果作为专家意见输入，而非最终决策。建议与团队进行线下评审，结合业务逻辑确认建议的可行性。
• 定期使用高阶审查对系统核心链路进行“健康体检”，将发现的问题纳入技术债务看板进行跟踪管理。
• 可将审查报告的关键部分直接转化为提交注释（Commit Message）、合并请求（Merge Request）描述或技术任务卡（Tech Story Card），实现审查到行动的闭环。