用途：Workflow Markdown 是一个把文档与可执行指令结合的 Markdown 工作流执行系统，让智能体能够从人类可读的 Markdown 文件中读取、理解并执行多步骤工作流。它改编自 OpenClaw 的 .agent/workflows/ 模式。
主要能力：发现并解析工作流文件（默认搜索路径 .agent/workflows/.md、.pi/workflows/.md、workflows/*.md）；提取 YAML frontmatter 元数据与可执行代码块；在保留上下文的前提下逐步执行；生成执行报告。提供 workflow_list（列出工作流，可按 tag 过滤）、workflow_run（按名称或变量运行，支持 dryRun）、workflow_validate（校验文件）、workflow_template（从模板创建）等工具。代码块支持 shell/bash、javascript/js、python/py、json、yaml，并可用 check、setup、teardown、report 等步骤标识；支持 {{变量}} 替换。
使用方式：在工作流文件中用 frontmatter 声明 name、description、tags、context（required_files、working_directory）、requires_confirmation 等字段；正文用带步骤标识的代码块编写命令；通过 workflow_run 传入 variables 运行。可在项目根目录用 WORKFLOW_CONFIG.md 配置搜索路径、默认变量与 pre_run/post_run 钩子。
适用场景：依赖更新、生产部署、新项目初始化等需要多步骤、可文档化的自动化流程，也支持与 multi-agent-orchestrator、secure-sandbox、browser-tools 等技能集成。
限制：非零退出码会停止执行（除非步骤标记为可选）；安全方面会对 shell 命令做校验、标记危险模式并支持工作目录沙箱，但受限命令、超时等细节需按资料配置。部分规划中的能力（条件步骤、循环、并行执行、工作流组合、交互式提示、重试、依赖、结果缓存）暂未提供。