18｜面向代码任务的提示：Debug、重构、加测试、性能优化

本篇目标学会这 4 张“王炸”卡片。不管是修 Bug、优化烂代码还是补全测试拿来就能用。一、为什么“修一下”通常修不好你把报错代码扔给 AI 说“修一下。”AI 可能会乱改逻辑Bug 修好了功能也没了。引入新 Bug按下葫芦浮起瓢。越改越乱代码风格变得四不像。因为你没告诉它改动范围Scope和目标Goal。二、卡片 1精准除虫Debug别只发报错信息。你要告诉 AI期望行为和实际行为的差距。Prompt 模板# Role Python Debugging Expert. # Context - I am running this script: [文件名] - Input data: [输入数据样例] # The Problem - **Expected Behavior**: [代码应该输出什么] - **Actual Behavior**: [代码实际输出了什么报错信息是什么] # Task 1. Analyze the root cause. (先分析原因别急着改) 2. Propose a fix. (给出修复方案) 3. **Explain why the fix works.** (解释原理防止下次再犯) # Code [贴入相关代码片段不要贴整个项目]关键点强制它先分析再动手。很多时候 AI 一分析就发现是逻辑错了而不是代码写错了。三、卡片 2安全重构Refactor重构最怕改坏功能。必须加上“行为保持Behavior Preservation”的约束。Prompt 模板# Role Senior Code Refactorer. # Goal Refactor the following function to improve **readability** and **modularity**. # Constraints 1. **Do NOT change the external behavior.** (绝对不要改变输入输出) 2. Extract complex logic into helper functions. (把复杂逻辑拆出去) 3. Add type hints and docstrings. (加类型和文档) 4. Use early returns to reduce nesting. (减少 if 嵌套) # Code [贴入烂代码]关键点明确你是要“可读性”还是“性能”。这两个目标有时候是冲突的。四、卡片 3补全测试Unit Test这是 AI 最擅长、也是程序员最讨厌干的事。Prompt 模板# Role QA Engineer specialized in pytest. # Task Write comprehensive unit tests for the following function. # Requirements 1. **Happy Path**: Test with valid inputs. (正常情况) 2. **Edge Cases**: Test with empty lists, None, negative numbers. (边界情况) 3. **Error Handling**: Test if it raises the correct exceptions. (异常捕获) 4. Use pytest.mark.parametrize to cover multiple cases. (用参数化测试) # Target Function [贴入你的函数代码]关键点必须要求 Edge Cases。AI 默认只写 Happy Path因为它懒。五、卡片 4性能优化Optimize如果你觉得代码跑得慢别只说“优化一下”。Prompt 模板# Role Performance Optimization Expert. # Problem This function is too slow when processing large datasets (e.g., 1 million rows). - Current complexity seems to be O(N^2). # Task 1. Analyze the time complexity of the current code. 2. Propose an optimized version (target O(N) or O(N log N)). 3. Explain the trade-offs (e.g., higher memory usage?). # Code [贴入慢代码]关键点让它分析复杂度Big O。这能逼它思考算法层面的优化而不是只改改变量名。六、实战如何“最小化上下文”在使用这些卡片时切记不要把整个项目100 个文件都扔进去。Debug只给报错的那个函数和它调用的函数。Refactor只给你要改的那一个类。Test只给接口定义Signature和逻辑描述。为什么省 Token省钱。专注AI 的注意力是有限的。给的越少它越聚焦幻觉越少。总结四张提示卡Cheat Sheet请截图保存或者存到你的 Snippets 里场景核心 Prompt关键约束Debug“Analyze root cause - Propose fix - Explain why”必须先分析原因Refactor“Improve readability, extract helpers”Do NOT change behaviorTest“Cover happy path, edge cases, and exceptions”UseparametrizeOptimize“Reduce time complexity from O(N^2) to O(N)”解释 Trade-offs下一步我们学会了怎么让 AI 干活但它干的活质量如何能不能让它像一个严格的同事那样帮我们 Review 代码下一章我们将学习Checklist 驱动的 Code Review。