codeaholicguy/ai-devkit

agent-orchestration

AI DevKit · Supervise multi-agent workflows over repeated passes: poll progress, unblock waiting agents, coordinate dependencies, relay outputs, resolve conflicts, and verify completion.

Voir la source

Mode d’emploi

  1. Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
  2. Consultez le document original pour les outils, identifiants et environnements requis.
  3. Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/codeaholicguy/ai-devkit --skill agent-orchestration

Avant de commencer

  • L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
  • Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Document Skill original

Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.

Agent Orchestration

Use only for multi-agent supervision: coordinating dependencies, polling progress, unblocking waiting agents, relaying outputs, resolving conflicts, and verifying completion across agents. For one-off list/detail/send/start/kill work, use agent-management or agent-communication.

Use agent-management for safe agent selection and lifecycle actions. Use agent-communication for list/detail/send mechanics. Use verify before accepting any agent's completion claim.

Rules

  • Own the loop until assigned work is complete, blocked, or stopped.
  • Run agent list --json before each pass; never assume names/statuses.
  • Inspect waiting, idle, unknown, missing, or stale agents before acting.
  • Send self-contained instructions and avoid duplicate follow-ups.
  • Sequence agents that touch the same files; relay only relevant upstream output.
  • Escalate only for repeated failures, unresolved conflicts, product/business decisions, or destructive/shared/production/security-sensitive actions.

Loop

If the goal or agent ownership is unclear, run one scan/detail pass. Ask the user once only if context is still insufficient.

  1. Scan agents.
  2. Assess agents needing attention with detail --tail 10.
  3. Act: approve, clarify, correct, delegate, relay, verify, or escalate.
  4. Report one brief status line.
  5. Sleep 15 minutes and repeat. Meaningful agent progress arrives in minutes-to-tens-of-minutes; faster polling adds noise and orchestrator token cost without signal. Exception: if an agent is known to be waiting on you (approval prompt, ASK/BLOCKED just fired), check back sooner.

Completion

Finish when all assigned work is verified, blocked with a clear reason, or stopped by the user. Summarize per-agent outcomes, verification, unresolved issues, and next step.