想让 AI 给旧网站增加功能,第一步不是让它“优化整个项目”,而是先弄清项目怎样运行、目标功能经过哪些代码、改动会影响哪里。旧网站往往还包含历史约定、第三方接口和客户数据;先盘点和备份,再把一个清楚的小需求交给 AI,能减少改坏原有功能后的排查成本。
以下以“已有企业网站增加一个可筛选的产品列表”为例,演示从阅读项目到验收交付的过程。具体技术和代码以目标项目实际情况为准。
一、先保护旧项目,再提供必要上下文
确认项目文件有可恢复的副本,并检查当前工作区是否已有未保存的改动。团队使用版本控制时,先查看当前分支和改动清单,建立独立工作分支或可识别的提交点。不要在没有备份的情况下,直接让 AI 执行全项目格式化、升级依赖或重写结构。
给 AI 提供项目说明、目录结构、启动命令、使用的框架和已知限制;只上传完成任务所需的文件。先检查工具会读取或发送哪些内容,去掉密码、访问令牌、真实客户数据、生产配置和不应离开团队环境的文件。代码仓库能访问,也不代表其中的密钥适合交给任何外部服务。
二、第一轮只请 AI 做项目调查
让 AI 找入口、数据流和相关页面,并用实际文件或函数名说明依据。它暂时不应该改代码。收到结论后,自己打开相关文件核对,尤其注意它是否把演示数据误认成线上数据、把一个页面的行为误认成全站规则。
请先只阅读,不修改文件。说明这个项目的技术框架、如何在本地启动、产品数据从哪里读取、产品列表页面由哪些文件组成、当前筛选行为在哪里处理。每个结论请引用文件路径和函数或组件名称。找不到的内容标为未知,不要猜测。最后列出实现“按产品分类筛选”的最小影响范围和待确认问题。
如果项目有 AGENTS.md、README、贡献指南或测试说明,一并让 AI 遵循;找不到运行方法时,先让它查清楚,再让它拟步骤,避免直接运行未知脚本。
三、把需求写成可以验收的边界
“增加产品筛选”还不足以实施。可以写成:
- 页面:现有产品列表页。
- 使用者:所有能打开公开产品列表的访客。
- 行为:选择一个已有产品分类后,只显示该分类下的产品;选“全部”恢复完整列表。
- 数据来源:继续使用当前项目中的产品数据来源,不新增后台或数据库。
- 边界:保留现有排序、详情链接、页面样式与手机端布局;本次不修改导航和其他栏目。
- 验收:每个分类显示的条目与数据一致;没有结果时有说明;刷新页面后不报错。
如果你实际需要的是后台维护分类、同步外部数据或权限管理,这些会改变功能范围,应先单独确认并评估数据结构和账号权限,不要让 AI 根据一句话自行扩展。
四、先看实施计划,再允许改动
根据已确认需求和你找到的项目结构,先列出计划:要改哪些文件、各自改什么、哪些已有行为需要保护、准备怎样验证。不要改代码,不添加依赖,不变更数据库和生产配置。对尚不明确的地方先提问。
检查计划是否只触及需要的部分。若它提出重做列表组件、更新整套框架、增加全新数据表,问清楚现有结构为什么不能满足需求。明确修改范围后,再按文件或小步骤实施。
五、一次做一小段,每步都核对改动
先让 AI 实现筛选控件和现有数据筛选,再查看变更清单及关键差异。确认没有意外改动详情页、登录、全局样式或环境文件后,让它补齐空结果提示与必要的错误处理。改动后逐项检查语义和代码,而不是只看 AI 的完成说明。
现在仅按确认计划实现产品列表的前端分类筛选。保持现有数据来源、样式和详情链接,不增加依赖、不修改数据库和配置。完成后说明实际修改文件,并解释未改动的相关行为。不要提交或发布。
每次只加一项功能,可以更容易定位哪次修改引入问题。发现 AI 修改了计划外文件时先暂停,查看差异并判断是否撤销;不要在不理解影响范围时继续叠加修复提示。
六、用原功能和新功能一起验收
至少检查“全部”、每个分类、没有结果的分类、详情链接和手机视图。若项目已有构建、静态检查或测试命令,在开发环境按项目说明运行,并处理新增错误;再手动打开页面执行真实操作。通过一项筛选,不能说明整个网站仍然正常。
交给真实访客前,在测试环境确认页面只读取公开产品信息。若任务开始接触客户账号、表单记录或管理端,要额外用不同权限账号检查谁能查看和修改数据;前端隐藏控件不构成访问控制。涉及身份验证、隐私数据或交易的改动,应由有经验的人重点审查。
GitHub 的Copilot 任务最佳实践建议把任务写明范围和验收条件,并先调查、规划、迭代。具体 AI 工具和代码库能力不同,这些步骤不能替代开发者对实际差异、测试结果和安全边界的审核。
七、交付时留下能接着维护的信息
确认修改文件、测试命令和结果、需要的运行条件、尚未处理的情况。把 AI 的说明与实际代码核对后,再给接手人员简短的变更说明。不要只留下聊天记录或截图,也不要把测试账号密码写在公共文档。
如果项目没有明确的启动说明,让 AI 根据已经核实的命令补一份;运行说明写清适用版本和前置条件,并由另一位同事实际照着启动。如果改动触及上线配置或真实数据,单独记录部署步骤和回退方法,由负责该环境的人审核。
AI 可以帮你缩短读代码、改小功能和整理说明的时间,但旧项目中的业务规则需要项目负责人确认。需求清楚、边界明确、结果可重现时,AI 才容易帮上忙。涉及跨模块改造时,可先用AI 定制开发的需求与验收步骤拆小目标,再评估是否需要开发人员接手。
本文为操作方法示例,不代表客户案例或特定项目承诺。参考资料核对日期:2026 年 9 月 30 日。