Workflow 流水线编排
【用途】 Workflow 用于串联多个 skill,完成嵌入式开发中常见的多步骤流水线任务。典型场景是「编译 + 烧录 + 监控」或「编译 + 烧录 + 调试」的组合流程,让开发者用统一接口一键走完从构建到运行观察的完整环节。
【适用场景】
- 需要一键完成编译、烧录、串口监控的完整开发流程。
- 需要编译后自动烧录并启动 GDB 调试。
- 需要在不同构建系统(Keil/CMake/PlatformIO)间使用统一的流水线接口。
【必要输入】
- 构建系统类型(keil、cmake、platformio)。
- 工程路径。
- 可选:构建目标、串口、波特率、烧录参数。
【依赖】
- 对应构建系统的 skill 脚本已存在(build-keil、flash-keil 等)。
- 各 skill 的外部依赖已安装(Keil UV4、CMake、PlatformIO CLI 等)。
【使用方式与执行步骤】
- 先阅读 references/usage.md,确认参数。
- 探测环境: python scripts/workflow_runner.py --detect
- 查看可用流水线: python scripts/workflow_runner.py --list
- 执行流水线: 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] 编译 [2/3] 烧录 [3/3] 串口监控 📊 结果: ✅ 流水线完成(3 步)
【交接关系】
- 编排 build-keil / build-cmake / build-platformio 的编译步骤。
- 编排 flash-keil / flash-openocd / flash-platformio 的烧录步骤。
- 编排 serial-monitor 的监控步骤。
- 编排 debug-gdb-openocd / debug-platformio 的调试步骤。
【限制】 流水线依赖对应构建系统的 skill 脚本与外部工具已就绪;若脚本缺失会返回 environment-missing,若步骤执行失败会返回 target-response-abnormal。其他未在资料中说明的功能、平台与限制暂未提供。