mcpField
W
workflow

workflow

github.com/leokemp223Development1.0k570 installsUpdated 10w ago
Repository

About workflow

A workflow orchestration skill for embedded development that coordinates build, flash, serial monitoring, and debugging steps across Keil, CMake, and PlatformIO projects.

Key features

  1. 01Orchestrates build, flash, and monitoring
  2. 02Supports Keil, CMake, and PlatformIO
  3. 03Detects environments and lists workflows
  4. 04Can chain GDB debugging steps

Use cases

  1. 01Build, flash, and monitor serial output in one run
  2. 02Flash automatically after building, then start debugging
  3. 03Reuse workflows across different build systems

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/leokemp223/embed-ai-tool --skill workflow

After installing, type/workflowin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
references/
usage.md
scripts/
workflow_runner.py

Details

From the project README

Workflow 流水线编排

适用场景

  • 需要一键完成编译、烧录、串口监控的完整开发流程。
  • 需要编译后自动烧录并启动 GDB 调试。
  • 需要在不同构建系统(Keil/CMake/PlatformIO)间使用统一的流水线接口。

必要输入

  • 构建系统类型(keil、cmake、platformio)。
  • 工程路径。
  • 可选:构建目标、串口、波特率、烧录参数。

依赖

  • 对应构建系统的 skill 脚本已存在(build-keil、flash-keil 等)。
  • 各 skill 的外部依赖已安装(Keil UV4、CMake、PlatformIO CLI 等)。

执行步骤

  1. 先阅读 references/usage.md,确认参数。
  2. 探测环境:
    python scripts/workflow_runner.py --detect
    
  3. 查看可用流水线:
    python scripts/workflow_runner.py --list
    
  4. 执行流水线:
    python scripts/workflow_runner.py --run build-flash-monitor --build-system platformio --project /path/to/project
    

失败分流

  • environment-missing:对应 skill 脚本不存在。
  • target-response-abnormal:某个步骤执行失败(编译错误、烧录失败等)。

输出约定

示例输出格式:

🚀 执行流水线: build-flash-monitor(编译 → 烧录 → 串口监控)
  构建系统: platformio

==================================================
[1/3] 编译
==================================================
  $ python .../platformio_builder.py --project-dir /path

==================================================
[2/3] 烧录
==================================================
  $ python .../pio_flasher.py --flash --project-dir /path

==================================================
[3/3] 串口监控
==================================================
  $ python .../serial_monitor.py --listen --port COM42

📊 结果: ✅ 流水线完成(3 步)

交接关系

  • 编排 build-keil / build-cmake / build-platformio 的编译步骤。
  • 编排 flash-keil / flash-openocd / flash-platformio 的烧录步骤。
  • 编排 serial-monitor 的监控步骤。
  • 编排 debug-gdb-openocd / debug-platformio 的调试步骤。

Comments

Markdown supported