最近几个月大部分的项目开发，都是基于 AI Agent 进行开发的，开发方向包括 PC 端、APP 端，记录一下使用过程

开发场景

开发场景一般有：新需求开发、临时需求调整及修改 Bug

一、新需求开发规范

文档结构优化

1. **需求背景**
   - 业务目标（解决什么问题）
   - 用户场景（具体使用路径）

2. **技术实现**
   - **前端规范**  
     - 框架版本（如：React 18+）
     - 兼容性要求（如：Chrome 最新3版 / Safari 15+）
     - 响应式规则（如：$$ \text{移动端} \leq 768\text{px} $$）
   - **接口规范**  
     - 请求方法（`GET/POST`）
     - 字段结构示例：
       ```json
       { "code": 200, "data": { "list": [] } }
       ```
   - **Mock数据**  
     - 生成工具（如：MockJS语法）

3. **设计稿标注**
   - 关键交互状态（悬停/禁用等）
   - 像素级标注（如：间距 $$ \pm 2\text{px} $$ 容差）

AI指令强化

“请基于当前需求文档开发新模块，需满足：

1. 严格隔离新旧功能（通过路由/命名空间隔离）
2. 所有变更需通过自动化测试（覆盖率 $\geq 85%$）
3. 输出改动影响分析报告”

二、临时需求调整

问题定位模板

**现状**：  
当前点击按钮A触发动作X（代码路径：`src/foo.js#L32`）  
**预期**：  
需改为触发动作Y且保留原日志功能  
**比对差异**：  
- 保留：日志上报逻辑（`utils/logger.js`）  
- 修改：动作触发函数（需复用参数 ${p}$）  

AI指令示例

“请仅修改 src/foo.js 中按钮A的回调函数，要求：

1. 保留现有日志接口调用（$$ \text{callLogger}() $$）
2. 新动作Y需验证参数有效性（校验规则：${ |p| > 0 }$）
3. 提交代码前执行回归测试（测试命令：npm run test:regression）”

三、BUG修复流程

排查指引

1. **复现路径**  
   - 环境配置（Node版本/依赖版本）  
   - 操作序列（如：登录 → 点击设置 → 修改头像）  

2. **关键现象**  
   - 控制台报错（截图错误堆栈）  
   - 数据异常（示例：接口返回 `{ "code": NaN }`）  

3. **预期行为**  
   - 需符合业务规则（如：$$ \text{用户积分} \geq 0 $$）  

AI指令强化

“请修复以下问题：

• 核心问题：用户积分显示为负数（复现率 $> 80%$）
• 约束条件：
  1. 仅允许修改 src/points.js 文件
  2. 必须保留积分计算公式（$$ s_{new} = s_{old} + \Delta s $$）
  3. 修复后需通过压力测试（并发请求 $\geq 1000/\text{秒}$）”

四、共性优化建议

1. 变更隔离

   • 通过抽象层隔离AI生成代码（如：适配器模式）
   • 关键函数增加版本注释：

     // v2.1 - AI-Generated (2024-03)
     function riskyOperation() { ... }
     

2. 验证机制

   • 代码差异分析（git diff --stat 行数限制）
   • 自动化守卫条件（如：性能阈值 $$ \text{TTI} < 2\text{s} $$）

3. 知识沉淀

   • 建立AI开发案例库（标注成功/失败场景）
   • 输出《AI协作手册》迭代更新