适合谁
如果你已有一个可以运行的网页项目,可以让 AI 帮忙完成范围明确的小功能。本教程以“给工具列表增加名称搜索”为例,重点是描述需求、审查修改和验证结果。工具可能修改文件或运行命令,开始前先了解其权限,并确保项目已有可恢复的备份或版本记录。
常见选择包括 TRAE、Cursor、GitHub Copilot 和 OpenAI Codex。安装方式、功能和费用以各工具的当前文档为准。
第一步:准备项目上下文
先按项目自己的说明启动应用并确认原功能正常。记录使用的框架、运行命令和相关文件;不要把 .env、密码、API 密钥或未经授权的数据粘贴给助手。
然后写清一个小需求:
请在现有工具列表页面增加名称搜索。
要求:输入关键词后筛选名称,忽略首尾空格;空输入时显示全部工具;
无匹配结果时显示“没有找到相关工具”。保留现有样式和分页行为。
先检查现有实现并说明拟修改的文件;完成后运行项目已有检查,
列出改动和仍需人工验证的情况。
如果项目数据来自服务端,还要说明搜索应在前端还是服务端进行;不确定时,让助手先说明现有数据流及两种做法的影响。
第二步:先看方案,再看代码
确认助手找到的是实际页面,而不是另建一个未使用的组件。阅读文件差异,重点检查:
- 搜索范围和大小写处理是否符合需求;空格与空值如何处理。
- 搜索与分类筛选、分页组合时是否还能找到预期结果。
- 是否引入不必要的依赖,或修改认证、数据库、配置等无关部分。
- 是否有密钥、私人数据或调试日志被意外写入代码。
不要仅凭“已完成”就合并或上线;不理解的变更应先让助手解释,必要时请熟悉项目的人审查。
第三步:按验收场景测试
按项目文档运行已有的构建、类型检查或测试,再在浏览器里操作:
| 场景 | 预期结果 |
|---|---|
| 输入存在的名称 | 显示匹配工具 |
| 输入不存在的名称 | 显示空结果提示 |
| 输入前后空格 | 按需求忽略空格 |
| 清空输入 | 恢复显示工具 |
| 搜索后切换分类或页码 | 结果与当前筛选条件一致 |
如果出现问题,把实际操作步骤、期望结果和错误信息提供给助手,请它先定位原因再修改。再次运行受影响的检查,并重新查看差异。
最后:由人确认发布
确认测试通过、影响范围清楚,再按团队流程发布。涉及数据库、支付、权限或生产数据时,先设计备份和回滚方案并进行针对性审查;AI 生成的代码仍需要开发者负责维护。
延伸阅读:GitHub:审查 Copilot 的代码变更。
