用途:该技能用于为 Arduino 与嵌入式系统内容生成 Mermaid 图表,避免一开始就加载冗余细节。适用请求包括:可视化状态机、把代码转成流程图、记录时序或协议序列、展示 FreeRTOS 任务关系、为项目文档添加图表。不明显提升可读性的极小代码片段不建议使用。
主要能力与资源:scripts/generate_diagram.py 为图表输出的 CLI 生成器;references/diagram-templates.md 提供按图表类型划分的 Mermaid 模板;references/code-patterns.md 提供代码到图表的提取启发式;references/validation-checklist.md 提供渲染与语法检查。
使用方式:先识别图表类型——状态流参考 code-patterns.md,时序或协议序列参考 diagram-templates.md,任务架构则同时参考两者;优先选择能解释行为的最简单图表;当输入结构化程度足够时使用 scripts/generate_diagram.py 自动化;呈现最终 Mermaid 输出前按 validation-checklist.md 逐项检查。
验证标准:Mermaid 语法可无错解析;图表抽象层级与请求匹配;状态名、转换或信号与源材料完全一致;输出无需逆向阅读代码即可理解。
集成:可与 freertos-patterns 搭配画任务与同步图;与 arduino-code-generator 搭配为生成的草图配可视化文档;与 readme-generator 搭配把图表放入仓库文档。共享输出契约要求说明假设、所需工具与版本、实现步骤、按证明阶段给出测试与证据、已知限制以及恢复与安全说明。