workflow
/workflow
embeddedskills 的薄编排层,用于在当前 workspace 中发现工程、选择 build/flash/debug/observe 后端、串联 .embeddedskills/state.json,并聚合底层 skill 的结果。 当用户明确输入以下命令之一:"一键构建烧录"、"自动诊断"、"串起 build -> flash -> debug -> observe" 或显式调用 /workflow 时触发。
- Author
- zhinkgit ↗
- Repository
- embeddedskills ↗
- Licence
- MIT
- Last repository change
- 20.10.2026
Assessment and security
- Files in this package
- 6
- Scripts
- 3
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 20.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 3 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/workflow_plan.py, scripts/workflow_run.py, scripts/workflow_runtime.py
What it does and when to use it
embeddedskills 的薄编排层,用于在当前 workspace 中发现工程、选择 build/flash/debug/observe 后端、串联 .embeddedskills/state.json,并聚合底层 skill 的结果。 当用户明确输入以下命令之一:"一键构建烧录"、"自动诊断"、"串起 build -> flash -> debug -> observe" 或显式调用 /workflow 时触发。
Triggers from the description
Arguments
/workflow [plan|build|build-flash|build-debug|observe|diagnose] ...
Original author description
embeddedskills 的薄编排层,用于在当前 workspace 中发现工程、选择 build/flash/debug/observe 后端、串联 .embeddedskills/state.json,并聚合底层 skill 的结果。 当用户明确输入以下命令之一:"一键构建烧录"、"自动诊断"、"串起 build -> flash -> debug -> observe" 或显式调用 /workflow 时触发。
How it works
- 命令
- 配置说明
- 规则
SKILL.md preview
---
name: workflow
description: >-
embeddedskills 的薄编排层,用于在当前 workspace 中发现工程、选择 build/flash/debug/observe
后端、串联 .embeddedskills/state.json,并聚合底层 skill 的结果。
当用户明确输入以下命令之一:"一键构建烧录"、"自动诊断"、"串起 build -> flash -> debug -> observe" 或显式调用 /workflow 时触发。
argument-hint: "[plan|build|build-flash|build-debug|observe|diagnose] ..."
---
# Workflow 编排层
本 skill 不重复实现底层逻辑,只做发现、选择、串联和聚合。
支持 **Keil** / **GCC** / **EIDE** 三种构建后端,以及 **jlink** / **openocd** / **probe-rs** 三种 flash/debug/observe 后端。
`observe` 阶段当前会给出 `jlink:rtt`、`jlink:swo`、`openocd:semihosting`、`openocd:itm`、`probe-rs:rtt` 这几类候选观测后端。
## 命令
```bash
python <skill-dir>/scripts/workflow_plan.py --json
python <skill-dir>/scripts/workflow_run.py plan --json
python <skill-dir>/scripts/workflow_run.py build --json
python <skill-dir>/scripts/workflow_run.py build-flash --json
python <skill-dir>/scripts/workflow_run.py build-debug --json
python <skill-dir>/scripts/workflow_run.py observe --json
python <skill-dir>/scripts/workflow_run.py diagnose --json
```
## 配置说明
workflow 不再维护独立的工程配置结构,所有工程参数统一从 `.embeddedskills/config.json` 读取。
### 配置结构
`.embeddedskills/config.json` 中的 `workflow` 段仅包含首选后端配置:
```json
{
"workflow": {
"preferred_build": "auto",
"preferred_flash": "auto",
"preferred_debug": "auto",
"preferred_observe": "auto"
}
}
```
workflow 通过读取 `.embeddedskills/config.json` 中其他 skill 的配置段来获取工程参数(如 `keil.project`、`eide.project`、`eide.config`、`jlink.device`、`probe-rs.chip` 等)。
### 参数解析顺序
按以下决策树依次判断,命中即停止:
1. **CLI 参数**(优先级最高)
- 条件:用户在命令行传入 `--build-backend`、`--flash-backend` 等参数
- 示例:`workflow_run.py build-flash --build-backend=keil --flash-backend=jlink`
- `--build-backend` 可选值:`auto` / `keil` / `gcc` / `eide`
- 行为:直接使用该参数指定的后端,跳过后续步骤
2. **配置文件**(次优先)
- 条件:CLI 未指定,且 `.embeddedskills/config.json` 的 `workflow` 段中对应 `preferred_*` 字段不为 `"auto"`
- 示例:`"preferred_build": "keil"` → 使用 keil 作为构建后端
- 行为:读取配置值并使用,跳过自动发现
3. **自动发现**(兜底)
- 条件:CLI 未指定,且配置中 `preferred_*` 为 `"auto"` 或字段缺失
- 示例:`"preferred_flash": "auto"` → 扫描 workspace 自动推断可用 flash 后端
- 行为:枚举候选后端列表;若唯一则直接使用,若多个则返回列表请用户确认
成功执行后,实际使用的后端会自动写回 `.embeddedskills/config.json` 的 `workflow` 段。
## 规则
- 发现多个工程或多个候选后端时,只返回候选列表,不自动猜测
- 构建、烧录、调试、观测之间优先通过 `.embeddedskills/state.json` 串联
- `observe` 只生成推荐命令,不在 workflow 内直接长时间占用观测通道
- 失败时优先返回哪个阶段失败,以及底层脚本的结构化错误
- workflow 与其他 Skill 的协同只通过 `.embeddedskills/config.json`、`.embeddedskills/state.json` 和子进程调用底层 Skill
Files in this package (6)
- README.md 2 KB
- SKILL.md 3 KB
- config.example.json 1 KB
- scripts/workflow_plan.py 5 KB
- scripts/workflow_run.py 26 KB
- scripts/workflow_runtime.py 10 KB
Versions
| Repository | Score | Licence |
|---|---|---|
| This page · zhinkgit/embeddedskills | 100 | MIT |
| jeremylongshore/tons-of-skills-marketplace | 100 | MIT |
| SimHacker/moollm | 100 | MIT |
| mlophez/polix-ai | 100 | Apache-2.0 |
| stellarie/minimal-agent-kit | 100 | MIT |
| waynesutton/builder-skills | 100 | Apache-2.0 |
| claude-world/director-mode-lite | 100 | MIT |
| DawitLemmaBalcha/agent-workflow | 100 | MIT |
| anthillapp/anthill | 100 | MIT |
Database snapshot: 13.11.2026 · package version d0b9de69a536 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100output-debug-workflow
Debug Output SDK workflow issues. Use when user reports a workflow failing, erroring, hanging, producing wrong results, or asks to debug, troubleshoot, or investigate a workflow execution. - 90esp32-flash-vendor-compatibility
Use when designing, reviewing, debugging or validating flash vendor compatibility for ESP32 firmware; apply target-specific constraints, failure analysis and measurable verification before release. - 100qspi-xip-flash-debug
Use when debugging QSPI or OSPI NOR flash, execute-in-place XIP, memory-mapped mode, boot from external flash, cache coherency, dummy cycles, or flash timing