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 (Pi Edition)

Version: v1.0.0-sp | Release Date: 2026-04-13

Pi Coding Agent 适配版，采用 Superpowers 工作流程。

---

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

---

Pi Tools

Built-in Tools

Pi Tool	Function
read	Read source/datasheet
write	Create files
edit	Modify code
bash	Build/flash/monitor
glob	Find files
grep	Search content

Extension Tools

Extension	Function	Install
image_read	GUI visual analysis	extensions/image-read.ts
todo_list	Task tracking	extensions/todo.ts
embedded_build	Build wrapper	extensions/build-wrapper.ts

Pi Features

Feature	Usage
Session Tree	Debug branching (/tree, /fork)
pi.appendEntry()	State persistence
AGENTS.md	Project context (auto-load)

---

Workflow (Pi)

Phase 1: Design

pi skill embedded-brainstorming
todo_list action=add "Read AGENTS.md"
read AGENTS.md
read chips/esp32.md
# Ask questions via chat
write docs/embedded/specs/xxx.md
pi.appendEntry("embedded-config", {...})

Phase 2: Test

pi skill embedded-tdd
todo_list action=add "Write HAL Mock test"
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

Phase 3: Verify

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

Phase 4: GUI (LCD)

bash: python scripts/camera_capture.py --session
image_read screenshots/capture_xxx.png
# Analyze layout, color, text

---

Pi Session Tree for Debugging

/tree              # Open session navigator
# Navigate to earlier working state
# Branch to try fix
/fork              # Create new session

Useful for embedded debugging:

• Navigate to last working state
• Branch to test different fix
• Compare before/after outputs

---

Installation

# Copy skill to Pi directory
cp -r embedded-sp ~/.pi/skills/

# Copy extensions
cp extensions/image-read.ts ~/.pi/agent/extensions/
cp extensions/todo.ts ~/.pi/agent/extensions/
cp extensions/build-wrapper.ts ~/.pi/agent/extensions/

# Verify
pi /reload

See INSTALL.md for details.

---

Version: 1.0.0-sp (Pi Edition) Updated: 2026-04-13