高质量自动化办公代码生成调试提示词

角色定义

请以自动化办公代码架构师与调试专家的身份使用以下提示词。你的核心目标是为AI提供明确、结构化、可落地的指令，使其生成高质量、易于调试、可直接投入生产的办公自动化脚本。你需要从工程化视角出发，平衡代码的可读性、健壮性、扩展性和调试友好度，同时允许融入适当的创意表达（如注释风格、模块命名）以提升代码维护体验。

适用场景

• 批量处理Excel数据（合并、清洗、统计、图表生成）
• 自动化生成Word文档（报告、合同、套打模板）
• 邮件自动化收发与附件管理（Outlook、SMTP协议）
• PDF批量操作（提取、合并、添加水印）
• 文件与文件夹的批量整理、重命名、归档
• RPA流程中的中间代码片段（如Web数据抓取、表单自动填写）

核心提示词

请直接复制以下提示词模板，根据具体任务填充括号内内容：

• “你现在是一名资深自动化办公程序员，擅长Python（或VBA/JavaScript）。请帮我生成一段代码，用于（具体任务描述）。要求：”
• “① 函数化架构，每个功能封装为独立函数，主流程清晰可读；”
• “② 完整的异常处理（try-except），并在捕获异常时输出明确错误信息；”
• “③ 关键计算步骤添加中文注释，说明业务逻辑；”
• “④ 添加调试日志（logging模块），记录输入参数、中间变量、运行耗时；”
• “⑤ 支持参数化配置（如文件路径、分隔符、阈值等）放在代码顶部或通过函数参数传入；”
• “⑥ 输出的代码可直接在Python 3.8+环境下运行，无需额外修改；”
• “⑦ 如果可能，在代码末尾附加一段调用示例和预期输出说明。”

风格方向

• 工程化：代码按模块拆分，文件名、函数名、变量名一致且语义化。
• 防御性：边界情况（空数据、格式不符）提前校验，避免运行中断。
• 可调试：日志级别可选择（INFO/DEBUG），关键步骤可用print配合条件开关。
• 创意表达：注释可融入简短业务场景描述，或采用特定的函数前缀风格（如trigger_、handle_、process_），使代码阅读像读故事。

构图建议

在生成代码的同时，建议要求AI输出一个文字版流程示意图（如用ASCII字符画出模块调用关系、数据流向），或提供一段伪代码逻辑说明。如果你需要将代码用于演示或文档，可额外要求AI按照深色主题（如Monokai）配色风格描述代码展示格式，便于截图或直接嵌入。对于复杂逻辑，建议AI以表格形式列出输入、输出、关键中间变量及其格式。

细节强化

• 错误处理层次：区分可恢复错误（继续执行）与致命错误（终止），并给出处理策略。
• 性能监控：在循环体内添加进度条（tqdm）或计时装饰器，便于定位慢操作。
• 单元测试：要求AI同时生成一个简单的测试用例函数，验证核心逻辑。
• 跨平台兼容：指定操作系统（Windows/macOS/Linux），要求路径处理使用os.path或pathlib。
• 安全与合规：若涉及敏感数据，要求代码不硬编码密码，改用环境变量或配置文件。

使用建议

• 迭代调试：首次生成后，先在小数据集上运行，根据日志定位问题，再二次追问AI修复；例如：“代码在第25行遇到类型错误，请排查并优化。”
• 提示词微调：如果生成的代码太简略，补充“请使用pandas库实现”；如果太复杂，加入“保持代码不超过50行”。
• 集成测试：对多个步骤（如先读取Excel→清理→生成Word），分次生成后手动拼接，或一次生成全流程脚本。
• 团队协作：可在提示词中添加“代码风格遵循PEP8标准”或“使用Google风格注释”，便于他人维护。
• 创意扩展：在注释中鼓励AI加入emoji或业务场景小故事，提升阅读趣味，但保留核心逻辑严谨性。