wdcjx

Embedded Programming — AI skill for Claude Code

AI community

STM32 开发辅助 Agent Skill（DSH / Claude Code）：标准库 SPL / HAL(CubeMX) / FreeRTOS 四轨代码生成，内置工程纪律检查器 validate_generated.py 与 29 条坑清单.

How to install Embedded Programming

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

What Embedded Programming does

STM32 开发辅助 Agent Skill（DSH / Claude Code）：标准库 SPL / HAL(CubeMX) / FreeRTOS 四轨代码生成，内置工程纪律检查器 validate_generated.py 与 29 条坑清单。Embedded development skill for AI coding agents.

Alternatives in AI

Pixel Agents — Compressed Reference — VS Code extension with embedded React webview: pixel art office where AI agents (Claude Code terminals) are an 6.5k ★
Agent Rules Books — AGENTS.md rules / skills for AI coding agents: Codex, Cursor & Claude Code 2.6k ★
PRD: Agent Builder — Create Your Own Sub-Agent — Your ecosystem, your rules 1.9k ★

README

embed — 嵌入式（STM32）开发辅助 Skill

一个给 AI Agent 用的技能（Skill）：让 Agent 能独立完成简单 STM32 项目的代码生成（GPIO / UART / TIM / ADC / I2C / SPI / EXTI / DMA / 看门狗），支持四条轨： **裸机 SPL（默认）**、**SPL + FreeRTOS**、**裸机 HAL（CubeMX + Keil，起步）**、**HAL + FreeRTOS**，输出带引脚分配表、接线表、工程文件清单和烧录说明的完整代码。

早期版本，随使用逐步完善，进度见 [ROADMAP.md](ROADMAP.md)。

文件结构

embed/                                # 单一技能：快速生成 + 工程纪律两种模式
├── SKILL.md                          # 入口：模式路由、工作流、硬约束、自检清单
├── README.md                         # 本文件
├── ROADMAP.md                        # 后续计划
├── references/
│   ├── stm32-stdperiph-api.md        # 标准库 API 速查 + 密度宏/工程文件清单
│   ├── peripheral-recipes.md         # 典型外设配方（点灯/串口/PWM/ADC/I2C/SPI…）
│   ├── freertos-spl-integration.md   # SPL+FreeRTOS 集成规则（向量接管/FromISR/内存预算）
│   ├── hal-basics.md                 # HAL 轨：CubeMX/句柄模型/SPL→HAL 对照/F1 坑/RTOS 铁律
│   ├── spl-peripheral-checklist.md   # 外设初始化顺序清单（纪律）
│   ├── isr-and-concurrency-rules.md  # ISR/并发/volatile/临界区规则（纪律）
│   └── known-pitfalls.md             # 已知坑清单（纪律）
├── templates/
│   ├── main.c                        # 裸机 SPL 工程骨架模板
│   ├── main_rtos_spl.c               # SPL+FreeRTOS 任务工程骨架模板
│   ├── FreeRTOSConfig.h              # F103 中密度 FreeRTOS 配置模板（Kernel 10.x~11.x）
│   └── main_hal.c                    # 裸机 HAL 骨架（CubeMX 对照 + 手写起点）
├── assets/
│   └── spl-project-template.md       # Keil 工程组织/必配项/占用估算
├── scripts/
│   └── validate_generated.py         # 静态纪律检查（VIOLATION 必须清零，含 RTOS/HAL 规则）
└── tests/
    ├── bad_sample.c                  # 裸机违规自测样本
    ├── bad_sample_rtos.c             # RTOS 违规自测样本
    └── bad_sample_hal.c              # HAL 违规自测样本

**两种模式**：要一段能跑的简单代码 → 快速模式（直接说需求）；要"按老手工程纪律生成、审查、检查"的代码 → 纪律模式（默认；提到规范/审查/检查/validate 即命中）。两种模式共用同一套 API 文件与模板，纪律文件与检查脚本只在纪律模式强制。

安装

**仓库地址**：

DeepSeek Harness (DSH)：侧边栏「技能库」→ 粘贴仓库链接 https://github.com/wdcjx/Embedded-programming 安装（自动克隆 + 热加载），或把整个 embed 文件夹放到 ~/.dsh/skills/embed；
命令行：`git clone h