Adingo001/staffer

agy staffer

Die universelle Persona: ein sauberer Einstiegspunkt für Aufgaben, die in keines der Spezialisten passt. Ihre Prompt-Vorlage ist bewusst minimalistisch – der Aufgabentext, die Umgebung (cwd, Branch, Datum), die gemeinsamen Arbeitsregeln und die Sicherheitsvorkehrungen, sonst nichts. Keine Rollenrahmen oder festes Ausgabeformat: Die Aufgabe definiert ihr eigenes Ergebnis, und kein domänenspezifischer Vorlagenkontext kann die Ausführung in die falsche Richtung lenken.

Bevorzugen Sie einen Spezialisten, wenn einer passt: researcher für Recherchen und tiefgehende Analysen, reviewer für Zweitmeinungen zu Code oder Plänen, implementer für Änderungen am Arbeitsbaum, ask für eine günstige One-Shot-Frage.

staffer ist auch der Weg zu agy-eigenen Tools, die kein Spezialist abdeckt – insbesondere Bildgenerierung: agy enthält ein generate_image-Tool (verifiziert auf v1.1.15; ein 1024×1024 PNG in ~30s). Geben Sie den Ausgabepfad in der Aufgabe an, z. B. staffer --prompt "generiere ein Pixel-Art-Roboter-Maskottchen, speichere es als assets/mascot.png".

Den Begleiter finden

Diese Skill-Datei lebt unter <plugin-root>/skills/staffer/SKILL.md; lösen Sie den Begleiter-Pfad relativ zu diesem Skill-Verzeichnis auf:

node "<skill-dir>/../../companion/agy-companion.mjs" staffer [flags] --prompt "Aufgabe"

Übergeben Sie den Aufgabentext des Benutzers wörtlich über --prompt; verwenden Sie --prompt-file <path> oder --stdin für lange Texte.

[!IMPORTANT] Führen Sie diesen Befehl unsandboxed aus – agy benötigt einen Localhost-Port und seine OAuth-Token-Datei, die Harness-Sandboxen verbergen. In Codex fordern Sie erweiterte Berechtigungen für den Befehl an. Details: ../jobs/references/troubleshooting.md.

Ergebnis sammeln

Der Befehl gibt eine Job-ID zurück. Lesen Sie ../jobs/SKILL.md für das Sammeln und die Wiederherstellung von Ergebnissen: Auslösen, auf das endgültige Ergebnis warten, dann bei Bedarf validieren. Beobachten Sie nicht proaktiv den Fortschritt, lesen Sie keine Logs oder inspizieren Sie Zwischenartefakte während der Ausführung. Beobachten Sie nur, wenn der Benutzer explizit nach Fortschritt fragt; diagnostizieren Sie einen Fehler oder ein Ergebnis, das Eingreifen erfordert, gemäß dem Job-Protokoll.

Flags (alle optional)

• --prompt <text> / --prompt-file <path> / --stdin – die Aufgabe, aus genau einer dieser drei Quellen. Verwenden Sie Datei/stdin für lange Prompts anstelle von Shell-Anführungszeichen.
• --model <id> oder --effort low|medium|high – Standardmodell ist gemini-3.8-flash-medium.
• --restricted / --unrestricted – Berechtigungsprofil; staffer standardmäßig unrestricted wie die anderen werkzeugnutzenden Personas, --restricted ist der Opt-in-Härtungspfad.
• --continue (oder --conversation <id>), --timeout <dur> (Standard 60m, maximal 120m harte Ausführungsgrenze).

Regeln

• Übergeben Sie die Aufgabe des Benutzers wörtlich. Da die Vorlage kein Ausgabeformat vorgibt, geben Sie das gewünschte Format im Aufgabentext an, wenn der Aufrufer ein bestimmtes benötigt.
• Übergeben Sie die expliziten Autorisierungen des Benutzers wörtlich. Die Vorlage lehnt standardmäßig kostspielige oder irreversible Nebenwirkungen ab (Commits/Pushes, Löschen von Dateien außerhalb des Arbeitsbereichs, nebenwirkungsbehaftete Netzwerkaufrufe, kostenpflichtige Quota-Befehle); diese Voreinstellung wird nur geöffnet, wenn die Aufgabe selbst die Operation anfordert.
• Eine allgemeine Aufgabe kann durchaus Dateien bearbeiten. Der Begleiter meldet alle Änderungen am Arbeitsbaum zusammen mit dem Ergebnis – überprüfen Sie diese (git diff) und bestätigen Sie, dass es das ist, was die Aufgabe verlangt hat, bevor Sie darauf aufbauen.
• Bei Fehlern und Wiederherstellung folgen Sie ../jobs/SKILL.md.

Für eine bestehende Unterhaltung übernehmen --continue / --conversation <id> das aufgezeichnete Modell und Berechtigungsprofil, sofern nicht explizit überschrieben. Die uneingeschränkten Standardeinstellungen oben gelten für neue Aufgaben.