AmethystLuna/embedded-workbench

嵌入式 C/C++ AI 工程插件——固件技能(FreeRTOS、Keil、HardFault、状态机)+ 1% 规则/计划验证门纪律 | 嵌入式 C/C++ 工程 AI 插件:固件技能与 agent 纪律。适用于 Claude Code、Codex、Cursor、Kimi、OpenCode、ZCode 和 DeepSeek Harness (dsh)

Project Overview项目介绍

This is a collection of agent skills for embedded C/C++ firmware development, built on the open Agent Skills standard. It includes 4 specialized agents and 8 domain-specific skills that cover common embedded development workflows, from FreeRTOS kernel development and interrupt handling to Keil MDK building and HardFault debugging. It supports multiple popular AI coding agents including Claude Code, Codex CLI, Cursor, Kimi CLI, OpenCode, and ZCode, and also provides native DSH integration as a pre-built Cordis bundle. To install the DSH native version, users can run a simple command to pull the package from npm or directly from the GitHub repository.

The tool provides a structured multi-agent workflow for embedded development, covering the full process from architecture planning and design review to implementation and final quality inspection. Skills are automatically activated and matched based on task context, but users can also explicitly call any skill when they need it. It is most commonly used for bootstrapping new embedded firmware projects, refactoring existing codebases, debugging hard faults, and verifying architecture design documents. After installation, you just need to restart your DSH profile for the plugin to load correctly and become fully available.

This project is released under the permissive MIT license, and has no external third-party dependencies beyond the base AI coding agent you install it to. It only reads the skill files bundled in the package when it runs, injects configured context into the first session turn, and does not collect user data or access sensitive credentials. You will need a compatible version of DSH (tested on the 2026-08-14 mainline build) or other supported agents to use this collection. If skills do not appear after install, try restarting your agent profile before troubleshooting further.

这是一个基于 Agent Skills 开放标准构建的嵌入式 C/C++ 固件开发代理技能集合,包含 4 个代理和 8 个领域技能,覆盖 FreeRTOS、中断处理、NVM 存储、Keil MDK、HardFault 分析、状态机设计、LVGL 开发等常见嵌入式开发场景。它支持 Claude Code、Codex CLI、Cursor、Kimi CLI、OpenCode、ZCode 等多款流行 AI 编码代理,同时还以 Cordis 包的形式提供原生 DSH 集成。

该工具的核心能力是为嵌入式开发提供结构化的多代理工作流,从架构规划、设计审查到执行实施、质量审查全流程覆盖。技能会根据任务上下文自动激活匹配,用户也可以显式调用指定技能,通常用于嵌入式固件项目从零搭建、现有代码重构、HardFault 故障调试、架构文档验证等开发场景。

在 DSH 中,可通过 dsh 插件命令从 npm 或 GitHub 源码安装,安装后需要重启配置文件才能生效。项目遵循 MIT 许可证,无额外外部依赖,仅要求使用兼容版本的 DSH 及各目标代理工具。插件运行时仅读取自有技能文件,不会收集用户数据或访问敏感凭据。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 13 stars - an early-stage project星标 13,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-embedded-workbench

把 AmethystLuna/embedded-workbench 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

嵌入式工作台

English · 中文

嵌入式 C/C++ 固件开发工具箱 — 4 个代理、8 个技能,覆盖 FreeRTOS、中断、NVM 存储、Keil MDK(AC5/AC6)、ARMCLANG、HardFault 分析、状态机、架构原则、LVGL 陷阱。

跨平台 — 支持 Claude Code、Codex CLI、Cursor、Kimi CLI、OpenCode、ZCode、DeepSeek Harness (dsh)。基于 Agent Skills 开放标准构建。

组件

代理 (4)

代理 说明
architecture-steward 只读规划:设计包、模块边界、切片拆分
design-reviewer 设计文档事实核查:逐条核验声称与代码库事实
execution-worker 计划 → 审批 → 实施循环,含编译验证
quality-coordinator 实现审查:Bug 发现、合规检查、结束完整性

技能 (8)

技能 说明
embedded-workbench 引导技能:工作流、策略、子代理映射、主动建议、跨平台工具映射、文档模板
debug-methodology 8 条调试铁律、修复准则、迭代调试案例研究
embedded-firmware-dev FreeRTOS、中断、NVM 存储、异步生命周期、边界分析、架构原则、LVGL 陷阱
keil-mdk-build UV4 CLI、ARM Compiler 5/6、.map 分析、合并打包、构建诊断
c-cpp-dev C/C++ 代码生成、风格、内存布局、重构
state-machine-design 状态模型、重试、超时、转换门控、实现模式
hardfault-triage 处理器异常分类 — 故障寄存器、栈帧、PC 定位源码、根因分类
fact-check 声称核查回退:逐条对照代码库核实 API 名、文件路径、枚举值、数量与机制可行性;logicprobe 未安装时由 Plan Verification Gate 使用

logicprobe(文档与计划声称核查技能)已拆分为独立插件 — 见下方其他插件推荐。未安装时,Plan Verification Gate 回退到本插件自带的 fact-check 技能,只有行为/模型类声称降级为人工确认。

技能内容大多来自作者个人嵌入式/固件开发工作经验和代码洁癖,按实际工程踩坑与约束沉淀,而非泛泛的模型生成内容。

深度参考

embedded-firmware-dev、debug-methodology、state-machine-design、c-cpp-dev 包含深度参考或代码示例。亮点:12 条架构原则、嵌入式模式(GIF 定时器安全、状态锁存、异步生命周期)、LVGL 陷阱、7 轮迭代调试案例研究、状态机实现模式、嵌入式 C 专项(volatile MMIO、链接器段、ISR 安全路径)。

安装

Claude Code 安装(推荐)

在 Claude Code 的 ~/.claude/settings.json 中添加 marketplace:

{
  "extraKnownMarketplaces": {
    "embedded-workbench": {
      "source": { "source": "github", "repo": "AmethystLuna/embedded-workbench" }
    }
  }
}

然后通过 CLI 安装:

claude plugin install embedded-workbench@embedded-workbench

Claude Code 手动安装

git clone https://github.com/AmethystLuna/embedded-workbench.git ~/.claude/plugins/dev/embedded-workbench

然后在 ~/.claude/settings.json 中启用:

{
  "enabledPlugins": {
    "embedded-workbench@dev": true
  }
}

DeepSeek Harness (dsh)

原生 dsh 支持以 cordis 插件 bundle 的形式提供,位于仓库根(根 package.json 声明了 dsh.bundle):

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-overleaf 下一个 Next dsh-loop-guard →