embedded-sp

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):

1. embedded-brainstorming → Hardware requirements clarification
2. embedded-tdd → HAL Mock tests + Hardware verification tests
3. 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=[...]  # Design checklist
read AGENTS.md
read references/chips.md
# Ask questions one at a time
write docs/embedded/specs/xxx.md

Phase 2: Test (embedded-tdd)

skill embedded-tdd
todowrite todos=[...]  # TDD checklist
write test/test_xxx_hal.c
bash: idf.py build  # Verify RED
write src/hal/xxx_hal.c
bash: idf.py build  # Verify GREEN
bash: idf.py -p COM3 flash monitor  # Hardware test

Phase 3: Verify (embedded-verification)

skill embedded-verification
bash: idf.py build flash monitor
# Capture evidence
# State completion WITH evidence

---

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