| name | workflow-runner |
| description | 执行 YAML 定义的工作流,支持状态恢复和断点续传。用于运行小红书内容生产流水线或其他复杂的多步骤任务。 |
| allowed-tools | Read, Write, Bash, Task, Skill |
Workflow Runner
强大的工作流编排引擎,通过 YAML 配置文件定义复杂的多步骤任务流程。
功能特性
- 📋 YAML 配置驱动:简洁的 YAML 语法定义工作流
- 🔄 状态恢复:支持从任意失败点恢复执行
- 🚀 并行执行:支持并发执行多个 Agents
- 🔗 依赖管理:自动解析步骤间的依赖关系
- 💾 持久化状态:每步完成后立即保存状态
- 🎯 变量替换:支持动态变量(
{{workspace}}, {{steps.xxx.output}})
使用方法
python .claude/skills/workflow-runner/scripts/runner.py .claude/workflows/xhs_vlog.yaml
被调用时,你应该:
- 使用 Bash tool 运行 runner.py 脚本
- 脚本会输出当前执行状态和需要调用的下一步
- 根据脚本指示:
- 如果是
type: skill,使用 Skill tool 调用对应的 Skill
- 如果是
type: agent,使用 Task tool 启动对应的 Agent
- 如果是
mode: parallel,在单个响应中并发启动多个 Task
- 每完成一步,再次运行 runner.py 继续下一步
Workflow YAML 格式
详细格式说明请参考 schema.md
示例
运行小红书内容生产流水线:
python .claude/skills/workflow-runner/scripts/runner.py .claude/workflows/xhs_vlog.yaml
错误处理
- 如果某步失败,状态会被标记为
failed
- 修复问题后,重新运行即可从失败步骤继续
- 如果输出文件缺失,会自动重新执行该步骤