智能体开发代码生成调试结构化提示词

角色定义

以「智能体开发提示词设计师」身份出发，核心目标是为代码生成与调试任务设计可复用、结构化的提示词模板。你需要让AI明确自身角色（资深智能体开发工程师），同时清晰规定输出格式（包含模块划分、异常处理、测试用例等），从而获得可直接运行、便于调试的高质量代码。

适用场景

• 从自然语言需求自动生成智能体核心代码（如Agent框架、函数调用、工具集成）
• 对已有智能体代码进行逐段调试、错误定位与修复建议生成
• 多轮对话式协作开发：需求细化→代码生成→调试反馈→优化迭代
• 需要保持代码风格统一、包含完整注释与文档的团队协作场景

核心提示词

可复制模板（建议直接使用）：

• 基础生成版：
  “你是一位精通智能体开发的资深工程师。请根据以下需求生成Python代码：
  需求：[填入具体功能]
  要求：使用结构化输出，包含类定义、方法注释、异常捕获、日志记录；代码遵循PEP8规范；同时给出一个简单的测试示例。”
• 调试优化版：
  “针对以下代码片段，模拟调试过程：
  代码：[粘贴代码]
  任务：1）指出潜在错误与性能瓶颈；2）给出修正后的完整代码段；3）为每个修改点添加注释说明原因。”
• 创意表达版：
  “以代码即艺术的方式，生成一个智能体核心循环。在代码的头部用多行注释描述整体架构的视觉化示意（如 ASCII流程图），函数命名体现叙事感，注释中融入设计哲学简述。”

风格方向

• 专业严谨：代码结构采用标准的MVC/事件驱动/管道模式，变量命名语义清晰，避免缩写歧义
• 可视化注释：在关键模块前后插入结构说明注释块（如“# ===== 决策引擎入口 =====”），便于快速定位
• 调试友好：每个函数附输入/输出类型标注和边界条件说明，异常处理分支细化
• 创意点缀：允许在非核心代码中加入少量风格化注释（如表情符号标记、简短彩蛋），但需以#开头且不干扰运行

构图建议

• 代码分层展示：将生成的代码按“导入模块 → 配置定义 → 核心类 → 工具函数 → 测试入口”分层呈现，每层之间用空行和#分隔线隔开
• 错误高亮规则：在调试输出中，错误位置用“!!!”标记行首，并附带“错误类型：”前缀，修正建议紧跟在下方缩进
• 测试输出模拟：如果提示词需要生成运行结果，使用模拟终端块（以“>>> ”开头），将预期输出与实际输出并列对比

细节强化

• 鲁棒性条款：在提示词末尾追加“请确保所有输入参数都包含类型校验，并在函数入口处进行 None 与空值检查”
• 日志规范：要求代码使用 logging 模块，且日志等级在 debug、info、warning、error 中明确分配
• 测试覆盖：每个类/函数生成后必须附带至少一个 pytest 风格的测试用例，包含正常、边界、异常三种情况
• 版本注释：在文件头部自动生成版本号、作者（填入固定占位符）、最后修改日期（使用当前日期）

使用建议

• 初次使用时，先运行“基础生成版”获取整体框架，再逐步追加“调试优化版”和“细节强化”指令进行迭代
• 若需要创意表达，可将“创意表达版”与“专业严谨”组合使用，先让AI生成带艺术注释的基础代码，再手动收紧风格
• 在对话中保持上下文连续性：每次新指令前先引用前一步的输出结果（如“针对你上次生成的 Agent 类，请优化其异步处理部分”）
• 当遇到复杂需求时，拆分任务：先用“适用场景”中的多轮对话法，每一轮只聚焦一个模块（如先定义配置文件，再写核心循环）