embed-ai-tool

embed-ai-tool 总控

本技能负责两类交互：安装引导 和 指令消歧。

缓存复用提示：所有 build/flash 脚本启动时会自动复用工程根目录 .em_skill.json 中上次成功的 profile 作为默认参数（显式参数优先，无需 agent 先手动传 --resume）；--resume 仅用于断言缓存必须存在，无缓存则非零退出。新会话直接运行目标动作（--build / --flash 等）即可，缓存命中时参数自动补全。

---

一、安装引导

当用户请求安装本仓库的 skill 时，按以下流程引导。不要跳过询问直接安装，也不要替用户决定安装内容——先分析工程，再让用户选。

流程

1. 分析工程 — 探测当前工作区的工程特征（构建系统、工具链、探针、协议线索等），详见"工程分析项"
2. 呈现分析结果 — 把探测到的事实客观列给用户，未识别出的也要明确说明
3. 提供选项 — 基于分析结果给出可选安装方案（推荐集 / 全部 / 按分类 / 自定义），让用户选择，详见"提供的安装选项"
4. 执行安装 — 根据用户选择执行对应命令；用户可在推荐集基础上增删，不必重走流程

工程分析项

按工作区文件特征推断工程画像，规则优先级从高到低：

探测失败时：如果工作区特征不明显（纯裸 C 文件、混合工程、空目录），直接告知用户"未识别出明确工程类型"，建议选"全部安装"或"自定义"——不要硬推推荐集。

推荐集映射

按识别到的工程画像给出基础推荐集（用户可在其上增删）：

基础集是起点，根据"工程分析项"探测到的协议线索继续追加：

• 检测到 RTOS → 追加 rtos-debug
• 检测到 Modbus → 追加 modbus-debug
• 检测到 CAN → 追加 can-debug
• 检测到 VISA / SCPI → 追加 visa-debug
• 工程能产 .map / .elf → 追加 memory-analysis

提供的安装选项

分析完成后，向用户呈现 4 个并列选项：

用户选 A 后仍可微调（如"再加个 modbus-debug"），不要重走一遍流程。

分类逐一勾选流程

用户选 C 后，按 6 个分类顺序逐一询问。每个分类独立交互，用户可全选、跳过或勾选部分。基于工程分析预先勾选推荐项，降低决策成本。

分类顺序与内容：

单次分类询问格式：

[2/6] 烧录（5 个 skill）：

   ✅ 1. flash-openocd    — OpenOCD 烧录（识别到 .vscode/launch.json）
   ☐  2. flash-keil       — Keil MDK 烧录
   ☐  3. flash-jlink      — SEGGER J-Link 烧录
   ☐  4. flash-platformio — PlatformIO 上传
   ☐  5. flash-idf        — ESP-IDF 串口烧录

   操作：回车确认默认 / 输入编号增删（如 +3 -1）/ "全选" / "跳过"

👤 +3

🤖 [3/6] 调试（4 个 skill）：
   ...

完成所有分类后：汇总最终选定的 skill 列表，让用户确认或微调，然后执行安装。

如果用户对某个分类无任何勾选且工程分析也没识别到，应主动确认"跳过 X 分类？"避免遗漏关键能力（比如构建和烧录通常必须）。

安装示例

👤 帮我安装 embed-ai-tool 的 skill

🤖 正在分析当前工程...

   检测到工程特征：
   • 构建系统：CMake（CMakeLists.txt）
   • 目标架构：ARM Cortex-M（PATH 含 arm-none-eabi-gcc）
   • 调试器配置：OpenOCD + ST-Link（.vscode/launch.json）
   • 协议线索：UART stdio 重定向（main.c）
   • RTOS：未检测到

   可选安装方案：

   A. 推荐集（6 个）— build-cmake / flash-openocd / debug-gdb-openocd / serial-monitor / memory-analysis / workflow
   B. 全部安装（22 个）
   C. 按分类逐一勾选（6 个分类顺序询问）
   D. 自定义（输入 skill 名或编号）

   请选择（A / B / C / D）：

👤 A，再加个 rtos-debug

🤖 安装：build-cmake / flash-openocd / debug-gdb-openocd / serial-monitor / memory-analysis / workflow / rtos-debug
   执行中...

可用技能列表

完整技能清单，用于"按分类选（C）"和"自定义（D）"时参考。推荐集（A）的子集由"工程分析项"和"推荐集映射"自动推导。

安装命令

优先使用 npx skills，若用户无 Node.js 环境改用 Python 脚本。

# npx 全部安装
npx skills add LeoKemp223/embed-ai-tool -g -y

# npx 按需安装
npx skills add LeoKemp223/embed-ai-tool --skill build-cmake --skill flash-openocd -g -y

# Python 全部安装
python3 /tmp/embed-ai-tool/scripts/install.py /path/to/project

# Python 按需安装
python3 /tmp/embed-ai-tool/scripts/install.py /path/to/project --skills build-cmake flash-openocd

---

二、指令消歧

当用户发出模糊指令（如"烧录"、"编译"、"调试"）时，先尝试自动探测工程类型；若无法明确判断，必须列出候选 skill 让用户选择，不要自行假设。

消歧流程

用户输入模糊指令
    │
    ▼
自动探测工程类型
    │
    ├─ 唯一匹配 → 直接调用对应 skill
    │
    └─ 匹配多个或无法判断 → 列出候选 skill 供用户选择

自动探测规则

按工作区文件特征判断工程类型，规则优先级从高到低：

分类候选表

当自动探测无法唯一确定时，按用户指令所属分类展示候选 skill：

编译 / 构建：

烧录 / 下载：

调试：

通信 / 监控：

示例交互

👤 烧录
🤖 当前工作区未检测到明确的烧录工具配置，请选择：
   1. flash-keil — Keil MDK 内置调试器烧录
   2. flash-openocd — OpenOCD 烧录（ST-Link / CMSIS-DAP）
   3. flash-jlink — SEGGER J-Link 烧录
   4. flash-platformio — PlatformIO 上传
   5. flash-idf — ESP-IDF 串口烧录
   请输入编号或 skill 名称：

👤 2
🤖 使用 flash-openocd，正在探测探针和固件产物...

---

安装后提示

安装完成后，告知用户：

• 已安装的 skill 列表
• 使用 /skill-name 调用具体 skill，例如 /build-cmake、/serial-monitor
• 用自然语言描述需求即可触发对应 skill，例如"编译烧录"、"看串口"
• 管理命令：npx skills ls -g（查看）、npx skills update -g（更新）、npx skills remove -g（移除）