| name | embedded-sp |
| description | Use when working on embedded systems, firmware, MCU, sensors, displays, hardware drivers, or IoT applications on ESP32, STM32, RP2040, nRF52 - enforces TDD-first workflow with HAL Mock tests and build-flash-monitor verification before any completion claims |
| license | MIT |
Embedded Development Skill (OpenCode Edition)
Version: v1.0.0-sp | Release Date: 2026-04-13
OpenCode 适配版,采用 Superpowers 工作流程。
This skill integrates Superpowers workflow for embedded development.
REQUIRED SUB-SKILLS (invoke BEFORE implementation):
embedded-brainstorming → Hardware requirements clarification
embedded-tdd → HAL Mock tests + Hardware verification tests
embedded-verification → Build-Flash-Monitor evidence required
Do NOT invoke this main skill directly for new development.
Always invoke the appropriate sub-skill first.
The Iron Laws
NO FIRMWARE CODE WITHOUT FAILING HAL MOCK TEST FIRST
NO COMPLETION CLAIM WITHOUT BUILD-FLASH-MONITOR OUTPUT
NO FIX WITHOUT ROOT CAUSE INVESTIGATION
OpenCode Tools
| OpenCode Tool | Function |
|---|
skill | Load sub-skills |
todowrite | Checklist tracking |
task | Subagent dispatch |
read/write/edit | Code operations |
bash | Build/flash/monitor |
glob/grep | Find/search files |
Workflow (OpenCode)
Phase 1: Design (embedded-brainstorming)
skill embedded-brainstorming
todowrite todos=[...]
read AGENTS.md
read references/chips.md
write docs/embedded/specs/xxx.md
Phase 2: Test (embedded-tdd)
skill embedded-tdd
todowrite todos=[...]
write test/test_xxx_hal.c
bash: idf.py build
write src/hal/xxx_hal.c
bash: idf.py build
bash: idf.py -p COM3 flash monitor
Phase 3: Verify (embedded-verification)
skill embedded-verification
bash: idf.py build flash monitor
Quick Reference
| Chip | Build | Flash | Monitor |
|---|
| ESP32 | idf.py build | idf.py -p COM3 flash | idf.py -p COM3 monitor |
| STM32 | make | st-flash write | st-info --probe |
| RP2040 | cmake --build | picotool load | USB CDC |
Platform Commands
Windows (PowerShell)
idf.py build
idf.py -p COM3 flash; if($?) { idf.py -p COM3 monitor }
Linux/macOS (Bash)
idf.py build && idf.py -p /dev/ttyUSB0 flash monitor
Installation
See INSTALL.md for detailed installation instructions.
Reference Documents
| Reference | Content | When to Read |
|---|
SUPERPOWERS-MAPPING.md | Tool mapping | Workflow setup |
../references/chips.md | Chip specs | Chip selection |
../references/hardware-interfaces.md | SPI/I2C specs | Interface config |
Version: 1.0.0-sp (OpenCode Edition)
Updated: 2026-04-13