embedded-mcp-toolkit: Skill for Claude Code

任务

在 board-ubuntu 上编译内核的同时，在 board-b 上通过串口登录并进入 U-Boot 命令行。编译完成后根据结果决定后续操作：成功则在 U-Boot 下获取信息并重启，失败则保持 U-Boot 状态。

背景

内核编译是耗时操作。利用 code-build 子 agent 在 board-ubuntu 上后台执行编译，与此同时主 agent 在 board-b 串口上并行完成登录、系统信息采集和 U-Boot 进入，从而最大化并行效率。

步骤

并行原理（核心）：Claude Code 的 Agent 工具默认是阻塞的——会同步等待子 agent 执行完才返回。要实现"编译与串口操作并行"，启动 code-build 时必须传 run_in_background: true：它调用后立即返回一个 task_id，子 agent 在后台编译，主 agent 转身去做串口的活。编译完成后系统自动发 task-notification 通知主 agent，再用 TaskOutput 取回结果。

第一步：启动编译子 agent（后台异步）

1. 单独调用 Agent 工具启动 code-build 子 agent，并设 run_in_background: true

   参数：

   • description："编译 board-ubuntu 内核"
   • subagent_type："code-build"
   • run_in_background：true
   • prompt（将以下内容整体作为 prompt 参数传入）：

   请登录 board-ubuntu 并在 ~/workspace/Alpha/kernel 目录下执行编译：
   1. 使用 ssh_shell_login 登录 board-ubuntu（device: "board-ubuntu"）
   2. 使用 ssh_build 在 ~/workspace/Alpha/kernel 目录执行命令：./build.sh alpha -a -c
      - cwd 设为 "~/workspace/Alpha/kernel"
      - command 设为 "./build.sh alpha -a -c"
      - maxWait 设为 1800000（30 分钟，内核编译可能很久）
   3. 编译结束后，使用 ssh_shell_close 关闭会话
   4. 返回编译结果（成功/失败），如果有错误请列出关键错误信息，如果有警告请列出警告摘要
   

   调用后 Agent 立即返回一个 task_id（务必记下它），子 agent 在后台开始编译。不要同步等待结果，继续执行下一步。

第二步：串口登录 board-b（编译在后台进行中）

1. 单独调用 serial_shell_login 登录 board-b
   • device 设为 "board-b"
   • 从返回结果中获取 session_id（如 serial_1）

第三步：获取系统信息并进入 U-Boot（编译仍在后台进行）

1. 获取 board-b 系统信息

   • 单独调用 serial_exec，使用步骤 2 的 session_id，执行以下命令（delay 设为 3000）：

   echo "=== Hostname ===" && hostname && echo "=== Kernel ===" && uname -a && echo "=== Uptime ===" && uptime && echo "=== Memory ===" && free -h && echo "=== Disk ===" && df -h /
   

   • 记录并格式化输出系统信息

2. 进入 U-Boot

   • 单独调用 serial_enter_uboot，使用步骤 2 的 session_id
   • timeout 设为 120（秒）
   • 确认已进入 U-Boot 命令行（出现 => 或 U-Boot> 提示符）

第四步：等待编译结果并处理

1. 取回后台编译结果
   • 此时主 agent 已完成串口端的所有准备工作（已进入 U-Boot）
   • 调用 TaskOutput 取回第一步的 task_id 对应的结果：task_id 传入后台任务 id，block 设为 true 阻塞等待编译完成，timeout 设为 600000（10 分钟）。
   • 若一次 TaskOutput 返回任务仍未结束（编译超 10 分钟），再次调用 TaskOutput 继续等待，直到拿到 code-build 的最终汇报文本。
   • 也可在收到该 task_id 的 task-notification 通知后，再调用一次 TaskOutput（block 可为 false）取回完整结果。