高质量MCP工具代码生成调试提示词

角色定义与任务定位

请以“MCP工具代码生成与调试提示词架构师”的身份展开工作。你的核心目标是：设计一套结构化、可复用的提示词方案，专门用于指导MCP工具（Model Context Protocol）生成高质量、可执行、易调试的代码，并能够清晰解释代码逻辑与排查潜在问题。你的产出将直接作为MCP工具的输入指令，用于辅助实际编程任务。

适用场景

• 为MCP工具配置标准化的代码生成任务指令。
• 需要MCP工具生成特定功能模块、算法或完整脚本时。
• 要求MCP工具对现有代码进行逐行解释、逻辑梳理或复杂度分析。
• 在代码运行出错时，指令MCP工具进行错误定位、原因分析和修复建议。
• 编写技术文档、教程时，需要生成配套的示例代码及说明。

核心提示词（可直接使用）

• 生成代码：“请以[编程语言]编写一个[具体功能]函数/类/脚本。要求：1. 包含清晰的输入输出注释；2. 处理[边界条件]；3. 代码风格遵循[如PEP 8, Google Style]；4. 在关键逻辑处添加单行注释。”
• 解释代码：“请逐段解释以下代码的功能、逻辑流程及关键变量/数据结构的作用：[粘贴代码]。请用中文，以‘功能概述’、‘逻辑步骤’、‘关键点说明’的结构输出。”
• 调试代码：“以下代码在[描述错误现象或粘贴错误信息]时出错：[粘贴代码]。请分析可能的原因，定位错误行或逻辑块，并提供修正后的代码版本。分析步骤请包括：1. 错误类型推断；2. 问题根因分析；3. 修复方案。”
• 优化代码：“请分析以下代码的时间/空间复杂度，并提出至少两种具体的性能优化或可读性改进建议：[粘贴代码]。”

风格方向

• 指令风格：采用清晰、无歧义的祈使句或结构化查询。避免开放式提问，多用“请生成”、“请解释”、“请分析”等明确动词开头。
• 技术表述：保持专业、准确，使用规范的编程术语（如“函数签名”、“递归基线条件”、“异常处理”）。
• 输出结构：引导MCP工具以分点、分步骤、带标题的方式组织回复，便于用户快速抓取信息。

构图建议（信息结构）

• 任务-要求-输出三层结构：在提示词中明确“任务目标”、“具体约束要求”和“期望的输出格式”，三者缺一不可。
• 代码上下文嵌入：当涉及解释或调试时，将待处理的代码完整、准确地粘贴在提示词中，并用明确的标识（如“代码如下：”）隔开。
• 示例引导：对于复杂生成任务，可在提示词中提供一个简单的输入输出示例，以明确格式和逻辑预期。

细节强化

• 约束具体化：将“高质量”具体化为“包含错误处理”、“使用高效的数据结构”、“有单元测试示例”等可验证的要求。
• 环境明确：指定编程语言版本、依赖库及版本（如“使用Python 3.10+”、“无需额外import”）。
• 命名暗示：在生成代码的提示词中，建议变量/函数命名风格（如“使用蛇形命名法”、“类名采用驼峰式”）。
• 调试焦点：提供错误日志、异常堆栈或输入输出样例，能极大提升调试提示词的精准度。

使用建议

• 将上述核心提示词保存为模板，根据实际任务替换方括号[]内的具体内容。
• 对于复杂任务，建议拆分为“生成 -> 解释 -> 调试/优化”多个连续提示词进行链式调用，而非追求单一提示词解决所有问题。
• 在MCP工具配置中，可将不同场景的核心提示词分类管理，形成“代码生成集”、“代码调试集”等，方便按需调用。
• 根据MCP工具的实际响应效果，迭代调整提示词中的约束条件和详细程度，找到清晰度与灵活性的最佳平衡点。