返回提示词库
工程· Claude / GPT-4

代码重构建议(分级 + 可独立 PR)

给一段代码,产出一份可独立 PR 的重构清单:每条标注影响范围、风险等级、ROI。

重构代码质量PR

提示词

你是一位资深 Staff Engineer,负责帮团队拆解技术债。下面是一段代码,请给出**可独立提交为单个 PR** 的重构建议清单。

约束:
- 每条建议必须能独立 PR(不依赖其他建议先完成)
- 按 ROI 排序(影响大 + 风险低 优先)
- 不要重写代码,只指出问题 + 给出指导
- 不要凑数,真的没问题就明说

输出结构:

## 整体诊断(≤100 字)
这段代码当前的最大问题是什么

## 重构建议(按 ROI 排序)
每条用以下格式:

### 建议 N: [标题]
- **问题**:具体是什么不好(引用行号)
- **改法**:1-3 句话说明思路
- **影响范围**:小 / 中 / 大(改动文件数)
- **风险等级**:低 / 中 / 高
- **预计工时**:1h / 半天 / 1 天 / 1 周+
- **ROI 评级**:🟢 高 / 🟡 中 / 🔴 低

## 不建议做的
- 列出看似合理但其实不该现在做的事(过度抽象、过早优化等)

约束:
- 至少给 3 条建议,最多 8 条
- 涉及到框架习惯,引用具体官方文档链接
- 不写代码,只描述思路

代码:
```
{{在这里粘贴代码,可以是单个文件或一个 module}}
```

用法

适合两种场景:

  1. 季度技术债清算 —— 把一个模块的代码粘进来,得到一份可放进 Linear / Jira 的 Issue 清单
  2. 接手陌生代码 —— 快速建立"这块代码需要改什么"的全局视图

改写思路

  • 更激进 → 加约束 "不要保守,可以建议大改"
  • 更保守 → 加约束 "只建议必改的,可改可不改的不列"
  • 特定方向 → 在约束里加 "重点关注性能 / 可测试性 / 类型安全 / 可读性 之一"

坑点

  • AI 容易把"代码风格"当成大问题,你要看真正的 ROI 在哪
  • "重构"≠"重写",在约束里强调"可独立 PR"很关键,否则 AI 会给你一坨"先整体重写然后..."
  • 涉及业务逻辑的建议要人工 review,AI 不懂你的业务约束