feat: 完善 MCU 芯片自动化测试架构
- 重构为三角色协作:人+Arch AI+执行AI - 新增 Excel 寄存器表格解析工具,自动生成测试代码 - 新增串口日志分析工具,自动生成测试报告 - 完善项目文档:AGENTS.md、README.md - 创建自动化测试架构设计文档 - 添加示例测试任务 P01-001
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# 架构提示词模板
|
||||
# Arch AI 提示词库
|
||||
|
||||
| 文件 | 用途 |
|
||||
| 文件 | 说明 |
|
||||
|------|------|
|
||||
| `architecture-design.md` | 系统架构设计模板 |
|
||||
| `technical-evaluation.md` | 技术选型评估模板 |
|
||||
| [architecture-design.md](architecture-design.md) | 测试架构设计模板与规范 |
|
||||
| [compiler-config.md](compiler-config.md) | 编译器配置模板 |
|
||||
|
||||
@@ -1,44 +1,81 @@
|
||||
# 系统架构设计模板
|
||||
# Arch AI 测试架构设计模板
|
||||
|
||||
## 输入
|
||||
## 1. 芯片功能分析
|
||||
|
||||
- 产品需求文档 (PRD)
|
||||
- 技术约束(已有技术栈、团队能力)
|
||||
- 非功能性需求(性能、安全、可扩展性)
|
||||
```markdown
|
||||
### 芯片规格
|
||||
- 型号: 类似 STM32H757 的 MCU
|
||||
- 核心: Cortex-M7
|
||||
- 频率: 400MHz
|
||||
- 外设: GPIO, UART, SPI, I2C, Timer, DMA, 等
|
||||
```
|
||||
|
||||
## 输出结构
|
||||
## 2. 测试方案
|
||||
|
||||
### 1. 架构概述
|
||||
- 一句话描述架构核心思路
|
||||
- 系统边界和范围
|
||||
```markdown
|
||||
### 测试策略
|
||||
- 单元测试: 外设功能验证
|
||||
- 集成测试: 多外设协同工作
|
||||
- 性能测试: 响应时间、吞吐量
|
||||
|
||||
### 2. 架构图(文字描述 + ASCII)
|
||||
- 模块划分和职责
|
||||
- 模块间通信方式
|
||||
- 数据流向
|
||||
### 编译器选择
|
||||
- Arm Clang: 高性能优化
|
||||
- Keil MDK: 工业级验证
|
||||
- Arm GCC: 开源生态
|
||||
```
|
||||
|
||||
### 3. 技术选型
|
||||
- 每个模块的技术栈及理由
|
||||
- 对比方案及淘汰原因
|
||||
- 风险点和缓解措施
|
||||
## 3. JTAG调试流程
|
||||
|
||||
### 4. 接口设计
|
||||
- 模块间接口定义
|
||||
- API 契约(请求/响应格式)
|
||||
- 数据模型概要
|
||||
```markdown
|
||||
### 调试步骤
|
||||
1. 准备固件: 编译 .hex / .elf
|
||||
2. 连接硬件: JTAG/SWD 接口
|
||||
3. 下载固件: OpenOCD / pyOCD
|
||||
4. 运行调试: 断点、单步
|
||||
5. 串口监控: 查看日志输出
|
||||
```
|
||||
|
||||
### 5. 非功能性设计
|
||||
- 性能目标及实现策略
|
||||
- 安全设计(认证、授权、数据保护)
|
||||
- 可扩展性考虑
|
||||
## 4. impact.md 模板
|
||||
|
||||
### 6. 部署架构
|
||||
- 运行环境
|
||||
- 服务拓扑
|
||||
- CI/CD 流程
|
||||
```markdown
|
||||
# {TASK_ID} - 变更影响范围
|
||||
|
||||
## 注意事项
|
||||
## 修改的文件
|
||||
| 文件路径 | 修改类型 | 影响等级 |
|
||||
|---------|---------|---------|
|
||||
| projects/P01_chip_test/src/gpio_test.c | 新增 | HIGH |
|
||||
| docs/02_测试架构/jtag_flow.md | 更新 | MEDIUM |
|
||||
|
||||
- 架构文档面向 Arch AI 和 Dev AI,不要写人类才需要的背景介绍
|
||||
- 决策必须写理由,方便后续 AI 理解为什么这样设计
|
||||
- 每个模块标注影响范围(HIGH/MEDIUM/LOW),供 QA AI 确定回归测试范围
|
||||
## 影响的功能模块
|
||||
- [x] GPIO 功能测试
|
||||
- [ ] 其他外设(无影响)
|
||||
|
||||
## 需要回归测试的场景
|
||||
- 场景1: GPIO 输入输出功能
|
||||
- 场景2: 中断触发和响应
|
||||
|
||||
## 环境依赖变更
|
||||
- 编译器: 使用 Arm GCC 12.x
|
||||
- 调试工具: pyOCD 0.30.x
|
||||
```
|
||||
|
||||
## 5. acceptance.md 模板
|
||||
|
||||
```markdown
|
||||
# {TASK_ID} - 验收标准
|
||||
|
||||
## 功能验收
|
||||
- [x] GPIO 高低电平输出正常
|
||||
- [x] 按键输入中断响应正确
|
||||
- [x] 串口日志输出正常
|
||||
|
||||
## 非功能验收
|
||||
- [x] 编译通过无警告
|
||||
- [x] 下载一次成功
|
||||
- [x] 运行稳定无崩溃
|
||||
|
||||
## 验收通过条件
|
||||
- 所有功能点验证通过
|
||||
- 三个编译器测试都通过
|
||||
- 测试报告完整
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user