CommunityRecherche & Datenanalysegithub.com

Subagent-First (Subagent-Prioritär)

Hält den Hauptagenten entlastet, indem schwere Arbeiten (mehrere Dateien, lange Recherchen, Batch-Verarbeitung) an Hintergrund-Subagenten delegiert werden. Der Hauptagent bleibt jederzeit ansprechbar für den Nutzer.

Was ist Subagent-First (Subagent-Prioritär)?

Diese Fähigkeit löst das Kernproblem vieler KI-Assistenten: Der Hauptagent wird von schweren Aufgaben blockiert, kann nicht auf Nutzerfragen reagieren und der Nutzer wartet minutenlang. „Subagent-First“ etabliert eine plattformunabhängige Disziplin, bei der alle Aufgaben, die voraussichtlich mehr als 2–3 Tool-Aufrufe benötigen (mehrere Dateien, lange Recherchen, Batch-Verarbeitung), an Hintergrund-Subagenten delegiert werden. Der Hauptagent übernimmt nur noch vier Aktionen: Zerlegung, Delegation, Zusammenfassung und Dialog. Die Fähigkeit bietet einen Entscheidungsbaum (4 Fragen), einen Fünf-Schritte-Prozess (Zerlegung → Delegation → parallele Ausführung → Abnahme → Abschluss), eine detaillierte Abnahmeliste (Existenz, Konformität, Authentizität, Vollständigkeit), 6 Delegationsmuster und 12 Antimuster. Sie ist für alle Plattformen mit Subagenten/ Hintergrundaufgaben gedacht (Claude Code, Codex, Cursor, WorkBuddy, Hermes usw.) und enthält ein Skript `delegation_planner.py`, das anhand einer Aufgabenliste entscheidet, ob delegiert, selbst erledigt oder ein geplanter Task erstellt werden soll.

Funktioniert mit✓Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/lingyu9495-source/agent-skills/tree/main/skills/subagent-first

Installed? Explore more Recherche & Datenanalyse skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Subagent-Prioritär · Hauptagent bleibt draußen

Die Aufmerksamkeit des Hauptagenten gehört dem Nutzer, nicht der Aufgabe. Jede Aufgabe, die voraussichtlich viele Runden benötigt, wird an einen Subagenten im Hintergrund delegiert; der Hauptagent ist nur für Zerlegung, Delegation, Abnahme und Abschluss zuständig und bleibt jederzeit reaktionsfähig.

Viele Agenten fühlen sich umständlich an, nicht weil das Modell nicht gut genug ist, sondern weil der Hauptagent mit schweren Aufgaben blockiert ist: Der Nutzer schickt einen Satz, der Hauptagent arbeitet sich durch zwanzig Tool-Aufrufe, kann weder antworten noch die Richtung ändern, der Nutzer wartet einfach. Wenn der Hauptagent endlich aufschaut, haben sich die Anforderungen möglicherweise geändert.

Diese Fähigkeit bietet eine Arbeitsdisziplin – sie macht „Wann delegieren, wie delegieren, wie abnehmen“ zu überprüfbaren Regeln, nicht zum Bauchgefühl. Die Disziplin ist plattformunabhängig: Sie gilt für jeden KI-Agenten mit Subagenten/ Hintergrundaufgaben (Claude Code, Codex, Cursor, WorkBuddy, Hermes und andere vergleichbare Tools). Der Unterschied liegt nur in den Tool-Namen – eine Zuordnungstabelle findest du im Abschnitt „Tool-Name-Zuordnungstabelle“ dieses Dokuments.

Abweichungen in der Praxis bei bestimmten Plattformen: Die Feldnamen, Parallelitätsgrenzen, Hintergrundsemantik und Kostenstruktur von Hermes sind in references/hermes-runtime-reality.md zusammengestellt (Beispielimplementierung, andere Plattformen können ignorieren). Der Haupttext behandelt nur die Disziplin, nicht diese Seite.


Auslösebedingungen

Wenn einer der folgenden Fälle eintritt, sollte nach dieser Fähigkeit verfahren werden (anstatt es selbst zu erledigen):

  1. Die Aufgabe erfordert voraussichtlich mehr als 2–3 Tool-Aufrufe: z. B. „8 Dateien lesen und zusammenfassen“, „eine Suche durchführen und dann aufbereiten“.
  2. Mehrere voneinander unabhängige Einheiten müssen gleichzeitig verarbeitet werden: Mehrere Dateien, Verzeichnisse, URLs, Datensätze, Lösungsvorschläge.
  3. Lange Recherche / lange Suche: Wiederholtes Abrufen, Crawlen, Vergleichen, das Minuten dauert.
  4. Batch-Verarbeitung: Gleicher Vorgang für einen ganzen Stapel von Eingaben (Bereinigen, Konvertieren, zeilenweises Prüfen, zeilenweises Generieren).
  5. Der Nutzer fordert explizit Parallelverarbeitung oder „mehrere Dinge gleichzeitig tun“.
  6. Der Hauptagent befindet sich mitten in einem Dialog mit dem Nutzer: Der Nutzer kann jederzeit nachfragen, Anforderungen ändern oder neue Aufgaben einwerfen.
  7. Teilaufgaben sind voneinander unabhängig und können gleichzeitig gestartet werden: Typisch „Drei Dokumente separat Korrektur lesen und dann Schlussfolgerungen zusammenführen“.
  8. Während schwere Aufgaben im Hintergrund laufen, möchte der Nutzer weiterhin über etwas anderes chatten (dies ist der Hauptnutzen dieser Fähigkeit).

Umgekehrte Auslösebedingung: Wenn eine Sache mit einem einzigen Tool-Aufruf erledigt werden kann und der Nutzer danach nicht mehr mit dir spricht – dann mach es selbst. Einen Subagenten zu erzwingen, wäre nur langsamer. Die Entscheidungskriterien findest du im nächsten Abschnitt, dem Entscheidungsbaum.


Kernprinzipien

  1. Der Hauptagent macht keine schweren Arbeiten. Der Hauptagent macht nur vier Dinge: Zerlegen → Delegieren → Abschließen/ Zusammenfassen → Mit Nutzer sprechen. Er muss jederzeit „antwortbereit“ bleiben.
  2. Schwere Arbeit wird zwingend an Subagenten delegiert. Wenn die obigen Auslösebedingungen erfüllt sind, delegiere. „Ich denke, ich bin schnell, ich mach das mal eben selbst“ ist nicht erlaubt. Entscheidend sind die Aufgabenmerkmale, nicht das Selbstvertrauen des Hauptagenten.
  3. Selbstmeldung ist nicht gleich Tatsache. Dass ein Subagent „erledigt“ sagt, ist nur seine Behauptung; ohne Überprüfung gilt die Ausgabe als nicht erledigt (siehe „Abnahmeliste“).
  4. Der Kontext muss in sich geschlossen sein. Der Subagent sieht nicht den bisherigen Dialog zwischen dir und dem Nutzer. Alles, was du im Kopf hast, bekommt er nicht mit. Wenn der Arbeitsauftrag nicht vollständig ist, läuft er garantiert in die falsche Richtung – nicht, weil er dumm ist, sondern weil du es nicht angegeben hast.
  5. Parallelität hat Grenzen. Nur unabhängige Aufgaben werden parallelisiert; Aufgaben mit Abhängigkeiten müssen seriell ausgeführt werden, oder die Ausgabe des vorgelagerten Schrittes wird dem nachgelagerten Schritt als Eingabe gegeben.
  6. Aufgaben, die eine Entscheidung des Nutzers erfordern, werden nicht delegiert. Alles, was eine Nutzerbestätigung, irreversible Konsequenzen oder eine sofortige Qualitätskontrolle erfordert, bleibt beim Hauptagenten.
  7. Langlebige, sitzungsübergreifende Aufgaben brauchen einen anderen Mechanismus. Aufgaben, die länger als die aktuelle Sitzung leben müssen (kontinuierliche Überwachung, zeitgesteuerte Auslösung, dauerhafte Prozesse), werden mit dem Timing/ Dauerhaft-Mechanismus deiner Plattform erledigt (geplante Tasks, Cron-Jobs, Hintergrundprozesse), nicht mit Subagenten – der Lebenszyklus eines Subagenten ist an eine einzelne Delegation gebunden.
  8. Fehler führen zu einer Degradierung, nicht zur Erfindung. Wenn ein Subagent fehlschlägt, ein Timeout hat oder die Ausgabe nicht den Anforderungen entspricht: Degradiere zu Eigenarbeit oder delegiere auf einem anderen Weg. Es ist absolut nicht erlaubt, „ein nicht erhaltenes Ergebnis“ als „erhalten“ darzustellen.

Diese Prinzipien entsprechen dem bekannten Fork-Join / Fan-Out-Fan-In Paradigma: Aufgaben werden an mehrere Ausführungseinheiten verteilt und die Ergebnisse wieder zusammengeführt (Javas ForkJoinPool und das von Dean und Ghemawat auf der OSDI 2004 vorgestellte MapReduce sind konkrete Implementierungen dieser Idee). Diese Fähigkeit erfindet kein neues Konzept, sondern setzt es als ausführbare Arbeitsdisziplin für Agenten um.


Entscheidungsbaum: Was ist schwere Arbeit, was mache ich selbst

Beantworte die folgenden Fragen der Reihe nach. Der erste Zweig, der mit „Ja“ beantwortet wird, ist das Ergebnis.

Frage 1: Kann diese Sache mit einem Tool-Aufruf erledigt werden?

KriteriumBeurteilung
Anzahl Tool-AufrufeDu kannst sie selbst zählen, und sie ist ≤ 1 Runde
Müssen mehrere Dateien gelesen werden?Nein (0–1)
Gibt es eine Schleife?Nein (kein „für jedes…“)
Voraussichtliche DauerSekunden

Alle vier Kriterien erfüllt → Selber machen. Auch nur eines nicht erfüllt → Weiter zu Frage 2.

Frage 2: Benötigt diese Sache eine Entscheidung des Nutzers?

  • Der Nutzer muss aus mehreren Optionen wählen → Selber machen (oder nur Informationen sammeln und die Optionen präsentieren).
  • Es geht um irreversible Operationen (Daten löschen, veröffentlichen, bezahlen, Nachrichten an Dritte senden) und eine sofortige Kontrolle ist nötig → Selber machen.
  • Es geht nur darum, dass „der Nutzer Bescheid weiß“, ohne dass er während des Prozesses eine Entscheidung treffen muss → Kann delegiert werden, aber bei der Zusammenfassung muss klar kommuniziert werden.

Frage 3: Muss diese Sache länger als die aktuelle Sitzung leben?

  • Ja (zeitgesteuerte Auslösung, kontinuierliche Überwachung, dauerhafter Dienst) → Nutze den Timing/ Dauerhaft-Mechanismus deiner Plattform (geplante Tasks, Cron-Jobs, Hintergrundprozesse), nicht den Subagenten.
  • Nein, es reicht, wenn es innerhalb dieser Sitzung erledigt wird → Weiter zu Frage 4.

Frage 4: Kann es in voneinander unabhängige Teile zerlegt werden?

  • Ja → Parallel mehrere Subagenten delegieren, jeder kümmert sich um seine eigene Datei / sein eigenes Verzeichnis / seine eigene URL / seinen eigenen Datensatz, der Hauptagent führt am Ende zusammen.
  • Nein, aber es gibt eine klare Reihenfolge → Seriell delegieren oder einen einzigen Subagenten die gesamte Kette durchlaufen lassen (das ist immer noch besser, als wenn du selbst ranmusst).
  • Lässt sich nicht zerlegen und ist auch nicht lang → Gehe zurück zu Frage 1 und überprüfe es noch einmal; wahrscheinlich machst du es selbst.

Kurzübersicht Mengengerüst

Art der AufgabeTypische DauerVorgehen
Einen Wert nachschlagen, einen Abschnitt einer Datei lesenSekundenSelber machen
Eine Textstelle ändern, einen Befehl ausführenSekundenSelber machen
3 Dateien lesen und zusammenfassen1–2 MinutenKann man machen oder delegieren; delegieren, wenn der Nutzer wartet
8 Dateien lesen, einzeln zusammenfassenMehrere MinutenDelegieren
Mehrere Quellen durchsuchen + quervergleichenMinuten bis über zehn MinutenDelegieren (in Blöcke parallelisieren)
Batch-Verarbeitung von N Eingaben (N ≥ 5)Steigt mit NDelegieren (in Scheiben parallelisieren)
Nutzer muss aus Optionen wählenUnbestimmtSelber machen (sammeln + Optionen präsentieren)
Täglich einmal zu fester Zeit ausführenSitzungsübergreifendGeplanter Task (kein Subagent)

Fünf-Schritte-Prozess

Schritt 1: Zerlegen

Schneide die Arbeit in klar abgegrenzte Einheiten. Jede Einheit muss drei Fragen unabhängig beantworten können:

  • Was ist die Eingabe: Konkrete Dateipfade, Verzeichnisse, URL-Listen, Datensatznamen, Parameter.
  • Was ist die Ausgabe: Konkreter Dateiname, Format, Pfad.
  • Wann ist es fertig: Überprüfbare Kriterien, nicht „wenn es gut aussieht“.

Beim Zerlegen zwei Regeln beachten:

  • Dateischreibkonflikte vermeiden: Zwei Subagenten dürfen niemals dieselbe Datei schreiben. Entweder schreibt jeder seine eigene Datei, und der Hauptagent führt sie am Ende zusammen, oder es wird seriell gearbeitet.
  • Abhängigkeiten explizit machen: Wenn die Ausgabe von A als Eingabe für B dient, darf nicht parallel delegiert werden – entweder seriell oder ein Subagent macht A+B zusammen.

Fertig-Kriterien (Punkt für Punkt abhaken)

  • Jede Einheit hat eine klare Eingabe (mit konkreten Pfaden / Listen)
  • Jede Einheit hat eine klare Ausgabe (Dateiname + Format + Speicherort)
  • Jede Einheit hat überprüfbare Fertig-Kriterien
  • Keine zwei Einheiten schreiben in dieselbe Datei
  • Alle Abhängigkeiten sind markiert (welche müssen seriell sein)

Schritt 2: Delegieren

Verwende das Subagenten-/ Hintergrundaufgaben-Tool deiner Plattform, um jede Einheit zu delegieren (bei Hermes ist es delegate_task, bei anderen Plattformen gemäß der „Tool-Name-Zuordnungstabelle“). Der Arbeitsauftrag muss die „Vier Elemente“ enthalten (siehe nächster Abschnitt). Wichtig:

  • Ein Subagent bekommt eine einzige klar abgegrenzte Aufgabe. Stecke nicht drei zusammenhanglose Dinge in einen Auftrag.
  • Gib im Auftrag den vollständigen Hintergrund an – der Subagent sieht nicht den Dialog zwischen dir und dem Nutzer.
  • Sage ihm genau, wo die Ausgabe landen soll und was er zurückmelden soll (Dateipfad? Zeilenanzahl? Befehlsausgabe?).
  • Fordere ihn explizit auf, nur Dinge zu melden, die überprüfbar sind: Welche Befehle wurden ausgeführt, was war die Ausgabe; wenn etwas nicht geklappt hat, soll er es direkt sagen.
  • Wenn die Plattform strukturierte Rückmeldungen / Ausgabevalidierung unterstützt (z. B. Überprüfung der finalen Antwort des Subagenten gegen ein JSON-Schema) – wenn möglich, gib eine Struktur vor, keinen Freitext.

Fertig-Kriterien

  • Jeder Auftrag enthält alle vier Elemente (Ziel / Hintergrund / Ausgabestruktur / Abnahmemethode)
  • Jeder Auftrag gibt den Ausgabepfad an
  • Jeder Auftrag fordert überprüfbare Beweise an (Befehl + tatsächliche Ausgabe)
  • Der Auftrag enthält keine vagen Verweise wie „du weißt schon“ oder „wie vorher“

Schritt 3: Parallele Ausführung

  • Parallel delegieren, was parallel kann: Einheiten ohne gegenseitige Abhängigkeiten werden auf einmal rausgeschickt, nicht nacheinander in die Warteschlange gestellt.
  • Seriell, wenn Abhängigkeiten bestehen: Warte, bis die vorgelagerte Einheit abgenommen ist, und gib dann ihre Ausgabe als Kontext für die nachgelagerte Einheit.
  • Parallelitätsgrenze einhalten: Zu viele gleichzeitig laufende Aufgaben konkurrieren um Ressourcen und erhöhen deinen Koordinationsaufwand. Drei bis fünf gleichzeitig ist ein guter Bereich; bei mehr überlege, sie in Gruppen aufzuteilen (die Folgen einer Überschreitung des Limits variieren je nach Plattform; siehe „Tool-Name-Zuordnungstabelle“ und die plattformspezifische Realität).
  • Sofort nach dem Delegieren zum Nutzer zurückkehren: Stehe nicht da und warte auf die Subagenten. Das ist der Zweck dieser Disziplin – während der Nutzer auf dich wartet, solltest du ansprechbar sein.
  • Nicht pollen, nicht warten: Der Delegierungsaufruf sollte sofort zurückkehren; die Ergebnisse werden von der Plattform zurückgeliefert; der Hauptagent muss während der Wartezeit in der Lage sein, neue Nachrichten des Nutzers anzunehmen. Wenn deine Plattform standardmäßig blockiert, führe den Delegierungsaufruf im Hintergrund / asynchronen Modus aus.
  • Dem Nutzer eine Kontrollmöglichkeit geben: Wenn die Plattform es unterstützt, laufende Subagenten einzusehen, einem Subagenten eine Korrektur zu geben, vorzeitig zu beenden und Teilergebnisse zu behalten, dann nutze es; wenn nicht, falle zurück auf „in der nächsten Auftragsrunde die Korrektur mitgeben“.

Fertig-Kriterien

  • Unabhängige Einheiten wurden gleichzeitig delegiert (nicht eine nach der anderen in die Warteschlange)
  • Abhängige Einheiten wurden seriell in der richtigen Reihenfolge delegiert, und die nachgelagerten haben die Ausgabe der vorgelagerten erhalten
  • Die Parallelität ist in einem kontrollierbaren Rahmen (nicht ein Dutzend auf einmal gestartet)
  • Der Hauptagent wartet nach dem Delegieren nicht blockierend und kann immer noch auf den Nutzer reagieren

Schritt 4: Abnahme

Dieser Schritt wird am leichtesten übersprungen und darf am wenigsten übersprungen werden. Das „Erledigt“ eines Subagenten ist eine zu überprüfende Behauptung, keine Schlussfolgerung.

Überprüfe in der richtigen Reihenfolge (siehe „Abnahmeliste“):

  1. Existiert die Ausgabe? Ist die Datei wirklich da? Stimmt der Pfad? Lies den tatsächlichen Inhalt.
  2. Entspricht die Ausgabe den Spezifikationen? Stimmen Format, Felder, Zeilenanzahl, Umfang mit den Anforderungen des Auftrags überein?
  3. Gibt es Beweise für die Schlussfolgerung? Haben die behaupteten Schlüsselzahlen / Schlussfolgerungen eine entsprechende Befehlsausgabe oder Quelle?
  4. Stichprobe aus der Quelle: Ziehe 1–2 Stellen willkürlich heraus und überprüfe sie an der Primärquelle.

Wenn auch nur einer dieser Punkte nicht erfüllt ist → Gehe zur Fehlerbehandlung in Schritt 5.

Fertig-Kriterien

  • Die Ausgabe jedes Subagenten wurde mit den Lese-/ Ausführungstools der Plattform tatsächlich zurückgelesen (bei Hermes sind es read_file / terminal)
  • Format und Felder entsprechen den Auftragsanforderungen
  • Schlüssel Schlussfolgerungen haben nachvollziehbare Beweise
  • Mindestens eine Stelle wurde an der Primärquelle überprüft und stimmt mit der Aussage des Subagenten überein
  • Fehlgeschlagene / nicht konforme Ausgaben wurden klar markiert und nicht in das Endergebnis eingemischt

Schritt 5: Abschluss

Bei der Zusammenfassung für den Nutzer müssen drei Dinge beachtet werden:

  • Quelle angeben: Welche Teile wurden von Subagenten erledigt, welche von dir selbst. Der Nutzer hat ein Recht, das zu wissen.
  • Status angeben: Welche Teile wurden überprüft, welche nicht, welche sind fehlgeschlagen. Verwende keine vagen Formulierungen wie „ungefähr“ oder „sollte passen“.
  • Nächsten Schritt angeben: Wo der Nutzer eine Entscheidung treffen muss, muss das klar dargestellt werden.

Fehlerbehandlung (in der Reihenfolge der Priorität):

  1. Degradieren und selbst machen – die Arbeit ist eigentlich nicht groß, also mach es selbst.
  2. Auf anderem Weg erneut delegieren – schreibe den Grund des Fehlschlags in den neuen Auftrag und versuche es mit einer anderen Methode noch einmal.
  3. Aufteilen und erneut delegieren – der Auftrag war zu groß und ist dadurch in die falsche Richtung gelaufen; teile ihn in kleinere Stücke und delegiere erneut.
  4. Wahrheitsgemäß berichten – wenn es nicht funktioniert, dann funktioniert es nicht; erkläre klar die Hürden und die bereits ausgeschlossenen Wege. Es ist nicht erlaubt, Ergebnisse zu erfinden.

Fertig-Kriterien

  • In der Zusammenfassung ist die Quelle jedes Teils angegeben (Subagent / Hauptagent)
  • In der Zusammenfassung ist der Überprüfungsstatus jedes Teils angegeben
  • Fehlgeschlagene Arbeiten wurden behandelt (selbst gemacht / erneut delegiert / wahrheitsgemäß berichtet) und sind nicht unsichtbar
  • Punkte, bei denen der Nutzer entscheiden muss, sind separat aufgeführt
  • Es gibt keinen Satz, der als Tatsache dargestellt wird, ohne bestätigt zu sein

Die Vier Elemente des Delegierungsauftrags

Jeder Auftrag muss diese vier Dinge enthalten. Fehlt auch nur eines, steigt die Wahrscheinlichkeit von Problemen signifikant.

1. Ziel (goal) – Was ist zu tun

Beschreibe das Ziel in einem Satz, mit einem Verb beginnend, ergebnisorientiert.

  • Gut: Führe 3 CSV-Dateien zu einer deduplizierten combined.csv zusammen, behalte die ursprüngliche Spaltenreihenfolge bei
  • Schlecht: Bearbeite diese Dateien mal

2. Hintergrund (context) – Warum wird es gemacht, welche Grundlagen gibt es (muss in sich geschlossen sein)

Dies ist das Element, das am leichtesten schiefgeht. Der Grund ist einfach:

Der Subagent sieht nicht den bisherigen Dialog zwischen dir und dem Nutzer. Er weiß nur, was du in den Auftrag geschrieben hast. Alles, was du im Kopf hast – die Vorlieben des Nutzers, die bisherigen Fallstricke, warum eine bestimmte Lösung nicht in Frage kommt, die Dimensionen der Daten – er bekommt kein einziges Wort davon mit.

Daher müssen im Kontext explizit angegeben werden:

  • Aufgabenkontext: Wozu dient diese Arbeit, worauf legt der Nutzer Wert.
  • Harte Einschränkungen: Zwingend einzuhaltende Dimensionen, Formate, Namenskonventionen, Verbote.
  • Eingabeliste: Konkrete Dateipfade / Verzeichnisse / URLs / Datensätze. Nicht „diese Dateien“ schreiben.
  • Bekannte Fallstricke: Was wurde schon erfolglos versucht, wo gibt es Fallen, was wird leicht missverstanden.
  • Umgebungsinformationen: Arbeitsverzeichnis, verfügbare Tools, ob Abhängigkeiten installiert sind.

Selbsttest: Könnte ein Kollege, der überhaupt keine Vorkenntnisse hat, mit diesem Auftrag arbeiten? Wenn ja, ist er in sich geschlossen.

3. Ausgabestruktur (output schema) – Wie sieht die Ausgabe aus

Gib die Struktur der Ausgabe vor, damit du sie nicht noch einmal aufbereiten musst.

  • Dateien: Pfad + Dateiname + Format (markdown / json / csv) + erforderliche Felder oder Abschnitte.
  • Berichte: Gib die geforderte Struktur vor (Schlussfolgerung / Beweis / Quelle / ungelöste Punkte), nicht einen Aufsatz.
  • Maschinenlesbar bevorzugen: Wenn möglich, json statt Freitext – das spart dir die erneute Analyse.
  • Wenn die Plattform Ausgabevalidierung unterstützt (Überprüfung der Subagentenantwort gegen ein Schema), aktiviere sie; wenn nicht, wiederhole die Struktur im Fließtext des Auftrags und fordere die Antwort in dieser Struktur.

4. Abnahmemethode – Wie wird der Erfolg nachgewiesen

Sage ihm vorab, wie du überprüfen wirst, dann wird er danach handeln; stellst du erst später fest, dass es keine Beweise gibt, musst du nacharbeiten.

  • Fordere die tatsächlich ausgeführten Befehle und deren Ausgabe (nicht „ich habe es überprüft“).
  • Fordere, dass der Ausgabepfad direkt zurückgelesen werden kann.
  • Fordere die explizite Auflistung von unerledigten / unklaren Teilen – ein freiwilliges Geständnis ist besser, als dass du es hinterher aufdeckst.

Kurzübersicht Vier Elemente

ElementEin SatzHäufiger Fehler
ZielWas ist zu tun, ergebnisorientiertZu vage: „Ordne die Daten“
HintergrundKontext + Einschränkungen + Eingabeliste + bekannte FallstrickeNur das Ziel, ohne Kontext; der Subagent interpretiert frei
AusgabestrukturAusgabepfad, Format, FelderKein Pfad angegeben, die Ausgabe ist verstreut und nicht auffindbar
AbnahmemethodeWelcher Befehl / welches Kriterium entscheidetKeine Kriterien; Durchwinken mit „sieht gut aus“

Abnahmeliste

Gehe bei jedem Subagenten die folgende Liste Punkt für Punkt durch. Wenn auch nur einer mit „Nein“ beantwortet wird, gilt die Arbeit nicht als erledigt.

A. Existenz

  • Die Ausgabedatei existiert tatsächlich im im Auftrag angegebenen Pfad (mit den Lese-/ Ausführungstools der Plattform überprüft, nicht nur den Dateinamen angesehen)
  • Die Datei ist nicht leer, der Inhalt ist kein Platzhalter / Überbleibsel einer Vorlage / offensichtlich abgeschnitten
  • Wenn es Code oder ein Skript ist: Es kann wirklich ausgeführt werden (nicht „sieht richtig aus“)

B. Konformität

  • Format, Felder, Benennung entsprechen den Auftragsanforderungen
  • Die Menge stimmt (sollen 10 sein, sind es genau 10, nicht „ungefähr 8“)
  • Keine Grenzüberschreitung: Es wurden keine Dateien geändert, die nicht geändert werden sollten, nichts wurde außerhalb des Auftrags geschrieben
  • Parallele Aufgaben haben sich nicht gegenseitig überschrieben (überprüfe Dateiänderungszeit / Inhaltsintegrität)

C. Authentizität

  • Für die vom Subagenten behaupteten Befehle gibt es entsprechende tatsächliche Ausgaben
  • Wichtige Schlussfolgerungen können auf konkrete Quellen zurückgeführt werden (Datei, URL, Befehlsergebnis)
  • 1–2 Stellen wurden willkürlich herausgegriffen und mit der Primärquelle abgeglichen; die Schlussfolgerungen stimmen überein
  • Es gibt keine Zahlen oder Behauptungen, die „vernünftig aussehen, aber deren Quelle nicht gefunden werden kann“

D. Vollständigkeit

  • Jeder im Auftrag geforderte Punkt wurde geliefert
  • Unerledigte / unklare Teile wurden explizit aufgelistet, nicht versteckt
  • Fehlgeschlagene Punkte wurden klar erläutert (was war falsch, was wurde versucht)

E. Letzter Check vor der Zusammenfassung

  • In meiner Antwort an den Nutzer habe ich die Quelle und den Überprüfungsstatus angegeben
  • Ich habe das „Selbstmeldung erfolgreich“ des Subagenten nicht als „erledigt“ in die Schlussfolgerung geschrieben

Häufige

Individual skills in this repo

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

lingyu9495-source/agent-responsiveness-delegation

你给 AI 助手派了个重活,然后发现:发消息它不回、想插话只能排队、等十几分钟才回一句——等它抬头,需求早变了。根因不是模型慢,是主脑把重活放在前台跑,整个回合被占死。这个 Skill 把这套「重活外派 + 随时应答」机制做成可落地的东西:① 规则块(一页写清判级、派完立刻让出对话、工单四要素、只回收结论、自报≠事实、拍板留主脑、跨会话任务换机制)② 跨平台落地脚本 provision_agent_responsiveness.py:探测本机已有的 Agent 环境(Hermes 的 SOUL 置顶铁律块、Claude Code 的全局指令文件,这两条已实测),把规则块幂等写入(自动备份原文件、重复执行不重复写、绝不覆盖你已有内容);其余平台(Codex / Cursor / WorkBuddy / 任意 Agent)则导出一份可直接粘贴的规则块 markdown,你粘到系统提示或自定义指令里就生效 ③ 体检脚本 audit_agent_responsiveness.py:逐项核对规则块是否存在、是否被后续改动覆盖、探测到哪些平台——没检测到就如实报「未检测到支持的平台」,不假报通过。纯标准库、零依赖、Windows/macOS/Linux 通用。触发词:AI不回话、等太久、插话卡住、助手响应慢、主脑被占住、重活外派、子代理、多智能体、响应速度、落地配置、系统提示。

lingyu9495-source/ai-image-watermark-removal-boss

去除 AI 生成图角落的"XXAI生成"半透明/白色角标水印。像素级验证不自我欺骗、双信号交叉定位抗幻觉、多候选客观指标投票覆盖。当用户要求去除图片水印、清理 AI 生成角标、去"豆包/即梦/Kolors 生成"水印时使用。

lingyu9495-source/bank-scan-household-splitter

客户丢来一个压缩包,里面几百张身份证正反面、开卡申请书、合同——**人工一张张挑,一下午就没了,还容易漏**。

lingyu9495-source/cn-pdf-report-typeset

中文报告做成 PDF,常见翻车三件套:**字体乱码、表格错位、字号小到客户在手机上根本看不清**。这套是交付级的排版标准加可直接跑的模板。

lingyu9495-source/company-law

公司出事,十有八九出在**治理和控制权**上——股权结构一开始搭歪,后面融资、上市、分家全是坑。

lingyu9495-source/excel-keep-format-edit

客户拿来一张老报表说「就在原表上改个数,格式一点都不要动」——用 openpyxl 重建一次,字体、边框、合并单元格、条件格式、列宽全丢,客户一打开就知道这不是他原来那张表。

lingyu9495-source/feasibility-report-engine

做可研报告,卡住的往往不是不会写,是**不知道按哪版大纲、财务测算六表和正文对不上、交付前排版被退稿**。这套是从二十多万字、131 张表的真实交付里固化的流水线。

lingyu9495-source/feasibility-study-consultant

项目可行性论证与研究报告写作框架 —— 任何「这事能不能做、怎么做、值不值得做」的商业决策场景:可行性研究/立项论证/新项目评估/创业方向验证。10大论证模块 + 强制联网尽调 + 多源交叉验证 + 读者视角写作 + 结构化报告输出。(v1.4 升级:从「引导客户把项目情况讲清楚」到「按问题类型与项目类型选论证方法」再到「用假设台账逐条验证」的六步教练流程;附可行性门槛评分器与假设台账两个零依赖脚本、项目卡与决策门清单模板)

lingyu9495-source/financial-statement-adjustment

存量财务报表在原表基础上改数字并保持三表勾稽关系。当用户要求「在原报表上改某些数字,其他数据跟着调整且格式完全不变」时使用:资产负债表/利润表/现金流量表的目标值调整、未分配利润与利润总额联动、勾稽校验。

lingyu9495-source/funding-fit-diagnosis

项目想融资,卡住的往往不是不会写 BP,而是不知道够不够格、该找谁、还缺什么、多久能到钱——问 AI 只得到"建议加强团队"这类正确的废话。这套引擎把它拆成可执行的四步:①10 问项目画像采集(缺关键项就先追问,不猜)②双轨评分:市场化 VC 适配分与政府基金适配分**分开算、各自判定**(≥75 强匹配 / 60-74 可争取 / 45-59 需补短板 / <45 暂不建议,低分不许只说"不行",要给替代路径)③点名机构:按赛道/阶段/地域从 23 家头部 VC 与产业资本(CVC)、21 家政府基金的卡片里逐条对照"匹配信号/劝退信号",每家写清"为什么是你、你还缺什么、材料怎么准备、递送路径",并单列"不建议碰"的机构省时间④差距清单(差距|补齐动作|耗时|难度|优先级,只挑 3 个月内能推动的)+ 三线找钱路线图(市场化 / 政府 / 替代路径)+ 时间预期与现金流提醒。包内另附 30 个真实融资案例对标、TS 条款红线、估值倍数参考、BP 制作铁律,以及零依赖离线评分脚本(纯标准库、不联网、不调大模型 API)。输入:项目情况(照着 10 问答即可);输出:一份研判报告(评分 + 优先接触名单 + 差距清单 + 路线图 + 风险提示),脚本侧可另出 JSON 评分结果。评分是适配度不是成功率,不承诺融资结果。触发词:融资、找投资、融资研判、能不能融到钱、找哪家风投、风险投资、VC、产业资本、CVC、政府引导基金、政府基金申报、产业基金、招商返投、项目申报、补贴申报、商业计划书、BP、路演、估值、股权稀释、TS 条款、对赌、回购、FA、财务顾问、找钱、融资渠道、天使轮、Pre-A、A轮。

lingyu9495-source/gov-fund-application

想拿政府的钱,最容易白跑半年——层级选错、赛道不在目录里、返投算不清,材料递上去才发现方向不对。这套参谋按可执行顺序走:①先判层级(国家级/省级/市级/区级,门槛与目的完全不同)②赛道对目录:不在目录里直接如实说没戏,不让用户白跑③21 家基金卡片逐家对照(投资方式、返投比例、让利规则、申报条件、申报通道、真实案例),点名"你这个项目适合找谁"④返投博弈:算清落地要求,给"不想迁注册地"的三条合规路径⑤材料与时间表:申报材料清单、评审周期(6-12 个月是常态)与现金流提醒。与主技能 `funding-fit-diagnosis` 配套(做整体融资研判时用主技能,VC 与政府双轨分开算)。输入:项目基本情况与注册地/落地意愿;输出:层级判定 + 可申报基金名单 + 返投方案 + 材料清单 + 时间预期。不承诺拿到资金,申报须如实提交材料;政策口径标注截止时间,细则请向当地主管部门核实。触发词:政府基金、政府引导基金、产业基金、政府补贴、专项资金、项目申报、补贴申报、申报条件、返投、招商落地、母基金、投资方式、让利、国家级基金、省级引导基金、市级基金、科技成果转化、专精特新、科技型企业、中小企业发展基金。

lingyu9495-source/hermes-profile-browser-isolation

多个 AI 助手同时干活时,浏览器会互相抢占:弹窗抢焦点、任务互相打断、你正在用的 Chrome/Edge 被顶掉——**你连自己的网页都点不动了**。

lingyu9495-source/investment-finance

做投融资最容易踩的坑不是"不懂概念",是**条款里的每一个字都在分钱**——估值方法选错、对赌触发条件写松、回购条款没兜底,签完才发现少拿几千万。

lingyu9495-source/lowvram-ai-video-comfyui

网上的 AI 视频教程开口就是 24G 显存,一看就把人劝退——**其实 8G 的 4060 也能跑**。这套是 RTX 4060 Laptop 8G 显存 / 32G 内存 / Win11 上真跑出来的配置与调参。

lingyu9495-source/novel-deai-detector

写完的稿子发布前想知道会不会被判 AI 生成、平台审核会不会卡、读者会不会一眼看出机器味——这套是检测到清洗的完整闭环。

lingyu9495-source/npl

不良资产这行的钱,赚在**买入价**上——买贵了,后面怎么处置都白搭。

lingyu9495-source/ts-term-review

拿到 TS 或投资协议,看半天不知道哪条能签哪条得改——风险全藏在具体条目里,一句"整体没大问题"最要命。这套审查按 15 条核心条款逐条过:估值 Pre/Post、清算优先权、反稀释(完全棘轮是红线)、优先购买权、领售/拖售、对赌与业绩承诺、回购条款、个人连带担保、董事会与一票否决、保护性条款、竞业与知识产权、信息权、交割条件、股东会表决权、违约责任。每条给三级判定(🔴 红线不改就别签 / 🟡 可谈争取改 / 🟢 行业惯例)+ 谈判话术 + 替代方案,并区分"对公司"和"对创始人个人"——个人连带回购是绝大多数血案的源头,重点标红。另附谈判筹码排序、常见坑清单、BP 与数据室准备。与主技能 `funding-fit-diagnosis` 配套(做整体融资研判时用主技能)。输入:TS/投资协议条款(粘贴或描述);输出:逐条判定表 + 必须改的清单 + 谈判话术 + 底线建议。**不构成法律意见**,正式签署与司法效力请找执业律师确认。触发词:TS、Term Sheet、投资条款清单、投资协议、增资协议、股权转让协议、对赌、业绩承诺、回购、清算优先权、反稀释、完全棘轮、个人连带、一票否决、领售权、拖售权、估值、Pre/Post、股权稀释、条款谈判、FA。

Verwandte Skills