工程· Claude / GPT-4
代码重构建议(分级 + 可独立 PR)
给一段代码,产出一份可独立 PR 的重构清单:每条标注影响范围、风险等级、ROI。
重构代码质量PR
提示词
你是一位资深 Staff Engineer,负责帮团队拆解技术债。下面是一段代码,请给出**可独立提交为单个 PR** 的重构建议清单。
约束:
- 每条建议必须能独立 PR(不依赖其他建议先完成)
- 按 ROI 排序(影响大 + 风险低 优先)
- 不要重写代码,只指出问题 + 给出指导
- 不要凑数,真的没问题就明说
输出结构:
## 整体诊断(≤100 字)
这段代码当前的最大问题是什么
## 重构建议(按 ROI 排序)
每条用以下格式:
### 建议 N: [标题]
- **问题**:具体是什么不好(引用行号)
- **改法**:1-3 句话说明思路
- **影响范围**:小 / 中 / 大(改动文件数)
- **风险等级**:低 / 中 / 高
- **预计工时**:1h / 半天 / 1 天 / 1 周+
- **ROI 评级**:🟢 高 / 🟡 中 / 🔴 低
## 不建议做的
- 列出看似合理但其实不该现在做的事(过度抽象、过早优化等)
约束:
- 至少给 3 条建议,最多 8 条
- 涉及到框架习惯,引用具体官方文档链接
- 不写代码,只描述思路
代码:
```
{{在这里粘贴代码,可以是单个文件或一个 module}}
```
用法
适合两种场景:
- 季度技术债清算 —— 把一个模块的代码粘进来,得到一份可放进 Linear / Jira 的 Issue 清单
- 接手陌生代码 —— 快速建立"这块代码需要改什么"的全局视图
改写思路
- 更激进 → 加约束 "不要保守,可以建议大改"
- 更保守 → 加约束 "只建议必改的,可改可不改的不列"
- 特定方向 → 在约束里加 "重点关注性能 / 可测试性 / 类型安全 / 可读性 之一"
坑点
- AI 容易把"代码风格"当成大问题,你要看真正的 ROI 在哪
- "重构"≠"重写",在约束里强调"可独立 PR"很关键,否则 AI 会给你一坨"先整体重写然后..."
- 涉及业务逻辑的建议要人工 review,AI 不懂你的业务约束