核心定位
uiflow2-coder 是专为 M5Stack UIFlow2 生态打造的 MicroPython 编程助手，覆盖从 Core 系列主控到数百种 Unit/HAT/Module 外设的完整开发场景。
核心机制
该 Skill 建立了一套文档优先的强制编程流程：所有代码生成前必须先读取 docs/ 目录下的官方文档，禁止凭经验推断 API。文档体系按硬件类型分层组织（hardware/system/unit/hat/module/base 等），涵盖 200+ 设备的精确构造函数、方法签名及官方示例。
显著优势
1. API 权威性：直接引用官方文档，杜绝"幻觉代码"
2. 设备适配深度：内置内置设备 vs 外接模块的严格区分规则，避免总线冲突导致的系统崩溃
3. 性能工程化：强制要求 MicroPython 优化实践——批量解包、缓冲区复用、零拷贝 memoryview、DMA 缓冲策略
4. UI 正确性：m5ui/LVGL 控件强制 parent=page0、禁用循环全屏重绘、坐标旋转自动处理
局限性与风险
- 文档依赖：若官方文档未及时更新或存在错误，会同步传递至生成代码
- 硬件门槛：需实际 M5Stack 设备验证，模拟器无法覆盖总线冲突等物理层问题
- 版本锁定：UIFlow2 与 UIFlow1 语法不兼容，旧设备升级存在迁移成本
适用人群
- 嵌入式开发者（需 MicroPython 基础）
- IoT/边缘计算原型快速迭代
- 教育场景下的硬件编程教学
风险等级
代码生成后仍需人工审查，特别是涉及电源管理、电机驱动、LoRa/NB-IoT 通信等场景，建议硬件测试后再部署至生产环境。
---
技术栈：MicroPython | LVGL | ESP32 | I2C/SPI/UART/CAN