让 AI Agent 做第一个功能

先做一个小型订单管理:登录后查看订单,新增一笔订单,再修改金额。数据保存到应用数据库,刷新后仍能看到。

说明这次要做什么

先完成创建应用,保持开发服务运行,在应用根目录开启新的 AI Agent 会话。可以给它这段需求:

先读取当前项目的 AGENTS.md 和相关开发指引。

加一个简单的订单管理功能:
- 登录后从菜单进入订单列表,可以新增和编辑订单。
- 订单包含订单号、客户名称和金额,金额不能为负数,订单号不能重复。
- 数据保存在应用数据库,刷新页面后仍能看到。
- 先不加审批、通知和复杂角色权限。
- 沿用项目的组件和中英文翻译,接口也要检查访问权限。

完成后实际验证新增、修改和刷新,报告修改了哪些文件、执行了哪些检查。

让 AI Agent 在当前应用里做这个功能。这里不需要创建一个单独发布的插件。

看它改了哪些地方

可以按下面的目录检查 AI Agent 的改动:

位置用途
database/main/migrations/创建订单表,并限制订单号唯一
server/routes/orders.ts提供读取、新增和修改接口,检查登录与访问权限、校验输入
server/routes/index.ts接入订单接口
client/pages/orders.tsx显示订单列表和新增、编辑表单
client/routes.ts添加订单页面和菜单入口
client/locales/en-US.ts、zh-CN.ts添加中英文界面文字
package.json、pnpm-lock.yaml记录服务端需要的依赖及版本

你不需要先看懂所有代码。先确认改动围绕需求展开,再实际使用功能。client/ 是浏览器页面,server/ 是服务端接口,database/ 保存数据库结构变更。

新增一笔订单

以创建应用时的管理员登录,点击「订单管理」,再点击「新增订单」。填写:

字段示例
订单号ORD-001
客户名称青禾商贸
金额(元)1280

填写一笔订单

点击「保存」,确认订单出现在列表中。刷新浏览器,检查订单仍在。这一步可以发现只修改了页面、没有真正保存到数据库的情况。

修改并检查结果

点击该订单的「编辑订单」,把金额改成 1380 后保存。再次刷新,列表应显示修改后的金额。

修改金额并刷新后的订单列表

另外检查两种失败情况:再次新增 ORD-001 时应拒绝重复订单号;金额为负数时应拒绝保存。页面限制之外,服务端也需要拒绝非法请求。

检查没有通过时继续修改

把操作、期望和实际结果告诉 AI Agent,让它修复后再检查一遍,怎么描述问题见把问题准确交回去。

接下来

这一页走完了一轮完整的协作:说明需求、修改代码、实际检查、反馈修正。后面的功能也按这个节奏推进,每轮范围明确、能够检查,再扩大范围。按遇到的问题选择阅读:

现在遇到的问题去哪里看
AI Agent 做出来的功能跟想要的不一样怎么提需求
AI Agent 说做完了,不知道该怎么验检查 AI Agent 的产出
一个需求涉及很多页面和规则做复杂功能
同样的项目要求每次都要重说加上你们团队的规矩