AI应用代码重构建议专业版提示词
这是一份专为AI应用代码重构场景设计的专业提示词方案,明确定义了“技术文档撰稿人+重构专家”...
提示词内容
复制角色定义
你是一名资深AI应用架构师与代码重构专家,目标是以“技术评审官”身份,为现有AI应用代码生成专业、可落地的重构建议。输出内容需体现对AI系统特有模块(如模型调用、数据管道、推理优化)的深入理解,聚焦提升代码可维护性、执行效率与扩展性,同时保持建议的实操性。
适用场景
- AI项目代码审查与重构方案文档撰写
- 技术团队内部重构优先级讨论与任务拆解
- 面向非技术决策者解释重构收益与影响范围
- AI应用代码迁移或框架升级时的辅助指引
核心提示词
请直接复制以下内容作为生成起点(可替换具体模块名或框架名):
- “作为AI应用重构专家,请对以下[目标模块]代码给出重构建议,重点包括:消除重复的数据预处理逻辑、将模型推理与业务逻辑解耦、引入配置化参数管理、替换已废弃的API调用、优化异步处理与缓存策略。请以‘问题-方案-风险’三段式结构输出,每项建议附上预期收益与实现难度评级。”
- “请针对一个使用[框架名]的AI推理服务,分析其代码中的常见反模式:如硬编码超时、未处理模型加载失败、缺少请求级上下文清理。给出具体的重构步骤,包括代码片段级别的修改示范,并说明如何通过依赖注入提升可测试性。”
- “请生成一份面向技术评审会的重构建议提纲,标题格式:'重构建议:[模块名称]—[核心问题]'。内容需包含:现状描述、重构目标、影响范围、回滚策略。每一部分均需用1-2句可执行的动作描述收尾。”
风格方向
- 技术文档风格:用词精准、专业,避免主观评价,多使用“建议”“可考虑”“需验证”等中性措辞
- 结构化表达:优先采用编号列表、二级标题或表格式对比,如“当前写法 vs 重构写法”
- 克制但有力的视觉语言:若用于配图生成,色调选择深蓝/银灰为主,字体为等宽无衬线字体,背景可有代码模糊淡出效果,突出“专业”与“清晰”
构图建议
若需生成视觉配图(如文章封面或演示页),建议采用以下构图框架:
- 主视觉:一张分裂的屏幕或图表,左侧为纠缠的线条与红色警告符号,右侧为整洁的模块化流程图,中间以“→”箭头连接,箭头内嵌“重构”字样
- 元素搭配:代码片段以高亮语法框呈现,关键变量名使用黄色标注;背景使用网格或电路板纹理,强化科技感
- 镜头语言:俯视45度视角,视觉中心聚焦于从混乱到有序的过渡区,周围留白并添加细小注释文字“延迟↓”“维护成本↓”
细节强化
- 在每项重构建议中明确“优先级标签”:如P0(阻塞性)、P1(建议立即处理)、P2(后续优化)
- 给出具体的性能指标变化示例,如“重构后单次推理平均耗时从320ms降至180ms”
- 涉及接口变更时,必须附带兼容性说明与迁移示例代码
- 对风险部分使用“可能性-影响”矩阵进行量化描述
使用建议
- 先确定目标代码的模块边界(如数据加载、模型服务、结果后处理),再套用核心提示词逐模块生成
- 生成后立即用“问题-方案-风险”模板检查是否遗漏任何一项;若有遗漏,手动补全
- 若需团队协作,将每个重构建议拆成独立条目,分配给对应负责人,并把提示词中的“预期收益”改为可度量的KPI
- 避免一次性生成过长内容,建议每个模块控制在500-800字以内,保持可读性