ao-workflow-runner

name ao-workflow-runner description 多角色 YAML 工作流执行引擎——解析 workflow YAML，加载 agency-agents-zh 角色，按 DAG 顺序执行 Multi-Role Workflow Runner When the user asks to run a workflow (YAML file) or a multi-role collaboration task, follow these steps: 1. Parse Workflow Read the specified YAML file. Extract name, inputs, steps, depends_on, conditions, and loops. 2. Collect Inputs required: true inputs must be provided by the user Optional inputs with default use the default value Optional inputs without default are set to empty string 3. Build Execution Order Topological sort by depends_on . Steps without dependencies belong to the same level and can run in parallel. 4. Execute Steps For each step: Read agency-agents-zh/{role}.md (search order: YAML's agents_dir → ./agency-agents-zh/ → ../agency-agents-zh/ → node_modules/agency-agents-zh/) Extract all markdown content after the frontmatter ( --- ) as the role personality Replace {{variables}} in the task with context values (from inputs or previous step outputs) Evaluate conditions : if condition is set, evaluate it. Skip the step if the condition is not met. Operators: contains , equals , not_contains , not_equals Fully embody the role — use that role's expertise, frameworks, and communication style. Output should be substantive. Store the step's output text into the context variable (if step has an output field) Check loops : if loop is set and exit_condition is not met, jump back to loop.back_to step (max: loop.max_iterations rounds) Label each step: ### Step N/Total: step_id (Role Name) 5. Save Results Save all outputs to files: ao-output/{workflow-name}-{date}/ ├── steps/ │ ├── 1-{step_id}.md │ └── ... ├── summary.md # Final step's full output └── metadata.json # Step states, timing, token counts 6. Suggest Iteration After completion, always tell the user: To improve a specific step, ask me to re-run from that step. I'll reuse all upstream outputs. For CLI: ao run <workflow> --resume last --from <step-id> Important Rules Each step must genuinely embody the assigned role — no generic responses Never skip or merge steps; execute strictly in topological order If a role file is missing, tell the user to install agency-agents-zh If a condition is not met, mark the step as "skipped" and continue For depends_on_mode: "any_completed" , proceed when ANY upstream step completes (not all)