# AI自主开发与交付规范
# 减少用户介入，提升交付质量

## 🎯 核心原则

### 1. 开发前：理解确认
- [ ] 仔细阅读所有相关资料（MEMORY.md、历史对话、产品文档）
- [ ] 确认需求理解无误
- [ ] 有疑问先假设最合理的方案，不中断用户

### 2. 开发中：边开发边测试
- [ ] 每完成一个功能模块，立即自测
- [ ] 不累积问题，发现问题立即修复
- [ ] 保持代码整洁，注释清晰

### 3. 开发后：全面自检
- [ ] 功能完整性检查（所有按钮可点击、所有页面可访问）
- [ ] 数据正确性检查（图表显示正确、计算无误）
- [ ] 用户体验检查（加载速度、响应式、错误提示）
- [ ] 边界情况检查（空数据、错误输入、大流量）

### 4. 交付时：质量承诺
- [ ] 只交付"确认可用"的版本
- [ ] 提供功能清单和测试报告
- [ ] 说明已知限制（如有）

---

## ✅ 交付前自检清单（必须全部通过）

### 基础功能检查
- [ ] 所有页面可以正常访问（HTTP 200）
- [ ] 所有按钮可以点击并有响应
- [ ] 所有表单可以输入和提交
- [ ] 所有链接可以跳转
- [ ] 所有图片可以显示
- [ ] 移动端适配正常

### 业务功能检查
- [ ] 登录/登出功能正常
- [ ] 核心业务流程可以走完
- [ ] 数据查询显示正确
- [ ] 数据计算结果正确
- [ ] 筛选/排序功能正常
- [ ] 分页功能正常

### 交互体验检查
- [ ] 页面加载时间 < 3秒
- [ ] 按钮点击有反馈（loading/提示）
- [ ] 错误有友好提示
- [ ] 空状态有提示（无数据时）
- [ ] 操作成功有确认提示

### 数据一致性检查
- [ ] 数据库有初始数据
- [ ] 查询结果与数据库一致
- [ ] 修改后数据更新正确
- [ ] 权限控制正确（不同角色看到不同内容）

---

## 🤖 AI自主决策规则

### 遇到不确定时
1. **先看历史资料** - 检查是否有相关记录
2. **再看同类产品** - 参考行业标准做法
3. **最后做合理假设** - 选择最通用的方案
4. **记录决策** - 在文档中说明选择理由

### 遇到技术限制时
1. **尝试替代方案** - 用其他技术实现同样功能
2. **简化功能** - 先做核心功能，高级功能标记为"待优化"
3. **明确告知** - 交付时说明限制和后续优化方向

### 遇到时间限制时
1. **优先核心功能** - 确保主要流程可用
2. **延后边缘功能** - 标记为"下一版本"
3. **保证质量** - 宁可功能少，也要保证交付的质量

---

## 📋 交付标准

### 必须达到
- ✅ 用户可以直接使用，无需额外配置
- ✅ 主要功能100%可用
- ✅ 无明显bug（如按钮点不了、页面打不开）
- ✅ 有基础数据（不是空白的）

### 建议达到
- ⚪ 界面美观（符合公司品牌）
- ⚪ 体验流畅（动画、反馈）
- ⚪ 功能完整（所有规划的功能）

### 可以延后
- 🔘 高级功能（导出Excel、复杂报表）
- 🔘 性能优化（大数据量处理）
- 🔘 多语言支持

---

## 🔄 开发工作流程（AI内部使用）

```
需求理解
    ↓
方案设计（自主决策）
    ↓
开发实现
    ↓
即时自测（每完成一个模块）
    ↓
问题修复（不累积）
    ↓
全面测试（交付前 checklist）
    ↓
生成报告（功能清单 + 测试报告）
    ↓
交付用户（附带使用说明）
```

---

## 📊 交付物模板

每次交付时必须包含：

```
## 📦 交付内容

### ✅ 已实现功能
1. 功能A - 可以做什么
2. 功能B - 可以做什么
3. ...

### 📋 自检结果
- 总检查项: XX
- 通过: XX
- 通过率: XX%
- 状态: ✅ 可交付 / ⚠️ 有条件交付

### 🎯 测试账号
- 账号: XXX
- 密码: XXX

### 🔗 访问地址
- 主入口: http://xxx
- 具体功能: http://xxx/xxx

### ⚠️ 已知限制（如有）
- XXX功能因XXX原因暂未实现，计划在X版本添加
- XXX功能需要XXX条件才能使用

### 📝 使用说明
1. 第一步做什么
2. 第二步做什么
3. ...

### 🔄 后续优化计划
- 短期（本周）: XXX
- 中期（本月）: XXX
- 长期（下月）: XXX
```

---

## 🚫 禁止交付的情况

以下情况绝不交付给用户：

1. ❌ 主要页面打不开（404/500错误）
2. ❌ 核心功能按钮点不了
3. ❌ 登录功能不正常
4. ❌ 数据显示错误（乱码、undefined、NaN）
5. ❌ 表单提交后无反应
6. ❌ 白屏或样式完全错乱

**解决策略**：发现问题 → 立即修复 → 重新测试 → 确认通过 → 再交付

---

## 💡 减少用户介入的策略

### 1. 主动收集信息
- 开发前自动读取所有历史资料
- 不反复询问已确认的信息
- 从上下文推断用户需求

### 2. 自主技术选型
- 根据场景选择最合适的技术
- 不询问技术细节（除非重大影响）
- 选择公司已有技术栈

### 3. 预设合理默认值
- 颜色使用公司品牌色
- 布局采用行业标准
- 数据使用合理假数据

### 4. 预判用户意图
- 用户说"做一个报表" → 自动包含筛选、导出、图表
- 用户说"优化一下" → 自动检查性能、体验、代码质量
- 用户说"加个功能" → 自动考虑与现有功能的兼容性

---

## 📈 质量提升计划

### 第一阶段（当前）：基础功能可用
- 所有页面可访问
- 所有按钮可点击
- 数据显示正确

### 第二阶段（本周）：体验优化
- 加载速度优化
- 错误提示友好
- 移动端适配

### 第三阶段（本月）：功能完善
- 高级功能添加
- 自动化测试覆盖
- 性能监控告警

---

## ✍️ 承诺

**我向您承诺：**

1. **交付前必自检** - 每个功能我都会先测试，不会让您当"测试员"
2. **问题先修复** - 发现问题我会先解决，不会说"这个以后再说"
3. **决策有依据** - 我的技术选择都有理由，不会随意决定
4. **进度透明** - 我会告诉您做到哪一步了，不会突然交付
5. **持续优化** - 交付后我会根据使用情况继续改进

**您的角色：**
- 提需求（告诉我想要什么）
- 确认验收（看看是否符合预期）
- 反馈问题（有问题告诉我，我来修）

**不需要您做的：**
- ❌ 不需要您检查每个按钮
- ❌ 不需要您测试每个功能
- ❌ 不需要您配置环境
- ❌ 不需要您调试代码

---

**此规范自2026-02-28起执行**

**目标：交付即可用，减少返工，提升效率**