跳转到内容
AI 编程入门手册

旧项目现代化提示词：先盘点风险，再小步升级

旧项目现代化最容易出问题的地方，是一上来就让 AI “帮我重构一下”。新手第一次做，只选一个目标，例如替换一个过时 API、整理一个旧组件、补一个测试，先证明小改动能跑通。

适合什么情况

Section titled “适合什么情况”
  • 项目能打开，但你不知道从哪里改。
  • 依赖、写法、目录看起来旧，但还能运行。
  • 你想让 AI 先读项目，再给一份风险清单。
  • 你只准备做一个小改动，不准备全项目升级。

不适合：生产项目紧急修复、数据库迁移、全量依赖升级、框架大版本迁移、涉及真实用户数据的改动。

先准备输入材料

Section titled “先准备输入材料”
  • 项目本地路径或仓库链接。
  • 你想现代化的一个小目标。
  • 已知的运行或测试命令。如果不知道，就写“不知道”。
  • 报错输出。如果没有，就写“暂无报错”。
  • 不能动的文件或目录。

不要提供 API Key、Token、cookie、数据库密码、客户数据。

第一步：只读盘点提示词

Section titled “第一步：只读盘点提示词”
请先不要修改代码。我要对一个旧项目做小步现代化。


项目路径或仓库链接：{项目路径或链接}
我的目标：{只写一个目标，例如“把一个旧组件改成更清楚的结构”}
我的水平：初学者
已知验证方式：{测试命令 / 构建命令 / 不知道}
不能动的范围：{例如 package-lock.json、数据库迁移、部署配置 / 没有}


请先只读项目并输出：
1. 这个项目的技术栈和入口文件
2. 和目标最相关的 3-5 个文件
3. 现在最可能的风险点
4. 哪些改动不应该在第一轮做
5. 一个最小可行改动，要求默认只改 1-3 个文件
6. 这个改动完成后怎么验证
7. 如果验证方式不明确，请先列出需要我确认的问题


约束：
- 不要执行安装、升级、删除、格式化全项目、提交代码
- 不要修改依赖版本
- 不要迁移框架大版本
- 不要把多个目标合成一次大改动

第二步：确认后再改

Section titled “第二步：确认后再改”

只有当 AI 的计划具体到文件和验证方法时，再发第二段。

可以只执行你刚才计划中的“最小可行改动”。请遵守：
1. 只改和目标直接相关的文件
2. 默认不超过 3 个文件
3. 不升级依赖
4. 不格式化整个项目
5. 不删除文件
6. 如果发现计划不成立，先停下来说明原因


完成后请输出：
1. 实际修改了哪些文件
2. 每个文件为什么改
3. 如何验证
4. 有哪些风险没有解决
5. 下一步最小改动是什么

停止信号

Section titled “停止信号”

看到这些情况，先停，不要继续让 AI 改：

  • AI 建议一次性升级框架或所有依赖。
  • AI 要求先运行远程脚本或全局安装未知工具。
  • AI 想删除大量文件、重命名目录、格式化全项目。
  • AI 不能说明验证方式。
  • AI 把“现代化”理解成重写整个项目。

成功标志

Section titled “成功标志”
  • 你知道项目入口和相关文件。
  • 第一轮计划能控制在 1-3 个文件。
  • 修改前后都有验证方法。
  • 没有全项目重构、依赖升级、自动提交。
  • 失败时可以回退这一个小改动。

下一步

Section titled “下一步”

改完后用 代码审查提示词 检查风险。如果 AI 说需要先补测试，再用 写测试提示词。

来源与日期

Section titled “来源与日期”