your-app/
├── AGENTS.md # 给 AI 的项目规则
├── docs/
│ ├── architecture.md # 项目架构说明
│ ├── api.md # 接口说明
│ └── tasks/
│ ├── login.md
│ ├── payment.md
│ └── profile.md
├── app/
├── build.gradle
└── README.md
这是一个带ai辅助的项目结构。
ai开发有3个需要解决的问题。
- 需求不清楚,它自己脑补
- 没有项目规范,它乱改结构
- 没有测试验证,它改完看似能跑,实际埋雷
所以需要通过AGENTS 解决2
通过task里面的md解决1
在task里面写验收标准解决3。
AGENTS.md示例:
# 项目说明
这是一个 Android / Flutter / Web App 项目。
# 技术栈
- Kotlin / Java / Flutter / React Native
- 后端接口规范
- UI 风格
- 包结构约定
# 开发要求
- 不允许随便改公共接口
- 每次改完必须跑测试
- 涉及 UI 修改要说明影响页面
- 涉及数据库/接口要说明兼容性
# 常用命令
- 构建命令
- 测试命令
- 启动命令
- lint 命令
task示例写法:
# 任务:登录页增加验证码倒计时
## 目标
用户点击获取验证码后,按钮进入 60 秒倒计时状态。
## 涉及页面
LoginActivity / LoginFragment
## 交互规则
1. 点击后按钮不可重复点击
2. 每秒显示"59s 后重试"
3. 倒计时结束恢复"获取验证码"
4. 页面销毁时停止计时,避免内存泄漏
## 验收标准
1. 正常点击能倒计时
2. 快速重复点击不会重复请求
3. 旋转屏幕/退出页面不会崩溃
4. 不影响现有登录逻辑
跟ai交互示例1:
请先阅读 AGENTS.md 和 docs/tasks/login.md。
然后分析当前实现,给出修改计划。
确认影响范围后再改代码。
改完后运行构建命令。
最后输出:
1. 修改了哪些文件
2. 为什么这样改
3. 如何验证
4. 还有哪些风险
跟ai交互示例2:
2.1.写需求
我要做一个功能:用户资产首页展示总资产、今日收益、资产分类占比。
要求 UI 简洁,不要电商风,适合资产管理 App。
2.2 分解需求
先不要写代码。请帮我把这个功能拆成需求文档、页面结构、数据结构、接口依赖、验收标准。
2.3.实现
每一步改动都要小步提交,不要一次性大改。
2.4 检查代码
检查是否有:
1. 空指针风险
2. 生命周期问题
3. UI 适配问题
4. 网络异常处理问题
5. 旧逻辑兼容问题