菜单
EIDE (Embedded IDE) 工程构建工具，用于扫描 .eide/eide.yml 工程、枚举构建 配置 (ConfigName)、执行 build/rebuild/clean 并解析构建日志，返回可供 jlink/openocd 复用的产物路径。当用户提到 EIDE、Embedded IDE、eide.yml、 unify_builder、VS Code EIDE 扩展、Cl.eide 时自动触发，也兼容 /eide 显式调用。 即使用户只是说"用 EIDE 编译一下"或"EIDE 烧录到板子上"，只要上下文涉及 EIDE 嵌入式工程就应触发此 skill。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Keil MDK 工程构建工具，用于扫描 .uvprojx/.uvproj/.uvmpw 工程、枚举 Target、执行 build/rebuild/clean 并解析构建日志，返回可供 jlink/openocd 复用的产物路径。 flash 子命令仅作为兼容入口保留。当用户提到 Keil、MDK、uVision、UV4、 Target 枚举、编译、重建、清理、烧录、下载固件、flash 时自动触发，也兼容 /keil 显式调用。 即使用户只是说"编译一下"或"烧录到板子上"，只要上下文涉及嵌入式 Keil 工程就应触发此 skill。
embeddedskills 的薄编排层，用于在当前 workspace 中发现工程、选择 build/flash/debug/observe 后端、串联 .embeddedskills/state.json，并聚合底层 skill 的结果。 当用户明确输入以下命令之一："一键构建烧录"、"自动诊断"、"串起 build -> flash -> debug -> observe" 或显式调用 /workflow 时触发。
双向交互终端会话工具，用于串口终端、SSH 交互 Shell、本地 Shell、设备控制台、AT/CLI 菜单、需要保持上下文的交互式调试；当用户提到交互终端、串口终端、SSH 终端、打开 shell、发送命令后继续读输出、保持会话、登录后操作、菜单式命令行时触发，也兼容 /terminal 显式调用。
SSH/服务器操作助手。用于远程服务器、user@host、SSH 配置、上传下载、部署、跳板机、隧道、端口转发、服务器命令执行等任务；以 ~/.ssh/config 的 Host 别名为唯一服务器清单，优先密钥认证，通过本 skill 的 Python 脚本封装 OpenSSH 操作。
嵌入式 CAN / CAN-FD 调试工具，用于扫描接口、监控报文、发送测试帧、记录日志、数据库文件解码和总线统计。 当用户提到 CAN、CAN-FD、DBC 解码、总线抓包、USB-CAN 联调、报文发送、总线统计、 PCAN、Vector、slcan、CAN 接口扫描、CAN ID 过滤、ASC 日志、BLF 文件时自动触发， 也兼容 /can 显式调用。即使用户只是说"看看 CAN 报文"、"发一帧试试"或"解码一下 DBC"， 只要上下文明确提到 CAN 总线通信的操作或问题就应触发此 skill。
GCC 嵌入式工程构建工具（CMake + arm-none-eabi-gcc），用于扫描 CMake 型嵌入式工程、 列出预设、配置、编译、重建、清理和分析 ELF 大小。当用户提到 GCC、arm-none-eabi、 CMake 嵌入式编译、Ninja 构建、ELF 大小分析、arm-gcc、交叉编译、cmake --build、 cmake --preset 时自动触发，也兼容 /gcc 显式调用。即使用户只是说"编译一下"或 "看看固件多大"，只要上下文涉及 CMake 嵌入式 GCC 工程就应触发此 skill。
| name | eide |
| description | EIDE (Embedded IDE) 工程构建工具，用于扫描 .eide/eide.yml 工程、枚举构建 配置 (ConfigName)、执行 build/rebuild/clean 并解析构建日志，返回可供 jlink/openocd 复用的产物路径。当用户提到 EIDE、Embedded IDE、eide.yml、 unify_builder、VS Code EIDE 扩展、Cl.eide 时自动触发，也兼容 /eide 显式调用。 即使用户只是说"用 EIDE 编译一下"或"EIDE 烧录到板子上"，只要上下文涉及 EIDE 嵌入式工程就应触发此 skill。 |
| argument-hint | [scan|configs|build|rebuild|clean|size] ... |
本 skill 提供 EIDE (Embedded IDE) 工程的发现、构建配置枚举、增量编译、全量重建、清理和 ELF 大小分析能力，并返回可供 jlink/openocd 继续使用的固件产物路径。
EIDE 是 VS Code 下的嵌入式开发扩展，使用 ARM CC (AC5/AC6) 或 GCC 工具链，通过 unify_builder 统一构建后端驱动。
skill 目录下的 config.json 包含环境级配置，首次使用前确认 builder_dir 路径正确：
{
"builder_dir": "C:\\Users\\<user>\\.vscode\\extensions\\cl.eide-<version>\\res\\tools\\win32\\unify_builder",
"builder_exe": "unify_builder.exe",
"code_exe": "code",
"toolchain_prefix": "arm-none-eabi-",
"operation_mode": 1
}
builder_dir：EIDE unify_builder 所在目录（必填，位于 VS Code 扩展目录下）builder_exe：builder 可执行文件名，Windows 默认 unify_builder.execode_exe：VS Code CLI 路径，默认从 PATH 查找 codetoolchain_prefix：用于 size 分析的工具链前缀，默认 arm-none-eabi-operation_mode：1 直接执行 / 2 输出风险摘要但不阻塞 / 3 执行前确认工程级共享配置统一保存在工作区的 .embeddedskills/config.json 中：
{
"eide": {
"project": "",
"config": "",
"log_dir": ".embeddedskills/build"
}
}
project：默认 EIDE 工程根目录（包含 .eide/eide.yml 的目录），构建成功后会自动更新config：默认构建配置名称（对应 eide.yml 中的 ConfigName），构建成功后会自动更新log_dir：构建日志输出目录，默认 .embeddedskills/build参数解析顺序（从高到低）：
.embeddedskills/state.json（上次构建记录）| 子命令 | 用途 | 风险 |
|---|---|---|
scan | 搜索当前目录下的 EIDE 工程（含 .eide/eide.yml 的目录） | 低 |
configs | 枚举工程中的构建配置 | 低 |
build | 增量编译 | 中 |
rebuild | 全量重建 | 中 |
clean | 清理构建产物 | 高 |
size | 分析 ELF 文件大小（text/data/bss 和内存使用） | 低 |
config.json，确认 builder_dir 路径有效scanscan 搜索工程build/rebuild/clean 按 operation_mode 决定是否需要确认build/rebuild 成功后，从构建目录解析 elf_file / hex_file 等产物路径builder.params 调用 unify_builder，输出到日志文件后解析size 默认分析最近一次构建产物的 .elf 文件skill 目录下有 Python 脚本，使用标准库 + PyYAML 实现。
# 扫描工程
python <skill-dir>/scripts/eide_project.py scan --root <搜索目录> --json
# 枚举构建配置
python <skill-dir>/scripts/eide_project.py configs --project <工程目录> --json
python <skill-dir>/scripts/eide_build.py <build|rebuild|clean> \
--builder-dir <unify_builder目录> \
--project <工程根目录> \
--config <配置名称> \
--log-dir <日志目录> \
--json
rebuild 额外支持 --clean-first 先清理再重建。
# 基本分析
python <skill-dir>/scripts/eide_size.py analyze \
--elf <elf文件路径> \
--toolchain-prefix arm-none-eabi- \
--json
# 对比分析
python <skill-dir>/scripts/eide_size.py compare \
--elf <elf文件1> \
--compare <elf文件2> \
--toolchain-prefix arm-none-eabi- \
--json
所有脚本以 JSON 格式返回，基础字段为 status（ok/error）、action、summary、details，并可能附带 context、artifacts、metrics、state、next_actions、timing。
成功示例：
{
"status": "ok",
"action": "build",
"summary": "build 成功，errors=0 warnings=2",
"details": {
"project": "Vendor/EIDE",
"config": "W20_Mainboard",
"build_dir": "build/W20_Mainboard",
"elf_file": "build/W20_Mainboard/MDK-ARM_F403A.elf",
"hex_file": "build/W20_Mainboard/MDK-ARM_F403A.hex",
"log_file": ".embeddedskills/build/MDK-ARM_F403A-W20_Mainboard-build.log"
},
"artifacts": {
"elf_file": "build/W20_Mainboard/MDK-ARM_F403A.elf",
"hex_file": "build/W20_Mainboard/MDK-ARM_F403A.hex",
"flash_file": "build/W20_Mainboard/MDK-ARM_F403A.hex",
"debug_file": "build/W20_Mainboard/MDK-ARM_F403A.elf"
},
"metrics": { "errors": 0, "warnings": 2, "flash_bytes": 32768, "ram_bytes": 8192 }
}
错误示例：
{
"status": "error",
"action": "build",
"error": { "code": "builder_not_found", "message": "unify_builder.exe 不存在，请确认 EIDE 扩展已安装" }
}
.eide/eide.yml 或任何 EIDE 工程配置文件flash_file / debug_file 与 jlink/openocd 串联clean 不在自动流程中隐式执行.eide/eide.yml 的目录为根目录本项目中的 EIDE 工程与 Keil MDK 工程共享相同的源码和 ARM CC 工具链（D:\Keil_V543\ARM\ARMCLANG）。EIDE 工程通过 eide.yml 描述工程结构，builder.params 由 EIDE 自动生成并供 unify_builder 使用。两者的构建产物（.axf/.hex/.elf）格式兼容，可互换使用。
cl.eide 安装eide.yml 格式：见 EIDE 扩展文档builder.params：由 EIDE 自动生成，位于 build/<ConfigName>/builder.params