Codeium重构提示词需结构化：先声明Python 3.11、pandas 2.2.2、pydantic v2.7环境；再用三段式指令明确分析依赖、纯函数化改造、输出合规代码；最后绑定Black格式、嵌套深度≤3、函数≤45行等项目规范。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要让Codeium生成的代码重构提示词，一提交就能直接产出可运行、无语法错误、符合当前项目规范的代码，而不是反复调试、手动补全类型、再花十分钟修缩进和空格——关键在于把重构意图拆解成Codeium能精准响应的结构化指令，同时绑定真实上下文。
锁定重构目标并注入真实代码上下文
打开VS Code，确保待重构的Python文件已保存（如data_processor.py），且光标位于需改造的函数内部或紧邻其上方空行。【必须选中原始函数完整定义（含def行、docstring、所有逻辑行）】，不能只选中某几行——Codeium若缺失函数签名或return语句，会误判返回类型，导致生成代码无法通过mypy校验。
右键 → “Codeium: Generate Text”，弹出输入框后，第一句话必须写明当前环境：“你正在重构一个使用Python 3.11、依赖pandas 2.2.2和pydantic v2.7的ETL处理模块。”
这句不是客套话。它强制Codeium加载对应版本的类型推断规则——比如pydantic v2.7要求BaseModel字段默认值用Field(default_factory=list)而非[]，漏掉版本号会导致生成非法语法。
用三段式指令明确重构契约
在环境声明之后，立即写入以下结构（标点、换行、空格不可改动）：
“请执行以下三步操作：
① 先分析原函数中所有外部依赖调用（如pd.read_csv、requests.get），列出它们的返回类型与可能异常；
② 再将函数重构成纯函数：移除所有全局变量引用、拆分IO操作为独立参数、用typing.Union标注所有可为空的返回路径；
③ 最后输出完整重写后的函数代码，要求：保留原函数名、保持原有docstring不变、每行不超过90字符、禁用any类型、所有新引入的类必须带__slots__。”
这三步不可合并。第一步确保Codeium不凭空假设依赖行为；第二步封死副作用泄漏；第三步用硬性格式约束规避团队CI失败——比如某次重构因用了def process_data(...) -> dict:被pre-commit拒绝，就因没写Dict[str, Any]。
绑定项目级规范防止风格漂移
在指令末尾追加一行项目专属规则：
“本项目强制执行Black格式化，所有if/for块内嵌套深度≤3，函数体长度≤45行，若重构后超限，请自动拆分为helper函数并导出到同一模块。”
这句必须存在。Codeium默认倾向把逻辑塞进单个函数，而实际项目里超过30行的函数会被sonarqube标为“高复杂度”。加上这条，它会主动切分，且拆出的helper函数命名带_internal后缀，符合你们团队的私有函数命名约定。
按回车提交，Codeium输出的代码可直接复制进文件，无需手动调整缩进、补类型注解或删调试print。
