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. 旧逻辑兼容问题