功能

编译 → 烧录 → 重置 → 监控 → 分析 → 修改 → 循环

1. 自动检测项目类型（Keil/Makefile/CMake）
2. 自动检测烧录器（J-Link/ST-Link/CMSIS-DAP）
3. 串口监控与输出分析
4. 调试闭环（最多3次重试）

Agent 使用指南

推荐：使用 agent_flash.py（最简单）

# 1. 检测环境
python "SKILL/workflows/agent_flash.py" --detect

# 2. 烧录并监控（常用）
python "SKILL/workflows/agent_flash.py" --project D:/workspacePrj/JL5104 --elf MDK-ARM/test0/test0.elf --device STM32F407ZGTx --serial COM3

# 3. 编译+烧录+监控
python "SKILL/workflows/agent_flash.py" --project D:/workspacePrj/JL5104 --build --elf MDK-ARM/test0/test0.elf --device STM32F407ZGTx --serial COM3

agent_flash.py 参数说明

备选：使用 detect.py 和 debug_loop.py

1. 检测环境

# 检测烧录器和串口
python "SKILL/workflows/detect.py" --json

# 检测项目和编译器
python "SKILL/workflows/build.py" --detect --json --search "工程目录"

2. 启动调试闭环

python "SKILL/workflows/debug_loop.py" --config "工程目录/configs/project.yaml"

3. 仅检测不烧录

python "SKILL/workflows/debug_loop.py" --detect --config "工程目录/configs/project.yaml"

工作流程

用户触发 skill
       ↓
检测环境 (agent_flash.py --detect)
       ↓
分析检测结果，确定:
- 烧录器类型 (jlink/stlink/cmsis_dap)
- 芯片型号 (STM32F407ZGTx)
- 串口端口 (COM3)
       ↓
执行烧录+监控
python agent_flash.py --project ... --elf ... --device ... --serial ...
       ↓
分析串口输出
       ↓
用户判断代码是否正常
       ↓
异常? → 修改代码 → 重新烧录 (最多3次)
       ↓
正常? → 完成

配置文件（可选）

如需持久化配置，创建 工程目录/configs/project.yaml：

flasher:
  type: "jlink"
  device: "STM32F407ZGTx"

serial:
  port: "COM3"
  baudrate: 115200

flash:
  elf: "MDK-ARM/test0/test0.elf"

debug:
  max_retries: 3

文档目录

脚本路径速查

路径说明

• SKILL：技能工作区路径（Python 脚本所在目录）
• --project：用户项目目录（由用户指定）
• Python 脚本在 SKILL 工作区内执行，用户代码在 WORKSPACE 中