跳到主要内容

重构提示词模板

把改动做小、做稳，并且可验证

1) 带验证闭环的安全重构​

你正在修改一个生产仓库。

目标：
- 重构 [模块/函数] 以提升 [可读性/性能/可维护性]

约束：
- 不改变行为
- 不新增依赖
- diff 尽量小且可审查

上下文：
- 文件： [路径]
- 相关文件： [路径列表]
- 现有代码：
[粘贴代码]

输出：
1) 简短计划
2) 最小 diff（或明确到逐行改动）
3) 验证步骤（tests/typecheck/lint）

2) 抽取函数/类，保持 API 稳定​

从以下代码中抽取 helper，但不改变行为。

约束：
- public API 不变
- 尽量用纯函数
- 需要的话补/改单元测试

代码：
[粘贴代码]

返回：
- 新 helper 的签名
- 更新后的调用点
- 需要新增/更新的测试

3) 全仓库安全改名​

我要把名称改为：
- 旧： [OLD]
- 新： [NEW]

约束：
- import/export 一致更新
- 尽量不破坏 public API（如会破坏，请给迁移方案）
- 文档/注释同步更新（若相关）

仓库上下文：
- 入口文件： [PATH]
- 相关模块： [PATHS]

请给：
- 需要改的文件清单
- 改动顺序
- 验证命令

4) API 迁移（旧 -> 新）​

把代码库从 [旧 API] 迁移到 [新 API]。

约束：
- 行为保持一致
- 如需要可做兼容层并写明弃用说明
- 更新测试覆盖典型与边界场景

请提供：
- 分步迁移计划
- 每步最小 diff
- 回滚策略

5) 降低复杂度（拆分模块）​

这个模块太大，难维护。

目标：
- 拆成多个职责清晰的小模块

约束：
- 行为不变
- export 尽量稳定
- 避免循环依赖

当前文件：
[粘贴代码或给路径]

返回：
- 建议的文件结构
- 各模块职责
- 验证清单

FAQ​

什么样的重构提示词更有效？​

目标清晰、约束明确，并带验证方案，让输出可审查、可落地。

如何让 diff 更小？​

一次只做一类改动，要求最小 diff，并按文件/步骤输出。

一定要让 AI 给什么？​

边界情况与具体验证命令，避免“看起来对”。