code-review-facilitator

Code Review Facilitator 是一款专为使用 Arduino、ESP32 与 RP2040 平台的嵌入式系统开发者所设计的专业工程工具。它如同自动化的导师，系统性地分析 C++ 固件以确保代码的稳定性、内存效率与可维护性。通过 scripts/analyze_code.py 工具进行静态分析，此技能可识别常见的陷阱，例如堆内存碎片、栈溢出、String 类的不当使用以及阻塞式的 delay() 调用。适用对象涵盖从构建原型的爱好者到完成生产级固件的工程师。开发者可在需要代码逻辑反馈、于发布至 GitHub 前确保质量，或遇到不明原因的运行时崩溃时使用此功能。该技能可解析项目目录或单一文件，并提供清晰、可执行的重构检查清单——从将庞大的函数拆解为模块化任务，到实现非阻塞式状态机与安全的缓冲区处理。它强调微控制器专属的最佳实践，例如 PROGMEM 的使用、消除幻数以及为 I2C、SPI 与传感器等硬件外设实现健全的错误处理机制。

• 对 C++ 源代码文件执行静态分析，检测 15 种以上嵌入式编程常见问题。

• 支持单一文件检查与递归项目目录扫描，以进行全面性审查。

• 提供关于内存安全的自动化指导，包括堆/栈管理与防止缓冲区溢出。

• 为非阻塞式计时、按键消抖及模块化硬件抽象化建议重构路径。

• 为改善项目结构与代码可读性生成可操作的分类检查清单。

• 提供互动模式，针对粘贴的代码片段进行实时反馈。

• 使用 'uv run scripts/analyze_code.py [target]' 执行分析以获取实时诊断报告。

• 使用 --severity 标记根据项目阶段或严重程度过滤反馈。

• 遵循输出中建议的重构模式来解决已识别的警告。

• 非常适合在开发物联网传感器、机器人控制器与数据记录器时使用。

• 与硬件调试互补；使用此工具在部署至生产板之前消除逻辑与安全性漏洞。