conductor
/conductor
Waliduje, uruchamia i wykonuje workflow YAML orkiestrujące agentów AI: routing, bramki human-in-the-loop i schemat YAML, a nowe workflow tworzy tylko na wyraźną prośbę.
- Autor
- microsoft ↗
- Repozytorium
- conductor ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 15.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 5
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 15.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Waliduje, uruchamia i wykonuje workflow YAML orkiestrujące agentów AI: routing, bramki human-in-the-loop i schemat YAML, a nowe workflow tworzy tylko na wyraźną prośbę.
Oryginalny opis (EN)
Validate, run, and execute workflows; creating new workflows when explicitly asked. Use when orchestrating AI agents via YAML workflow files, executing an existing workflow, debugging execution, configuring routing between agents, setting up human-in-the-loop gates, or understanding workflow YAML schema. Only create new workflows when explicitly asked.
Jak działa
- Error Handling
- Setup
- Quick Reference
- When to Use Each Guide
- Minimal Workflow Example
- Key Concepts
Podgląd SKILL.md
---
name: conductor
description: Validate, run, and execute workflows; creating new workflows when explicitly asked. Use when orchestrating AI agents via YAML workflow files, executing an existing workflow, debugging execution, configuring routing between agents, setting up human-in-the-loop gates, or understanding workflow YAML schema. Only create new workflows when explicitly asked.
---
# Conductor
CLI tool for defining and running multi-agent workflows with the GitHub Copilot SDK, Anthropic Claude, Claude Agent SDK, or Hermes (NousResearch, experimental).
> **DO NOT create new workflow files unless the user explicitly asks you to create one.** Default to running, validating, or debugging existing workflows. If the user's request is ambiguous, assume they want to run or modify an existing workflow rather than create a new one.
## Error Handling
> **CRITICAL — do NOT improvise workarounds.** If `conductor` fails for any reason (installation failure, provider error, missing dependency, platform bug), you MUST:
>
> 1. **Report the exact error** to the user — include the full error message.
> 2. **Stop and wait for user direction.** Do NOT attempt to simulate, replicate, or approximate the multi-agent workflow yourself. The value of this skill is the structured multi-agent orchestration — a single-agent attempt is not an equivalent substitute.
## Setup
Conductor is installed automatically when needed. If a `conductor` command fails with "command not found", install it. For installation instructions, see [references/setup.md](references/setup.md).
## Quick Reference
```bash
conductor run workflow.yaml --input question="Hello" # Execute (full output by default)
conductor -q run workflow.yaml --input question="Hello" # Quiet: lifecycle + routing only
conductor -s run workflow.yaml --input question="Hello" # Silent: JSON result only
conductor run workflow.yaml --log-file auto # Log full debug output to file
conductor run workflow.yaml --web --input q="Hello" # Real-time web dashboard
conductor run workflow.yaml --web-bg --input q="Hello" # Background mode (prints URL, exits)
conductor run workflow.yaml -m tracker=ado -m work_item=42 # Attach metadata (merged on top of YAML)
conductor run workflow.yaml --workspace-instructions # Auto-discover AGENTS.md / CLAUDE.md / etc.
conductor validate workflow.yaml # Validate (schema + semantic checks)
conductor show workflow.yaml # Show inputs, agents, and outputs
conductor replay events.jsonl # Replay a recorded run in the dashboard
conductor registry add official myorg/workflows --default # Add a registry (--type github|path)
conductor registry list official # List registry workflows
conductor run qa-bot@official@1.0.0 --input q="Hello" # Run from registry
conductor stop # Stop background workflow
conductor update # Check + print install command
conductor update --apply # Check + launch installer (then exit)
conductor resume workflow.yaml # Resume from last checkpoint
conductor resume workflow.yaml --web # Resume with dashboard (run-flag parity)
conductor checkpoint list # List available checkpoints
```
Full output is shown by default. Use `-q` (quiet) for minimal output or `-s` (silent) for JSON-only — both are root-level options and must come *before* the subcommand (`conductor -q run ...`, not `conductor run ... -q`).
## When to Use Each Guide
**Creating or modifying workflows?** → See [references/authoring.md](references/authoring.md)
- Agent definitions, prompts, and output schemas
- Routing patterns (linear, conditional, loop-back)
- Parallel and for-each groups
- Human gates
- Context modes and MCP servers
- Cost tracking configuration
**Running or debugging workflows?** → See [references/execution.md](references/execution.md)
- CLI options and flags (run, resume, checkpoint list, stop, update)
- Debugging techniques
- Error troubleshooting
- Checkpoint/resume after failures
- Environment setup and providers
**Need complete YAML schema?** → See [references/yaml-schema.md](references/yaml-schema.md)
- All configuration fields with types and defaults
- Validation rules
- Type definitions
## Minimal Workflow Example
```yaml
workflow:
name: my-workflow
entry_point: answerer
input:
question: { type: string }
agents:
- name: answerer
prompt: "Answer: {{ workflow.input.question }}"
output:
answer: { type: string }
routes:
- to: $end
output:
answer: "{{ answerer.output.answer }}"
```
For runtime config, context modes, limits, and cost tracking, see [references/authoring.md](references/authoring.md).
## Key Concepts
| Concept | Description |
|---------|-------------|
| `entry_point` | First agent/group to execute |
| `routes` | Where agent goes next (`$end` to finish, `self` to loop) |
| `type: script` | Shell command step (captures stdout, stderr, exit_code; JSON stdout is auto-merged) |
| `type: set` | Pure-context step that evaluates Jinja2 expressions and binds typed values (no LLM, no subprocess); supports single `value:` and multi `values:` |
| `type: wait` | Pause via `asyncio.sleep` (cross-platform); duration accepts `Ns/Nm/Nh/Nms` or Jinja2; composes with route loop-backs for polling |
| `type: workflow` | Sub-workflow agent — runs another YAML file as a black box (supports `input_mapping`, `max_depth`) |
| `type: terminate` | Explicit terminal step with `status` (`success`/`failed`), Jinja `reason`, optional `output_template` — controls CLI exit code, dashboard state, and emits `is_explicit: true` in `workflow_completed`/`workflow_failed` |
| `parallel` | Static parallel groups (fixed agent list) |
| `for_each` | Dynamic parallel groups (runtime-determined array; supports `type: workflow` agents) |
| `human_gate` | Pauses for user decision with options (Markdown + auto-linkified paths/URLs) |
| `dialog` | Per-agent trigger for conditional multi-turn conversation with the user |
| `retry` | Per-agent retry policy for transient `provider_error` / `timeout` failures |
| `metadata` | Arbitrary YAML or `--metadata`/`-m` key-values surfaced in `workflow_started` events |
| `instructions` | Workflow-level workspace context (inline strings or `!file` includes) prepended to every prompt |
| `--workspace-instructions` | CLI flag to auto-discover AGENTS.md / CLAUDE.md / `.github/copilot-instructions.md` / `.github/instructions/**/*.instructions.md` (`applyTo: "**"`, or a glob overlapping the launch directory) |
| `!file` tag | Include external file content in YAML (`prompt: !file prompt.md`) |
| `context.mode` | How agents share data (accumulate, last_only, explicit) |
| `limits` | Safety bounds (max_iterations up to 500, timeout_seconds) |
| `timeout_seconds` (agent) | Hard wall-clock cancellation per agent (provider-backed agents only) |
| `cost` | Token usage and cost tracking configuration |
| `runtime` | Provider (`copilot`, `claude`, `claude-agent-sdk`, `hermes`, `openai`), model, temperature, max_tokens, reasoning effort, MCP servers |
| `--web` | Real-time web dashboard with DAG graph, live streaming, in-browser human gates, sub-workflow dive-in, replay |
| `checkpoint` | Auto-saved on failure; resume with `conductor resume` (run-flag parity: `--provider`, `--metadata`, `--web`, `--web-bg`, `--web-port`) |
| `registry` | Named workflow sources (GitHub repo or local dir); refs accept `name@registry@version` and `workflow#ref` (tag/branch/SHA) |
For pattern examples (linear, loop, conditional, parallel, for-each, human gate) and template syntax, see [references/authoring.md](references/authoring.md).
Pliki w paczce (5)
- SKILL.md 8 KB
- references/authoring.md 57 KB
- references/execution.md 26 KB
- references/setup.md 1 KB
- references/yaml-schema.md 49 KB
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · microsoft/conductor | 100 | MIT |
| crbnos/carbon | 100 | AGPL-3.0 |
| singlak999/Conductor | 100 | MIT |
| seattle78/AgentQuest | 100 | Apache-2.0 |
| conductor-oss/conductor-skills | 100 | Apache-2.0 |
| RizwanZafaris/product-manager-OS | 100 | MIT |
| garagon/nanostack | 100 | Apache-2.0 |
| materialofair/oh-my-codex | 100 | MIT |
| inkbytefo/claude-conductor | 98 | MIT |
Migawka bazy z 13.11.2026 · wersja paczki f15a8d71b705 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 98workflow-validation
Waliduje YAML workflow FlowWorkflow względem schematu, sprawdza istnienie wskazanych skilli i agentów, potwierdzanie akcji Tier 3 oraz brak zależności od natywnych /goal i /loop. - 90agent-workflow
Tworzy, uruchamia, wznawia i naprawia workflow agentów w formacie JSON, w tym kolejne węzły czekającego przepływu. - 100agent-definition
Prowadzi przez tworzenie i konfigurację agentów AI w platformie DEVS oraz pracę z plikami YAML i JSON opisującymi agentów. - 84validate
Waliduje pliki YAML agenta Copilot Studio pełną diagnostyką binarki LSP: struktura YAML, Power Fx, schemat i odwołania między plikami. - 100orchestrating-multi-agent-systems
Tworzy systemy wieloagentowe z przekazywaniem zadań, routingiem i workflow między dostawcami AI, gdy potrzebna jest współpraca agentów i delegowanie zadań. - 100orchestrating-multi-agent-systems
Tworzy systemy wieloagentowe z przekazywaniem zadań, routingiem i workflow między dostawcami AI, gdy potrzebna jest współpraca agentów i delegowanie zadań.