智能体开发Python脚本编写结果优化提示词

角色定义

你是智能体开发工程师，负责构建AI Agent工作流。你的目标是通过精心设计的提示词，引导大语言模型输出经过优化的Python脚本，使其符合智能体开发规范：代码可读性强、错误处理完善、模块化程度高、便于Agent自主执行与调试。你将以下述方案作为标准提示词模板，用于生成或优化脚本结果。

适用场景

• 在Agent工作流中需要自动生成Python脚本（如数据处理、API调用、自动化任务）
• 对已有脚本进行质量优化（添加注释、错误捕获、性能提升）
• 为智能体设定代码生成规范，确保输出一致且可靠

核心提示词

请直接复制以下指令至AI对话中：

• “你是一位资深Python开发者，专为智能体工作流编写脚本。请生成一个Python脚本，完成以下任务：【任务描述】。要求：使用类型注解，添加详细docstring，包含try-except异常处理，确保函数可被独立调用，输出结构为字典或JSON。脚本需包含日志记录（logging模块），并遵循PEP8规范。请在代码前先简要描述设计思路。”
• “优化以下Python脚本，使其更健壮、易维护：
  【粘贴原始代码】
  优化目标：增加输入验证、统一返回格式、添加单元测试占位注释、减少重复代码。请以优化后的完整脚本作为输出，并在每个关键函数旁用#说明改动点。”

风格方向

• 清晰规范：代码严格遵循PEP8，变量名语义化，注释中英文均可但保持统一
• 实用简洁：避免过度抽象，侧重可运行性和可扩展性
• 模块化：将功能拆分为独立函数，便于Agent按需调用

构图建议

由于此为文本/代码输出，建议提示词中明确要求输出结构：先给出设计概览（1-2句话），然后逐函数呈现代码，最后附上调用示例。若为优化任务，要求以diff或分段对比方式展示改动。

细节强化

• 明确要求AI考虑边界情况（空输入、网络超时、文件不存在）并加入对应处理
• 要求输出中包含性能提示（如使用生成器代替列表推导处理大文件）
• 强调日志级别区分：info记录正常流程，error记录异常，方便Agent工作流监控
• 如果涉及外部依赖，要求列出requirements.txt内容并在函数内检查依赖

使用建议

• 将上述核心提示词作为模板，替换【任务描述】或【原始代码】为实际内容
• 若需多轮对话，首次给出框架，后续要求细化某函数
• 结合Agent工作流中的工具调用（如FileSaver、ExecCode），可要求AI输出纯代码块便于直接执行
• 测试时对比优化前后执行结果，确保逻辑一致但更鲁棒