bendusy/long-task-orchestration

Was macht long-task-orchestration?

Agent-Fähigkeit für die Orchestrierung von Langzeitaufgaben: falsifizierbare Stopp-Gates, heterogene Queraudits, strenge Bereitstellungssequenzierung. Laufzeitunabhängiger, kern ohne Abhängigkeiten mit pluggbaren Backends.

Überblick

Dieser Skill bietet eine Architektur zur Verwaltung von Arbeitsabläufen, die über mehrere Sitzungen oder Zeiträume hinweg ausgeführt werden. Jede Phase eines Tasks wird durch ein falsifizierbares Stopp-Gate abgeschlossen, das von unabhängigen Prüfern validiert werden muss. Erst nach Bestehen aller Gates wird die nächste Aktion sequentiell ausgelöst.

Kernkonzepte

• Falsifizierbare Stopp-Gates: Jeder Task-Schritt wird von einer logischen Bedingung begleitet, die empirisch überprüft werden kann (z. B. „Datei X existiert und enthält Zeichenfolge Y“). Die Bedingung muss explizit erfüllt sein, bevor der nächste Schritt beginnen kann. Scheitert die Überprüfung, wird der Task blockiert.
• Heterogene Queraudits: Mehrere Audit-Instanzen (z. B. Shell-Befehle, HTTP-Abfragen, Code-Stat-Analyse) können gleichzeitig oder nacheinander dasselbe Gate prüfen. Erst wenn alle Instanzen das Gate bestätigen, gilt der Schritt als abgeschlossen.
• Strenge Bereitstellungssequenzierung: Die Ausführung der Schritte erfolgt strikt linear. Es gibt keine parallelen Abkürzungen – ein Schritt muss vollständig abgeschlossen sein, bevor der nächste beginnt.
• Laufzeitunabhängiger Kern: Die Kernlogik verwendet nur Standard-Python-Bibliotheken und keine externen Runtime-Abhängigkeiten. Backend-Implementierungen (z. B. für Claude Code, Cursor, Codex) werden als separate Plugins bereitgestellt.

Installation

# Klone das Repository
pip install git+https://github.com/bendusy/long-task-orchestration.git

Verwendung

from long_task_orchestration import Orchestrator, Gate, SequentialDeployer

# Definiere ein Stopp-Gate
gate1 = Gate(
    name="Feature-Implementierung abgeschlossen",
    condition="Datei `feature.py` existiert und enthält Funktionsrumpf",
    auditors=["audit_file_exists:feature.py", "audit_grep:def main"]
)

# Erstelle Orchestrator
orchestrator = Orchestrator(
    deployer=SequentialDeployer(),
    gates=[gate1, gate2, ...]
)

# Führe Task aus
orchestrator.run()

Plugin-System

Der Skill unterstützt Backend-Plugins, um mit verschiedenen KI-Agenten zu interagieren:

• bendusy/long-task-orch-claude – für Claude Code
• bendusy/long-task-orch-cursor – für Cursor
• bendusy/long-task-orch-codex – für Codex

API-Referenz

Klasse	Methode	Beschreibung
Gate	check()	Überprüft, ob das Gate erfüllt ist (führt alle Auditoren aus).
Orchestrator	run()	Startet die Task-Orchestrierung.
SequentialDeployer	deploy(gates)	Führt die Bereitstellung in sequentieller Reihenfolge aus.

Beispiele

Beispiel 1: Code-Review-Workflow

tasks:
  - name: Review-Feature-Branch
    gates:
      - name: Tests bestanden
        condition: "Alle Tests in `tests/` sind grün"
        auditors:
          - cli:pytest tests/
      - name: Code-Review abgeschlossen
        condition: "Pull-Request wurde genehmigt"
        auditors:
          - http:GET /api/review/status
    deployer:
      type: sequential

Lizenz

MIT