mcu-skills：MCU 开发板 Agent Skills
为 Claude Code 补充 STM32、ESP32、RP2040 等开发板的板级知识，让模型不再靠猜引脚与时钟树。
- Star 数
- ★ 20
- 最近更新
- 4 天前
- License
- MIT
- 主语言
- C
- FA 评分
- 45/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Claude Code
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 在 WeAct STM32H750VBT6 核心板上首次点亮外设，需要确认引脚复用与时钟配置的工程师。
- 不适合
- 使用 Cursor、Copilot 等非 Claude Code 工具的开发者
- 只需要通用 MCU 知识、特定开发板资料无关的团队
- 期待技能包内含完整驱动库或生产级固件的人群
- 源码审查
- 45/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
mcu-skills 是面向嵌入式固件开发的一组 Agent Skills（SKILL.md），覆盖 STM32、ESP32/ESP8266、RP2040/RP2350、nRF52840、AVR 以及 Baikal BE-U1000 等开发板。仓库按 skills/<family>/<skill-name>/ 组织，每块板一个技能目录，内含 SKILL.md、按需读取的 reference/ 深层资料、可直接构建的 template/ 工程以及 assets/ 板卡与引脚图。安装方式有两种：作为 Claude Code 插件市场（.claude-plugin/marketplace.json 中每个技能对应一个插件）通过 /plugin marketplace add 安装，或克隆后用 scripts/install.sh、scripts/install.ps1 以符号链接或复制方式放入 ~/.claude/skills。技能在 Claude Code 中处理对应开发板时自动加载，也可用 /stm32h750-weact 这类命令手动调用。仓库还提供 docs/AUTHORING.md、docs/CHECKLIST.md、CONTRIBUTING.md 与校验脚本，规范新技能的编写与评审流程；采用 MIT 许可。
每个技能把散落在数据手册、参考手册、原理图和调试经历中的板级知识写进 SKILL.md 的 frontmatter 与正文：引脚定义、可用的时钟树配置、容易静默失效的 HAL 调用、以及把固件烧录到芯片的方法。主体内容保持精简，更深的细节放在 reference/ 下由模型按需读取，template/ 提供一个真实可编译的项目骨架，assets/ 存放实物板照片与引脚图（其中 IMAGE.md 描述图片）。安装脚本 scripts/install.sh 与 scripts/install.ps1 提供 --list、符号链接/Windows junction 与 --copy 两种落地方式，最终进入统一的 ~/.claude/skills/ 扁平命名空间，因此技能目录名必须等于 SKILL.md 中的 name: 且全仓库唯一。插件路径下，.claude-plugin/marketplace.json 把每个技能注册为一个独立插件，插件名与技能名一致。
- 在 WeAct STM32H750VBT6 核心板上首次点亮外设，需要确认引脚复用与时钟配置的工程师。
- 用 Waveshare ESP32-C6-Touch-LCD-1.47 开发触摸屏固件，希望模型直接给出正确屏幕与触摸引脚的人。
- 给 nice!nano v2 克隆的 nRF52840 ProMicro 写键盘固件的键盘爱好者。
- 在 Raspberry Pi Pico（RP2040）与 WeAct RP2350A 之间迁移代码、需要核对差异的开发者。
- 使用 Arduino Nano（ATmega328P）或 LGT8F328P MiniEVB 等 AVR 板做小项目、需要避开烧录坑的创客。
- 团队把板级知识资产化，按统一模板新增自家开发板技能并纳入评审流程。
如何安装或部署这个 Agent？
作为 Claude Code 插件安装（README 的首选路径），在 Claude Code 内执行：
/plugin marketplace add alexex1993/mcu-skills
/plugin install stm32h750-weact@mcu-skillsmacOS / Linux 下从克隆安装：
git clone https://github.com/alexex1993/mcu-skills.git
cd mcu-skills
./scripts/install.sh --list
./scripts/install.sh stm32h750-weact # symlink into ~/.claude/skills
./scripts/install.sh stm32h750-weact --copy # or copy, if you want to edit locally
./scripts/install.sh --list # resultWindows 下使用 PowerShell 脚本：
git clone https://github.com/alexex1993/mcu-skills.git
cd mcu-skills
.\scripts\install.ps1 --list
.\scripts\install.ps1 stm32h750-weact # junction into ~\.claude\skills
.\scripts\install.ps1 stm32h750-weact --copy # or copy, if you want to edit locally
.\scripts\install.ps1 --list # result如何使用这个 Agent？
安装后无需额外配置：在 Claude Code 中处理对应开发板时技能会自动加载。也可以在对话中显式调用：
/stm32h750-weact如果只想在单个固件项目内生效，把技能目录复制到项目根目录下的 .claude/skills/ 即可：
mkdir -p .claude/skills
cp -r skills/stm32/stm32h750-weact .claude/skills/技能里的 template/ 是一个可构建的工程起点，reference/ 存放深层细节，模型会在需要时读取。
这个 Agent 有哪些优点和局限？
- 覆盖 21 块具体开发板，从 STM32H750、ESP32-P4 到 RP2350A、BE-U1000，按板而不是按芯片组织，正对嵌入式调试的真实痛点。
- 每个技能都带 template/ 可构建工程与 assets/ 实物照片、引脚图，模型拿到的是可验证的板级事实而非泛化描述。
- 提供 .claude-plugin/marketplace.json，可直接通过 /plugin 市场安装，无需手动管理文件。
- 跨平台安装脚本（install.sh / install.ps1）并支持符号链接与复制两种模式，便于本地修改技能。
- MIT 许可，且仓库自带 AUTHORING.md、CHECKLIST.md 与 validate 脚本，新技能的编写与评审有明确标准。
- 核心运行依赖 Claude Code 及其 Agent Skills 机制，其他编辑器或 Agent 工具需要自行适配 SKILL.md 的加载方式。
- 所有技能安装到同一个扁平的 ~/.claude/skills/ 命名空间，技能名必须全局唯一，长期扩展时存在命名冲突约束。
- 只写出部分技能带板卡照片与引脚图，表格中存在图片列为空的条目，资料完整度并不一致。
- 仓库以文档型知识与模板为主，不含驱动库或固件框架，实际构建仍依赖各板卡的 PlatformIO/Arduino 工具链。
- README 引用的跨芯片对比材料来自第三方 ESP32Features（CC BY 4.0），与主体 MIT 许可不同，复用需留意署名要求。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| mcu-skills：MCU 开发板 Agent Skills 当前 | 45 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 20 | 4 天前 | C | Claude Code |
| Vibe Coding MVP 工作流 | 74 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 3.2k | 15 天前 | TypeScript | Codex · Claude Code |
| Exort 嵌入式开发工作台 | 64 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 226 | 22 天前 | Svelte | — |
| ESP-Claw 边缘智能体框架 | 37 · 缺口较多 | 开发框架 | ★ 2.3k | 今天 | C | OpenAI API · Claude API |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
仓库是纯文档/技能包（SKILL.md、reference、template），未见可执行代码，因此权限面本身很小；但安装脚本会向 ~/.claude/skills 建立符号链接或复制，README 未说明脚本的权限边界、是否写入其他路径，也无用户确认或回滚说明。数据流方面仅说明技能在 Claude Code 中自动加载，未描述模型读取哪些文件、是否外发。依赖安全方面仅提到 template/lib 内第三方代码保留各自许可证，未做依赖审计或版本锁定。外部效应（刷写固件、DFU 操作）在 AUTHORING 中要求写清恢复步骤，但仓库层面无统一回滚/恢复策略。来源归属做得较好：明确标注 ESP32Features 的 CC BY 4.0 改编及 §11 归属，MIT 许可证完整。扣分点：安装脚本权限与回滚未说明、依赖未审计、无敏感数据处理说明。
README 与 AUTHORING 对技能结构、命名规则（目录名==frontmatter name、全局唯一）描述一致，自洽性较好。但依赖可用性仅笼统要求 template 在干净机器上可构建，未列出具体工具链版本或锁定；失败信息方面 AUTHORING 要求写症状→原因→修复表，但仓库层面无统一错误处理或诊断说明。扣分：依赖版本未固定、失败信息依赖各技能自行编写而非仓库保证。
受众与场景明确（嵌入式固件开发者、按板卡分技能），description 编写指南强调触发词覆盖，触发精度设计良好。能力边界方面有“什么该放进来”的取舍原则，但未明确技能不做什么（如不替代数据手册、不保证硬件安全）。环境适配覆盖 macOS/Linux/Windows 安装，但未说明 Claude Code 版本要求或与其他工具链的兼容性。
信息架构清晰（skills/<family>/<name> 布局、docs、templates、scripts 分层），安装说明详尽（插件市场、脚本、项目级安装）。命名稳定性有明确规则。示例与 FAQ 较弱：仅有文章链接，无 FAQ。已知限制仅零散提及（“untested”），无集中限制清单。许可证完整（MIT）。无版本号或变更日志。维护责任未明确（无 CONTRIBUTING 中的维护者角色、无 issue 流程说明，仅有贡献指南引用）。
输出可用性较好：template 要求可直接构建、recipes 可复制、SKILL.md 结构规范，能直接产出可用脚手架。边际价值明确——针对具体板卡的踩坑知识是通用模型不具备的。成本收益方面，技能数量多（20+），维护成本高，且未提供质量度量或验证结果，收益依赖各技能实际质量，仓库层面无法确认。
claim_traceability：README 声称 template 可构建、技能经真实硬件验证，但仓库内无测试结果或验证记录支撑，仅靠 AUTHORING 的流程要求。cross_source_corroboration：有外部文章链接可佐证项目存在，但无独立第三方验证。fact_inference_separation：AUTHORING 要求区分“超出规格但可用”的设置，方向正确，但仓库层面无统一标注机制。扣分：声明缺乏可追溯证据。
- 安装脚本会向 ~/.claude/skills 写入符号链接或复制文件，README 未说明其权限范围与卸载/回滚方式，安装前应自行审查 scripts/install.sh 与 install.ps1。
- 仓库未提供依赖审计或版本锁定，template/lib 内第三方代码需逐技能核查许可证与安全性。
- README 声称模板可在干净机器构建、技能经真实硬件验证，但仓库内无测试记录或验证证据，属未经独立核实的声明。
- 无版本号与变更日志，难以追踪技能内容随时间的变更。
- 发布者身份未经 FollowAgents 企业注册表验证，维护责任与更新路径不明确。