dsh-doctor
asdf17128
Find what your DeepSeek Harness (dsh) patches silently broke — dead patches, config fields dropped by whole-config repla…
AmethystLuna/embedded-workbench
Embedded C/C++ AI engineering plugin — firmware skills (FreeRTOS, Keil, HardFault, state machines) + 1% Rule / Plan Verification Gate discipline | 嵌入式 C/C++ 工程 AI 插件:固件技能与 agent 纪律。 For Claude Code, Codex, Cursor, Kimi, OpenCode, ZCode and DeepSeek Harness (dsh)
PROJECT TOPICS
PROJECT README
Embedded C/C++ firmware toolbox — 4 agents, 7 skills covering FreeRTOS, ISR, NVM storage, Keil MDK (AC5/AC6), ARMCLANG, HardFault triage, state machines, architecture principles, and LVGL patterns. v0.6.0.
Cross-platform — works with Claude Code, Codex CLI, Cursor, Kimi CLI, OpenCode, and ZCode. Built on the Agent Skills open standard.
| Agent | Model | Description |
|---|---|---|
architecture-steward |
opus / gpt-5.4 | Read-only planning: design packages, module boundaries, slice breakdown |
design-reviewer |
sonnet / gpt-5.3-codex | Design doc fact-check: verifies claims against codebase |
execution-worker |
sonnet / gpt-5.3-codex | Plan → approve → implement cycle with build verification |
quality-coordinator |
sonnet / gpt-5.3-codex | Implementation review: bugs, compliance, closure |
| Skill | Description |
|---|---|
embedded-workbench |
Bootstrap: workflows, policies, sub-agent mapping, proactive suggestions, platform tool mapping, document templates |
debug-methodology |
8 iron rules, fix principles, iterative debugging case study |
embedded-firmware-dev |
FreeRTOS, ISR, NVM storage, async lifecycle, boundary analysis, architecture principles, LVGL pitfalls |
keil-mdk-build |
UV4 CLI, ARM Compiler 5/6, .map analysis, merge/packaging, build diagnostics |
c-cpp-dev |
Code generation, style, memory layout, refactoring for C/C++ |
state-machine-design |
State models, retries, timeouts, transition gates, implementation patterns |
hardfault-triage |
Processor exception triage — fault registers, stack frames, PC-to-source, root-cause classification |
logicprobe (design doc & plan claim verification, logic-primitive verification, adversarial probing) was split out into its own plugin in v0.6.0 — see Other Plugins Recommended.
embedded-firmware-dev, debug-methodology, state-machine-design, and c-cpp-dev include in-depth reference material and code examples. Highlights: 12 architecture principles, embedded patterns (GIF timer safety, state latches, async lifecycle), LVGL pitfalls, 7-round iterative debugging case study, state machine implementation patterns, and embedded C specifics (volatile MMIO, linker sections, ISR wrappers).
Add the marketplace to ~/.claude/settings.json:
{
"extraKnownMarketplaces": {
"embedded-workbench": {
"source": { "source": "github", "repo": "AmethystLuna/embedded-workbench" }
}
}
}
Then install from CLI:
claude plugin install embedded-workbench@embedded-workbench
git clone https://github.com/AmethystLuna/embedded-workbench.git ~/.claude/plugins/dev/embedded-workbench
Then enable in ~/.claude/settings.json:
{
"enabledPlugins": {
"embedded-workbench@dev": true
}
}
Native dsh support ships as a cordis plugin bundle at the repository root (the root package.json declares dsh.bundle):
skill-filesystem provider (Agent Skills open standard) — zero code.SessionStart hook. It also registers a model-visible catalog entry (cordis_inspect).Install: see .dsh/INSTALL.md (four options, from plain skill copy to dsh plugin add).
The plugin auto-injects a capability notification at session start with a skill table, 1% Rule, and Red Flags reinforcement. Skills are loaded on demand:
Skill("embedded-workbench") for the full workflow systemUse when description matches your task — NOT clauses prevent false triggers (e.g., formatting-only won't load c-cpp-dev)This plugin also supports OpenAI Codex CLI. Skills follow the Agent Skills standard and work identically across both platforms. Agents are provided in Codex TOML format under .codex/agents/.
# Add as a marketplace
codex plugin marketplace add AmethystLuna/embedded-workbench
# Install
codex plugin install embedded-workbench
Or manually:
git clone https://github.com/AmethystLuna/embedded-workbench.git ~/.codex/plugins/embedded-workbench
Skills are invoked with $skill-name (e.g. $debug-methodology) or auto-selected by Codex based on task context.
Cursor 2.5+ has built-in plugin support. Agents in agents/ are auto-discovered.
# Clone to Cursor plugins directory
git clone https://github.com/AmethystLuna/embedded-workbench.git ~/.cursor/plugins/embedded-workbench
Or install from the Cursor plugin marketplace UI: /add-plugin AmethystLuna/embedded-workbench
Kimi CLI discovers skills from .claude/skills/ paths automatically. The .kimi-plugin/plugin.json manifest registers the plugin for Kimi's plugin manager.
# Via Kimi plugin manager
/plugins install https://github.com/AmethystLuna/embedded-workbench.git
# Or clone manually
git clone https://github.com/AmethystLuna/embedded-workbench.git ~/.kimi/plugins/embedded-workbench
Skills are invoked with /skill:<name> (e.g. /skill:debug-methodology).
Skills are auto-discovered from .claude/skills/ and .codex/skills/ paths. Add to your opencode.json:
{
"plugin": ["embedded-workbench@git+https://github.com/AmethystLuna/embedded-workbench.git"]
}
Or install via skop which consumes the Claude marketplace manifest. See .opencode/INSTALL.md for detailed instructions.
ZCode 3.0+ follows the Agent Skills standard. No plugin marketplace — manually copy skills to .zcode/skills/:
git clone https://github.com/AmethystLuna/embedded-workbench.git
cp -r embedded-workbench/skills/* .zcode/skills/
Skills are invoked with $skill-name. ZCode also auto-discovers from .claude/skills/ and .codex/skills/. See .zcode/INSTALL.md for details.
| Plugin | Description |
|---|---|
| logicprobe | Design doc & plan claim verification — logic-primitive verification (7 structural + 7 adversarial probes), refactoring regression detection. Split out of this plugin in v0.6.0; the Plan Verification Gate requires it. |
| superpowers | The original agent discipline engine — skill loading enforcement, Red Flags, subagent-driven development. Many of this plugin's agent-compliance patterns (1% Rule, Red Flags, <SUBAGENT-STOP>, instruction priority) were adapted from Superpowers. |
This plugin's agent-compliance architecture is adapted from Superpowers by Jesse Vincent (MIT License). Specific patterns adapted with gratitude:
<SUBAGENT-STOP> — preventing subagents from re-loading bootstrap contexttests/skill-triggering/ structure and methodologySuperpowers is a general-purpose development plugin. Embedded Workbench applies the same discipline patterns to the embedded C/C++ domain.
CLASSIFICATION EVIDENCE
系统优先读取 GitHub Topics,再与站内分类词典和词根规则比对。