Elysianapostle

Board Skill Factory — AI skill for Claude Code

AI community

为 STM32 等 MCU 开发板快速生成 AI 专属开发 skill（编译→烧录→串口日志全闭环，含已核实引脚表/裸机模板/接线咨询） Turn any dev board (STM32/ESP32/RP2040…) into an AI-agent-ready skill: verified pinmap, firmware template, build/flash/serial moni.

How to install Board Skill Factory

This entry records only its repository, not the path inside it, so there is no exact command to give. Open Elysianapostle/board-skill-factory and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Board Skill Factory does

为 STM32 等 MCU 开发板快速生成 AI 专属开发 skill（编译→烧录→串口日志全闭环，含已核实引脚表/裸机模板/接线咨询）| Turn any dev board (STM32/ESP32/RP2040…) into an AI-agent-ready skill: verified pinmap, firmware template, build/flash/serial monitor. STM32 AI / Claude skill

Alternatives in AI

System Prompts Leaks — Extracted system prompts from ChatGPT (GPT-5.4, GPT-5.3, Codex), Claude (Opus 4.6, Sonnet 4.6, Claude Code), G 38.6k ★
Optimization — ai-research-skills AWQ, GPTQ, GGUF, Flash Attention, bitsandbytes 5.4k ★
Agent Teams AI — You're the boss, agents are your team 2k ★

README

board-skill-factory · 板卡专属 AI 开发 Skill 生成器

**一句话**：给任何一块新的 MCU 开发板，按七阶段流程快速生成一个"专属开发 skill"——让 AI 编码代理能够命令行自闭环（**改代码 → 编译 → 烧录 → 看串口日志**）地开发这块板子。

**TL;DR (EN)**: A meta-skill for AI coding agents. Feed it a new MCU dev board + its schematic, and it produces a board-specific development skill (verified pin map, self-contained bare-metal firmware template, build/flash/probe/serial-monitor scripts) so the agent can develop the board fully from the command line.

这是一个 [Agent Skills](https://agentskills.io) 格式的 skill（`SKILL.md` + 附属资源），适用于 ZCode、Claude Code 等任何支持 skill 机制的 AI 编码工具。

**适用范围**：STM32 / GD32 / CH32 / ESP32 / RP2040 / AVR 等 MCU 开发板；流程对"AI 辅助嵌入式/固件开发"通用。

为什么需要它（实战教训）

你在 GitHub 搜"STM32 AI"、"AI 嵌入式"，找到的要么是 ST 官方的大而全工具，要么是跑分 demo——**缺的是"让 AI 能真正接管一块具体板子"的工作流**。我们给一块自制 STM32F103RCT6 开发板搭建 AI 开发工作流时，踩过三个典型的坑：

原理图文本层提取不可信——直接解析 PDF 文本配对引脚网络，先后把按键映射（KEY1/KEY2 错位一行）、OLED 的 SCK/RES、扩展排针的顶脚（其实是 GND）全部配错。错误映射 + 固件监听悬空引脚，还制造出"按键时好时坏、摸一下板子灯就翻转"的悬空脚闹鬼假象，一度误诊为虚焊。
GUI 工具链是人工瓶颈——"先用 CubeMX 配好再给 AI"意味着每改一次引脚都要人工点一遍 GUI，AI 无法自闭环。
环境差异——机器上没有 make、python 是 Microsoft Store 空壳、PowerShell 5.1 按 GBK 解析无 BOM 的脚本……不预先审计环境，脚本全是坑。

本 skill 把这套方法论（渲染读图核实引脚 → 环境适配 → 自包含模板 → 脚本四件套 → 真机端到端验收）固化下来，**新板子直接复用整个流程**。

产出物长什么样

跑完七阶段，你会得到一个类似这样的板卡 skill：

<你的板子>-dev/
├── SKILL.md            # 工作流入口：黄金循环 / 板载资源表 / 红线 / 排障速查
├── references/
│   ├── pinmap.md       # ★逐脚核实的引脚表 + 排针逐脚定义 + 可信度分级
│   ├── hardware.md     # 电源树 / 时钟 / 复位启动 / 电气注意
│   └── schematic.pdf   # 原理图原件（唯一硬件事实来源）
├── scripts/            # build.sh / flash.sh / probe.sh / monitor(.ps1/.sh/.bat)
└── assets/template/    # 自包含裸机固件模板（启动代码+寄存器头+链接脚本+BSP+冒烟main）

从此开发这块板只需要：改代码 → `build.sh` → `flash.sh` → `monitor` 看日志。

七阶段流程

阶段	内容	产出
0 输入收集	MCU 型号、原理图、调试器、串口方式	任务清单
1 环境审计	编译器/烧录工具/python 真伪/串口号逐项探测	工具链路径表
2 原理图消化	poppler 渲染成图逐区读图（不要只信文本提取）+ 闭合检查	pinmap.md ★用户核对
3 skill 骨架	SKILL.md 八节式 + references	skill 目录
4 模板固件	自包含裸机模