| name | auto-embedded |
| description | 全平台嵌入式 AI 开发框架（对标 Trellis）：把 RIPER-5 五阶段协议 + 四文件记忆 + 分层架构门禁 + Scout/Builder/Verifier 多 Agent + 21 个工具调用技能（build/flash/debug/serial/can/modbus/visa/static/memory/rtos），做成『装进工程、项目级 hook 必然运行、按角色自动注入相关 spec、REVIEW 学习回流』的闭环，并一次写、全平台交付（Claude/Cursor/Codex/OpenCode/Copilot/Gemini/Windsurf）。用 `aemb init` 在固件工程里安装运行时与各平台注入接线。当用户要为 STM32/ESP32/GD32/MSPM0/RISC-V/国产 MCU 工程搭建可复用开发规范基座、让约定自动注入、跨会话可恢复、编译/烧录/调试一体化，或问到 auto-embedded/aemb/spec 注入/项目级 hook/全平台时使用。不适用于纯 Web/移动/桌面软件或与硬件无关的通用 C/C++。 |
| keywords | auto-embedded, aemb, 全平台嵌入式框架, 多平台, spec 注入, 项目级 hook, RIPER-5, 四文件记忆, 分层架构门禁, Scout Builder Verifier, hw-lock, promote 回流, 工具技能, build flash debug, STM32, ESP32, GD32, MSPM0, Claude Cursor Codex OpenCode Copilot Gemini Windsurf |
auto-embedded —— 装进工程、跨 7 个 AI 平台的 RIPER-5 + spec 注入 + 工具链框架
它是什么（与 embedded-dev 的区别）
embedded-dev 是全局单 skill 插件：refs 全局只读、靠模型自觉、frontmatter hook 对 user-skill 不生效、且只在 Claude 可用。
auto-embedded 对标 Trellis，把同一套能力做成装进每个固件工程、跨多个 AI 编码平台的基座：
- 项目级 hook 必然运行：
aemb init 把注入接线写进工程的各平台配置（Claude settings.json、Cursor/Codex/Copilot hooks.json、Gemini settings.json、OpenCode JS 插件…），AI 工具必然执行（不依赖 skill frontmatter hook）。
- 项目级 spec 库：
.auto-embedded/spec/（分层、可版本化、可覆盖），而非全局只读 refs。
- 相关性自动注入：会话起始注入阶段+spec 索引；派 Scout/Builder/Verifier 时按 per-task
*.jsonl 只 push 该角色相关的 spec。
- 学习回流：REVIEW 用
task.py promote 把决策/约定/坑沉淀回 spec，跨会话/跨任务复利。
- 工具链一体化：21 个工具调用技能（编译/烧录/调试/串口/CAN/Modbus/VISA/静态分析/内存分析/RTOS），脚本随框架装进
.auto-embedded/tools/，全平台都能调。
- 一次写、全平台交付：同一套 common 命令/技能/Agent 经占位符渲染成各平台正确语法，由各平台 configurator 写对应注入接线。
支持平台
已打通（7）：claude cursor codex opencode copilot gemini windsurf
预留位（7，注册表就绪、configurator 待实现）：kilo kiro antigravity qoder codebuddy droid pi
第一步：判断工程是否已安装
主交付物是固件且在某个工程目录时，先查该工程根有没有 .auto-embedded/：
日常驱动用 slash 命令 / 技能（init 已写进工程）：
/aemb:start <标题> · /aemb:continue · /aemb:finish-work · /aemb:status（Cursor 等为 /aemb-…，Codex 为 $aemb-…）。
命令速查
脚手架（aemb = npm 全局安装出的命令；或 node dist/cli/index.js）：
aemb init <工程> -u <名> [--platforms a,b | --<平台> … | --all] # 安装运行时 + 选定平台接线
aemb update <工程> # 升级 managed（脚本/hooks/agents/commands/工具），保留 spec/tasks/用户改动
aemb doctor <工程> # 体检 7 平台接线
aemb check <工程> [--arch|--hw|--spec|--json] # 机械门禁
aemb backup <工程> # 备份 .auto-embedded/
aemb uninstall <工程> # 按 manifest 剥除 aemb 片段 + 删 .auto-embedded（先备份）
底层脚本（slash 命令内部调它，也可直接用）：
python .auto-embedded/scripts/task.py start "<标题>" | phase PLAN | select builder spec/architecture/index.md "原因" | promote conventions "<学习>" | list | journal "<摘要>" | archive
工作流（RIPER-5，权威在工程的 workflow.md）
每条回复开头声明 [MODE: 阶段]。默认 RESEARCH 起；含写代码的清单项进 EXECUTE 前必须过 PLAN 审查门并获用户确认。
| 阶段 | 干什么 | 角色 |
|---|
| RESEARCH | 查芯片/库、读 spec、引脚规划写 hw-lock.yaml、证据写 research.md | Scout(只读) |
| INNOVATE | 评候选方案 | — |
| PLAN | 出实施清单（路径+签名+寄存器+验证标准+review+层级）；零占位符 | — |
| EXECUTE | 按轮次最小实现，每轮带 trace_id+验证标准+证据；本地 git 快照 | Builder(单写者) |
| REVIEW | 验证门→硬件合规(对照 hw-lock)→分层门禁→promote 回流 | Verifier(只审) |
多文件/长任务按 Scout→Builder→Verifier 分权，同一时刻只一个 Builder 写。
派 Agent：aemb-scout|aemb-builder|aemb-verifier，hook（push 平台）或 prelude（pull 平台 Codex/Copilot/Gemini 子 Agent）会按角色注入相关 spec。
工具调用技能（22，全平台交付）
脚本随框架装进 .auto-embedded/tools/<skill>/scripts/，按需用 python 调；SKILL 描述自动触发：
- 编译：
build-cmake build-iar build-idf build-keil build-makefile build-platformio
- 烧录：
flash-idf flash-jlink flash-keil flash-openocd flash-platformio
- 调试：
debug-gdb-openocd debug-jlink debug-platformio
- 观测/分析：
serial-monitor static-analysis memory-analysis rtos-debug
- 总线/仪器：
can-debug modbus-debug visa-debug
- 驱动：
peripheral-driver（开源驱动搜索→评估→适配/骨架；方法论见 .auto-embedded/refs/stm32-hal/）
知识库与专项流程（自上一代 embedded-dev 全量吸收，按需加载）
上一代 embedded-dev 的离线知识库与专项流程已 bundle 进运行时，随 aemb init 装入工程，按需读取（不自动全量注入，防撑爆上下文）：
.auto-embedded/refs/（55+ 篇）—— STM32/GD32 API、引脚规划、IMU、故障分类、编码规范、驱动移植、竞赛清单/契约…总览见 refs/index.md；refs/stm32-hal/ 为 STM32 HAL 方法论 + BSP 模板领域包。.auto-embedded/modes/（12 篇）—— RIPER-5 主干外的专项工作流：competition（比赛 6-Agent + CP 门禁）、datasheet-lookup、netlist-lookup、gd32-board、mspm0-board、seekfree-lib、matlab-*、industrial-data-acquisition、mcp-healthcheck、workflow-orchestration。总览见 modes/index.md。
比赛模式：用户说"启用比赛模式"时进入 .auto-embedded/modes/competition.md，由 6 个专职 subagent 并行推进：
embedded-arch（唯一决策者/路由/集成）· embedded-drv（驱动）· embedded-alg（算法）· embedded-matlab（MATLAB 仿真）· embedded-qa（验证门）· embedded-report（报告），配合 CP-0~CP-5 决策门与 Defect Ticket 回派协议。 并行编排完整支持 Claude；其余平台装入 agent 定义但派发受限（Codex 禁 spawn、Copilot 无 Task 映射），降级为单代理按 modes/competition.md 顺序走 CP 门禁。日常 RIPER-5 仍用 aemb-scout/builder/verifier 三角色。
spec 库（项目级，可演进）
.auto-embedded/spec/ 五层（见各 index.md）：architecture（六层模型+ARCH-1~8）、conventions（证据优先/复用优先/ISR/临界区/Git 快照）、hardware（事实基线 + 机器可读 hw-lock.yaml）、guides（思维清单）、governance（记忆边界）。
新增/改约定就改对应 index.md；REVIEW 用 promote 沉淀，下次自动注入。
架构（开发者向）
src/types/ai-tools.ts（平台注册表数据）→ src/configurators/*（每平台行为 + shared.ts 占位符渲染 + merge.ts 配置合并 + hooks.ts 共享 hook 分发）→ templates/（common/ 共享 body、shared-hooks/ 三个 Python hook、<平台>/ 私有模板、auto-embedded/ 运行时内核 + 工具脚本）。新增平台：加注册表条目 + 写 configurators/<平台>.ts + 在 configurators/index.ts 注册。
自测
bash tests/test-auto-embedded.sh
临时工程里 init --all 并断言整条闭环（7 平台脚手架/doctor/幂等/内核/工具脚本 shared 导入/SessionStart+面包屑+子 Agent 注入/卸载全清）。
