Communitygithub.com

SamuelChien/mega-skills-collection

Koordiniere Claude-Code-Agenten-Teams über ein dateisystembasiertes Protokoll. Verwende dies, wenn mehrere Claude-Agenten bei parallelen Aufgaben orchestriert werden müssen, Aufgabenabhängigkeiten verwalten werden müssen oder eine Multi-Agenten-Codeüberprüfung oder -Implementierung erforderlich ist. Nicht verwenden, wenn ein einzelner Agent ausreicht oder die Aufgabe nicht parallelisierbar ist.

Was ist mega-skills-collection?

Diese Fähigkeit ermöglicht die Koordination mehrerer Claude-CLI-Prozesse als Team, die über ein dateisystembasiertes Protokoll zusammenarbeiten. Sie ist ideal für komplexe Entwicklungsaufgaben, die parallele Implementierung, Codeüberprüfungen durch mehrere Agenten oder große Refactoring-Arbeiten erfordern, bei denen natürliche Parallelität ausgenutzt werden kann. Das Protokoll verwendet JSON-Dateien, die durch fcntl-Sperren geschützt sind, und läuft ohne Datenbank, Daemon oder Netzwerkschicht – die Agenten kommunizieren über gemeinsame Inboxen und Aufgabenlisten im Home-Verzeichnis des Benutzers. Zu den wichtigsten Komponenten gehören Teammitglieder mit definierten Rollen (Implementierer, Forscher, Tester, Prüfer, Architekt), ein Aufgabenabhängigkeits-Management, ein Gesundheitsüberwachungsprotokoll zur Erkennung steckengebliebener Agenten und eine Integration mit dem Conjure-Delegierungsmuster. Die Fähigkeit erfordert die Claude-Code-CLI und tmux, und sie unterstützt eine optionale Isolation über Git-Worktrees für zusätzliche Dateisystemsicherheit.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/agent-teams
Original anzeigen→Alle Skills durchsuchen

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Dokumentation

Inhaltsverzeichnis

Koordination von Agententeams

Übersicht

Claude Code Agent Teams ermöglicht mehreren Claude-CLI-Prozessen die Zusammenarbeit an gemeinsamen Aufgaben über ein dateisystembasiertes Koordinationsprotokoll. Jedes Teammitglied läuft als unabhängiger claude-Prozess in einem tmux-Panel und kommuniziert über JSON-Dateien, die durch fcntl-Sperren geschützt sind. Keine Datenbank, kein Daemon, keine Netzwerkschicht.

Diese Fähigkeit bietet die Muster zur effektiven Orchestrierung von Agententeams.

Wann verwenden

  • Parallele Implementierung über mehrere Dateien oder Module hinweg
  • Multi-Agenten-Codeüberprüfung (ein Agent prüft, ein anderer implementiert Korrekturen)
  • Großes Refactoring, das koordinierte Änderungen in Subsystemen erfordert
  • Aufgaben mit natürlicher Parallelität, die von gleichzeitigen Agenten profitieren

Wann NICHT verwenden

  • Einzeldateiänderungen oder kleine Aufgaben (Overhead übersteigt Nutzen)
  • Aufgaben, die eine enge sequenzielle Argumentation erfordern (Agenten koordinieren lose)
  • Wenn die claude-CLI nicht verfügbar oder tmux nicht installiert ist

Voraussetzungen

# Claude Code CLI überprüfen
claude --version

# tmux überprüfen (für Split-Panel-Modus erforderlich)
tmux -V

# Experimentelle Funktion aktivieren (wird automatisch vom Spawner gesetzt)
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Protokollarchitektur

~/.claude/
  teams/<team-name>/
    config.json            # Team-Metadaten + Mitgliederliste
    inboxes/
      <agent-name>.json    # Nachrichtenwarteschlange pro Agent
      .lock                # fcntl exklusive Sperre
  tasks/<team-name>/
    1.json ... N.json      # Auto-inkrementierende Aufgabendateien
    .lock                  # fcntl exklusive Sperre

Entwurfsprinzipien:

  • Dateisystem ist die Datenbank: JSON-Dateien, atomare Schreibvorgänge via tempfile + os.replace
  • fcntl-Sperren: Verhindert gleichzeitige Lese-/Schreibkorruption in Inboxen und Aufgaben
  • Nummerierte Aufgaben: Auto-inkrementierende IDs mit sequenzieller Dateibenennung
  • Lose Kopplung: Agenten pollten ihre eigene Inbox; keine Push-Benachrichtigungen

Schnellstart

1. Ein Team erstellen

# Programmatische Team-Einrichtung (über MCP oder direkte API)
# Team-Konfiguration wird nach ~/.claude/teams/<team-name>/config.json geschrieben

Die Teamkonfiguration enthält:

  • name, description, created_at (ms-Zeitstempel)
  • lead_agent_id, lead_session_id
  • members[] — Array von LeadMember- und TeammateMember-Objekten

2. Teammitglieder spawnen

Jedes Teammitglied ist ein separater claude-CLI-Prozess, der mit Identitätsflags gestartet wird:

claude --agent-id "backend@my-team" \
       --agent-name "backend" \
       --team-name "my-team" \
       --agent-color "#FF6B6B" \
       --parent-session-id "$SESSION_ID" \
       --agent-type "general-purpose" \
       --model sonnet

Siehe modules/spawning-patterns.md für tmux-Panel-Verwaltung und Farbzuweisung.

3. Aufgaben mit Abhängigkeiten erstellen

{
  "id": "1",
  "subject": "API-Endpunkte implementieren",
  "description": "REST-Endpunkte für die Benutzerverwaltung erstellen",
  "status": "pending",
  "owner": null,
  "blocks": ["3"],
  "blocked_by": [],
  "metadata": {}
}

Siehe modules/task-coordination.md für Zustandsautomaten und Abhängigkeitsverwaltung.

4. Über Nachrichten koordinieren

{
  "from": "team-lead",
  "text": "API-Endpunkte sind bereit für Integrationstests",
  "timestamp": "2026-02-07T22:00:00Z",
  "read": false,
  "summary": "API bereit"
}

Siehe modules/messaging-protocol.md für Nachrichtentypen und Inbox-Operationen.

Koordinationsworkflow

  1. agent-teams:team-created — Teamkonfiguration und Verzeichnisse initialisieren
  2. agent-teams:teammates-spawned — Agenten in tmux-Panels starten
  3. agent-teams:tasks-assigned — Aufgaben mit Abhängigkeiten erstellen, Besitzer zuweisen
  4. agent-teams:coordination-active — Agenten beanspruchen Aufgaben, tauschen Nachrichten aus, markieren Abschluss
  5. agent-teams:team-shutdown — Graceful Shutdown mit Genehmigungsprotokoll

Teammitgliedsrollen

Jedes Teammitglied hat eine role, die seine Fähigkeiten und Aufgabenkompatibilität bestimmt. Fünf Rollen sind definiert: implementer (Standard), researcher, tester, reviewer und architect. Rollen schränken ein, welche Risikostufen ein Agent handhaben kann – siehe modules/crew-roles.md für die vollständige Fähigkeitsmatrix und die Rollen-Risiko-Kompatibilitätstabelle.

Gesundheitsüberwachung

Teammitglieder können auf Gesundheit über Herzschlag-Nachrichten und Anspruchsablauf überwacht werden. Der Lead pollt alle 60s die Teamgesundheit mit einem 2-stufigen Erkennungsprotokoll für Stillstand (health_check-Sonde + 30s Wartezeit). Steckengebliebene Agenten haben ihre Aufgaben freigegeben und werden gemäß der Doktrin „ersetzen, nicht warten“ neu gestartet oder ersetzt. Siehe modules/health-monitoring.md für das vollständige Protokoll und den Zustandsautomaten.

Modulreferenz

  • team-management.md: Team-Lebenszyklus, Konfigurationsformat, Mitgliederverwaltung
  • messaging-protocol.md: Nachrichtentypen, Inbox-Operationen, Sperrmuster
  • task-coordination.md: Aufgaben-CRUD, Zustandsautomat, Erkennung von Abhängigkeitszyklen
  • spawning-patterns.md: tmux-Spawning, CLI-Flags, Panel-Verwaltung
  • crew-roles.md: Rollentaxonomie, Fähigkeitsmatrix, Rollen-Risiko-Kompatibilität
  • health-monitoring.md: Herzschlag-Protokoll, Erkennung von Stillstand, automatisierte Wiederherstellung

Integration mit Conjure

Agent Teams erweitert das Conjure-Delegierungsmodell:

Conjure-MusterÄquivalent in Agent Teams
delegation-core:task-assessedagent-teams:team-created
delegation-core:handoff-plannedagent-teams:tasks-assigned
delegation-core:results-integratedagent-teams:team-shutdown
Externe LLM-AusführungAusführung durch Teammitglied-Agenten

Verwende zuerst Skill(conjure:delegation-core), um zu bestimmen, ob die Aufgabe von einer Multi-Agenten-Koordination profitiert oder eine Einzeldienst-Delegierung ausreicht.

Worktree-Isolationsalternative (Claude Code 2.1.49+)

Für parallele Agenten, die Dateien ändern, bietet isolation: worktree eine leichte Alternative zur dateisystembasierten Koordination. Jeder Agent läuft in seinem eigenen temporären Git-Worktree, wodurch die Notwendigkeit von fcntl-Sperren oder Inbox-basierter Konfliktvermeidung für gemeinsame Dateien entfällt.

  • Wann Worktrees gegenüber Agent-Teams-Nachrichten bevorzugen: Agenten arbeiten an überlappenden Dateien, benötigen aber keine Kommunikation während der Ausführung
  • Wann Agent-Teams-Nachrichten bevorzugen: Agenten müssen Entdeckungen koordinieren oder Pläne basierend auf dem Fortschritt des jeweils anderen anpassen
  • Beides kombinieren: Verwende Agent Teams für die Koordination mit isolation: worktree pro Teammitglied für Dateisystemsicherheit

Fehlerbehebung

Häufige Probleme

tmux nicht gefunden Installation über den Paketmanager: brew install tmux / apt install tmux

Veraltete Sperrdateien Wenn ein Agent während einer Operation abstürzt, können Sperrdateien bestehen bleiben. Entferne .lock-Dateien manuell aus ~/.claude/teams/<team>/inboxes/ oder ~/.claude/tasks/<team>/

Verwaiste Aufgaben Aufgaben, die von einem abgestürzten Agenten beansprucht wurden, bleiben auf unbestimmte Zeit in_progress. Verwende modules/health-monitoring.md für die herzschlagbasierte Erkennung von Stillstand und die automatische Aufgabenfreigabe. Das Gesundheitsüberwachungsprotokoll erkennt nicht reagierende Agenten innerhalb von 60s + 30s Sondenfenster und gibt ihre Aufgaben zur Neuzuweisung frei.

Nachrichtenreihenfolge Die Zeitstempelauflösung des Dateisystems variiert (HFS+ = 1s Granularität). Verwende nummerierte Dateinamen oder UUID-sortierte Namen, um Kollisionen bei schnellen Nachrichtenstößen zu vermeiden.

Modellfehler auf Bedrock/Vertex/Foundry (vor 2.1.39) Teammitglied-Agenten könnten falsche Modellkennungen auf Unternehmensanbietern verwenden, was zu 400-Fehlern führt. Upgrade auf Claude Code 2.1.39+ für korrekte Modell-ID-Qualifizierung über alle Anbieter hinweg.

Schutz vor verschachtelten Sitzungen (2.1.39+) Wenn claude sich weigert, innerhalb einer bestehenden Sitzung zu starten, stelle sicher, dass du tmux-Panel-Splitting (keinen Subshell-Aufruf) verwendest. Der Schutz ist beabsichtigt – siehe modules/spawning-patterns.md für Details.

Exit-Kriterien

  • Team mit Konfiguration und Verzeichnissen erstellt
  • Teammitglieder gespawnt und in der Konfiguration registriert
  • Aufgaben mit Abhängigkeitsgraph (keine Zyklen) erstellt
  • Agenten koordinieren über Inbox-Nachrichten
  • Graceful Shutdown abgeschlossen

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

Verwandte Skills

steipete/sag

ElevenLabs text-to-speech with mac-style say UX.

community

steipete/oracle

Oracle CLI second-model review/debug/refactor/design with selected files, dry-run token checks, API or browser engine.

community

steipete/peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

community

mattpocock/design-an-interface

Generate multiple radically different interface designs for a module using parallel sub-agents. Use when user wants to design an API, explore interface options, compare module shapes, or mentions "design it twice".

community

mattpocock/prototype

Build a throwaway prototype to flesh out a design — a runnable terminal app for state/business-logic questions, or several radically different UI variations toggleable from one route.

community

mattpocock/grill-me

Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

community