Communitygithub.com

Summon CLI

Leite eine Aufgabe, ein Modellprofil und eine Skill an ein externes Agent-CLI weiter und gib das vollständige Ergebnis zurück.

Was ist Summon CLI?

Summon CLI ist eine leistungsstarke Erweiterung für KI-Assistenten wie Claude Code, Codex CLI und andere, die es ermöglicht, Aufgaben nahtlos an externe Agent-CLIs zu delegieren. Es unterstützt Agenten wie Claude Code, Grok CLI, Gemini CLI, Codex CLI und mehr, wobei API, Modell, Protokoll (sichtbar oder Hintergrund) und der zu verwendende Skill komplett über die Konfiguration innerhalb des Skills gesteuert werden – ohne feste Codierung im Verhalten des Assistents. Die Nutzung erfolgt entweder durch expliziten Aufruf (`$summon-cli`) oder über konfigurierte Routen, z. B. eine automatische Schreibroute für Codex, wenn kreative Texte erstellt werden sollen. Vor dem ersten Einsatz muss eine Einrichtung (`setup`) auf dem lokalen Rechner durchgeführt werden, um Pfade zu Agent-CLIs und Skills zu erkennen. Der Skill kümmert sich um die gesamte Kommunikation: Er sammelt die relevanten Benutzeranweisungen und Materialien, reicht sie an den externen Agenten weiter, wartet auf dessen vollständiges Ergebnis (wahlweise in einem sichtbaren Terminalfenster oder im Hintergrund) und liefert die Antwort zurück, ohne sie zu interpretieren oder zusammenzufassen. Unterstützt werden sowohl sichtbare Modi (mit Benutzerinteraktion) als auch Hintergrundmodi für automatisierte Workflows. Details zur Konfiguration, zu Profilen und zum Hinzufügen neuer Agenten oder Skills sind in den mitgelieferten Referenzdateien dokumentiert.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add CheshireMew/summon-cli

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht Summon CLI?

Ziel

Übergebe die aktuelle Anfrage vollständig an ein konfiguriertes externes Agent-CLI. Der externe Agent kann Claude Code, Grok CLI, Gemini CLI, Codex CLI oder ein anderer später hinzugefügter Agent sein; API, Modell, Frontend- oder Backend-Protokoll, Startparameter und der Ziel-Skill werden alle durch die Konfiguration innerhalb dieses Skills bestimmt und nicht fest in der Verhaltensbeschreibung kodiert.

Dieser Skill wird verwendet, wenn der Benutzer explizit $summon-cli aufruft. Derzeit ist außerdem eine automatische Schreibroute konfiguriert: Wenn Codex erkennt, dass der Benutzer einen kurzen Beitrag, einen Artikel, eine Projektvorstellung oder anderen veröffentlichbaren Text erstellen möchte, wird die writing-Aufgabenkonfiguration gelesen und delegiert; diese automatische Route ist gleichzeitig durch die lokale AGENTS.md autorisiert. Andere Aufgaben werden aufgrund der Existenz dieses Skills nicht automatisch delegiert.

Arbeitsweise

Nach der ersten Verwendung oder nach dem Kopieren dieses Skills auf einen anderen Rechner führe zunächst die lokale Erkennung im Verzeichnis dieses Skills aus:

& '<Skill-Verzeichnis>\scripts\summon.ps1' setup

Für macOS, Linux oder WSL verwende:

sh '<Skill-Verzeichnis>/scripts/summon.sh' setup

setup erkennt nur Python-, Agent-CLI-, Skill- und Grafikterminals auf dem aktuellen System und schreibt die absoluten Pfade in die von Git ignorierte Datei config/config.local.json innerhalb dieses Skills; es installiert keine Software, verschiebt keine Schlüssel oder ändert die öffentliche Konfiguration. Führe anschließend show und doctor aus, um die Ergebnisse zu überprüfen.

Wähle basierend auf der vom Benutzer genannten Aufgabe, dem Profil und dem Skill die Konfiguration; wenn der Benutzer nichts nennt, wähle eine bereits konfigurierte Route basierend auf der Aufgabenbeschreibung. Eine Aufgabe kann keinen Skill verwenden oder einen Skill verwenden, aber nicht mehrere Skills in einem einzigen Aufruf an den externen Agenten übergeben. Wenn eine Aufgabe einen Skill erfordert, aber weder der Benutzer noch die Standardkonfiguration einen bestimmten Skill ausgewählt haben, frage den Benutzer, welcher diesmal verwendet werden soll; rate nicht und rufe auch nicht gleichzeitig Kandidaten auf.

Codex-Interneterweiterung

Wenn die Aufgabenkonfiguration codex_web auf supplement setzt, ist der aktuelle Codex für die Recherche öffentlicher Materialien vor dem Aufruf verantwortlich. Lies zuerst die bestehende Anfrage, Benutzermaterialien und lokale Objekte vollständig und beurteile, ob für die Erledigung dieser Aufgabe noch öffentliche Materialien fehlen; wenn der vorhandene Inhalt ausreicht, übergib direkt; recherchiere nur im Internet, wenn tatsächlich eine Lücke besteht. Verwende tatsächlich relevante Originaltexte aus Webseiten oder notwendige Kontexte zusammen mit Quellenlinks bei der Übergabe, behalte ihren Materialcharakter bei und füge keinen von Codex destillierten Kernsatz, empfohlenen Blickwinkel, narrative Erklärung oder vorab geschriebenen Inhalt hinzu.

Wenn Codex feststellt, dass die vorhandenen Inhalte oder diese Ergänzung ausreichen, endet die Recherche öffentlicher Materialien hier; der externe Agent sucht nicht erneut und führt die aktuelle Phase des Ziel-Skills gemäß den Anforderungen des Benutzers in dieser Runde aus. Wenn der Benutzer zuerst eine Gliederung liefern und nach Bestätigung den Haupttext schreiben möchte, führe in dieser Runde nur die Gliederungsphase aus, bereite keine Fallbeispiele, Hooks, Haupttexte, Überprüfungen oder Änderungen vor. Nur wenn für die Fertigstellung der aktuellen Phase noch notwendige öffentliche Materialien fehlen, übergib die spezifisch fehlenden Materialien an den externen Agenten zur weiteren Suche. Die Internetsuche dient nur zur Materialergänzung, nicht zur punktuellen Überprüfung von Benutzerinhalten und nicht zur Erstellung eines Faktenchecks.

Wenn der Benutzer die Internetsuche ausdrücklich verbietet oder nur vorhandene Materialien verwenden möchte, überspringe die Internet-Ergänzung. Andere Aufgaben werden nur dann von Codex für die Recherche öffentlicher Materialien behandelt, wenn ihre eigene Konfiguration dies explizit aktiviert.

Übergabe an den externen Agenten

Was dem externen Agenten übergeben wird, sind die originalgetreuen Benutzeranweisungen und echten Materialien, die noch ausgeführt werden müssen, nicht die gesamte Korrekturhistorie. Wenn spätere Benutzernachrichten die vorherige Richtung korrigieren, entferne direkt die ungültigen Anforderungen, Blickwinkel und Assistenzprodukte; die restlichen originalen Benutzeranweisungen, Quelltexte, Reihenfolge und Quellenzugehörigkeit bleiben unverändert. Wenn die aktuelle Absicht über mehrere Nachrichten verteilt ist, wähle nur die noch gültigen und weiterhin vom externen Agenten auszuführenden originalen Benutzersätze aus; Codex formuliert sie nicht in einen Kurzbericht, eine Zusammenfassung, einen Kernsatz oder einen narrativen Rahmen um.

Der Aufrufeingang umfasst nur:

  • Die noch vom externen Agenten auszuführenden originalen Benutzeranweisungen und Quellmaterialien.
  • Die tatsächlich verwendeten Internet-Ergänzungsmaterialien und Links von Codex.
  • Notwendige Ausführungsübergaben.

Für Schreib- oder Inhaltsdelegationen: Wenn sich das Material im aktuell für Codex zugänglichen Aufgabenverlauf, lokalen Dateien oder Projekten befindet, lese der aktuelle Codex vor dem Aufruf die tatsächlich benötigten Inhalte und sende die verwendeten Originaltexte mit der Übergabe. Anweisungen wie "Lies diesen Verlauf", "Öffne diese Dateien" oder "Recherchiere nach diesem Projekt" etc., die bereits vom aktuellen Codex erledigt werden, werden nicht als ausstehende Aufgaben für den externen Agenten wiederholt; die Ersetzung solcher Anweisungen durch tatsächliche Materialien stellt keine Umformulierung der kreativen Anforderungen des Benutzers dar. Lasse den externen Agenten nicht das README, SKILL.md, die Konfigurationsanleitung, die öffentliche Konfiguration, Tests oder die Git-Historie von Summon CLI lesen und schreibe auch nicht "Erkunde das Projekt selbst und finde Material" in die Übergabe. Nur wenn der Benutzer in dieser Runde ausdrücklich verlangt, dass der externe Agent ein bestimmtes Projekt überprüft oder ändert, darf dieser die direkt aufgabenrelevanten Dateien innerhalb dieses Projekts überprüfen.

Die Ausführungsübergabe erläutert nur, welche Ebene die Recherche öffentlicher Materialien fortsetzt und erklärt nicht, dass die Materialaufbereitung abgeschlossen ist. Sie dient nur dem externen Agenten zur Entscheidung, ob die Internet-Tools weiter aufgerufen werden sollen, und geht nicht in die Arbeitsmaterialien, Schreibergebnisse oder das Endprodukt des Ziel-Skills ein. Die Analyseprozesse, fehlgeschlagenen Entwürfe, Korrekturprozesse, internen Routenentscheidungen, Wartungshinweise, Faktenchecks, Gliederungen und vorab geschriebenen Texte von Codex verbleiben in der aktuellen Aufgabe.

Übergib die vollständige Eingabe über die Standardeingabe an den Starter:

$input | & '<Skill-Verzeichnis>\scripts\summon.ps1' run --task writing --skill content-writing --cwd '<Aktuelles Aufgabenverzeichnis>'

Für macOS, Linux oder WSL verwende das entsprechende summon.sh. --cwd ist das Projektverzeichnis, das der externe Agent tatsächlich öffnet; wenn nicht angegeben, wird das aktuelle Verzeichnis beim Aufruf von Summon CLI verwendet, sodass es nicht fest auf einen Ordner auf dem Rechner eines Entwicklers zeigt.

summon.py analysiert aus der lokalen Konfiguration das einzige Profil, lädt die entsprechende API-Umgebung, übergibt dem externen Agenten explizit den Namen des einzigen Ziel-Skills und den absoluten Pfad zu SKILL.md und startet dann den Prozess mit dem für den aktuellen Modus konfigurierten Protokoll der CLI. Es interpretiert, fasst zusammen oder formuliert die Eingabe nicht um.

Der Standard-Ausführungsmodus ist visible. Der claude-code-Executor startet die echte Claude Code-Oberfläche im interaktiven Modus in Windows Terminal, macOS Terminal.app oder einem erkannten Grafikterminal unter Linux, verwendet kein -p und beginnt im Auto-Berechtigungsmodus; nach Abschluss der ersten Runde gibt der Stopp-Hook auf Sitzungsebene die vollständige Antwort von Claude an die aktuelle Codex-Aufgabe zurück, das Claude-Fenster bleibt im Eingabefeld stehen und der Benutzer kann direkt nachfragen oder es selbst schließen. Die vom Benutzer in dieser Runde angeforderte vollständige Lieferung muss in der letzten Antwort des externen Agenten enthalten sein; wenn der Benutzer ausdrücklich eine phasenweise Bestätigung wünscht, wird nur die aktuelle Phase geliefert und die nachfolgenden Phasen werden nicht vorzeitig ausgeführt. Wenn der externe Agent nach dem vollständigen Ergebnis eine sehr kurze Zusammenfassung nachsendet, stellt der Stopp-Hook aus den Sitzungsaufzeichnungen dieser Runde das vorherige vollständige Ergebnis wieder her. Vor dem Start werden die vorhandenen Benutzereinstellungen von Claude Code übernommen und die Erstinitialisierung und der Vertrauensstatus des aktuellen Arbeitsverzeichnisses vorbereitet, sodass der Start nicht auf einer Stil-, Sicherheitserklärungs- oder Verzeichnisbestätigungsseite stoppt. Auf Rechnern ohne grafischen Desktop wird klar gemeldet, dass der sichtbare Modus nicht verfügbar ist, und es wird nicht eigenmächtig auf den Hintergrundmodus umgestellt. In der Konfiguration einer Aufgabe oder eines Profils kann run_mode auf background gesetzt werden; dann wird -p verwendet, um im Hintergrund zu laufen und das Ergebnis zu erfassen. Bei explizitem Aufruf kann --run-mode verwendet werden, um den Modus vorübergehend zu überschreiben. Die Auswertungsreihenfolge ist: aktueller Befehl, Aufgabenkonfiguration, Profilkonfiguration, globaler Standardwert.

Bei explizitem Aufruf kann mit --profile das Standardprofil der Aufgabe umgangen werden, ebenso kann mit --skill der Standard-Skill der Aufgabe überschrieben werden. Die Überschreibung gilt nur für diesen Aufruf und ändert nicht die langfristige Konfiguration.

Wenn die externe CLI ein erfolgreiches Ergebnis zurückgibt, wird dieses vollständig geliefert. Bei Fehlschlag des Aufrufs werden der tatsächliche Exit-Code, die Standardausgabe und die Fehlerausgabe zurückgegeben; es wird kein Agent, keine API oder kein Skill gewechselt und keine Ersatzlösung von Codex generiert.

Ressourcen

  • scripts/summon.py: Plattformübergreifendes Kernprogramm, das Konfigurationen liest, Aufgaben und den einzigen Skill analysiert, die Profilumgebung lädt und das externe Agent-CLI startet.
  • scripts/summon.ps1, scripts/summon.sh: Tragbare Einstiegspunkte für Windows bzw. macOS/Linux/WSL.
  • config/config.json: Mit dem Skill migrierbare öffentliche Ausführungsprotokolle, Profile, Aufgaben- und Skill-Namen; speichert keine lokalen absoluten Pfade.
  • config/config.local.json: Von setup generierte Pfade zu lokalen CLIs, Skills und Terminals; die Datei befindet sich innerhalb dieses Skills und wird durch .gitignore ausgeschlossen.
  • config/profiles/*.env: API-Umgebungen der entsprechenden Profile; die Dateien befinden sich zusammen mit anderen Konfigurationen innerhalb dieses Skills und werden durch .gitignore ausgeschlossen.
  • references/configuration.md: Erläutert die Konfiguration und das Hinzufügen neuer Executoren, Profile, Aufgaben und Skills.

Ausgabe und Fertigstellung

Standardmäßig wird die echte interaktive Oberfläche oder der Live-Ausführungsprozess des externen Agenten in einem separaten Fenster angezeigt und der vollständige Text oder das vollständige Ergebnis wird an die aktuelle Aufgabe zurückgegeben, ohne eine zusätzliche Codex-Version hinzuzufügen. Die Rückgabe des Ergebnisses wartet nicht auf das Schließen des Fensters; das native Interaktionsfenster bleibt nach der ersten Runde erhalten, damit der Benutzer es einsehen und nachfragen kann. Wenn der externe Agent Dateien gemäß Benutzeranforderung erstellt, gehören diese Dateien zum vom Benutzer ausdrücklich angegebenen Zielprojekt; temporäre Dateien, die im sichtbaren Modus für die erste Übergaberunde verwendet wurden, werden sofort nach der Ergebnisrückgabe gelöscht; der Starter speichert keine Prompts, Texte oder Ausführungsprotokolle separat. Claude Code behält weiterhin eigene wiederherstellbare interaktive Sitzungen gemäß seinem normalen Mechanismus.

Nur wenn der externe Agent tatsächlich ein erfolgreiches Ergebnis zurückgibt, gilt die Delegierung als abgeschlossen. Dass die Konfiguration analysierbar ist, die ausführbare Datei existiert und der Befehl gestartet werden kann, belegt jeweils nur die entsprechende Ebene; wenn API-Schlüssel, der Ziel-Skill oder ein kompatibles nicht-interaktives Protokoll fehlt, wird das fehlende Element genau benannt und der Vorgang gestoppt.

Verwandte Skills