chukaofili/agent-plugins

Verwenden Sie diesen Modus, wenn ein genehmigter Plan vollständig ohne menschliche Aufsicht umgesetzt werden soll. Typische Hinweise sind „Hier ist der Plan, los geht's“, „Arbeite heute Nacht daran“, „Autonom laufen lassen“, „Ich bin in ein paar Stunden zurück“ oder eine lange Sitzung vor einem Meeting. Er regelt, was der Agent allein entscheiden darf, die vier Kontrollpunkte, die er niemals überschreiten darf, die Sicherung der Arbeit (häufig committen und pushen) sowie die Delegation an Subagenten und das Hinterlegen von Blockern, sodass die Arbeit nach Rückkehr des Menschen überprüfbar ist.

Was ist agent-plugins?

Dieser Skill, genannt "Unbeaufsichtigter Lauf" (Unattended Run), ermöglicht es KI-Agenten, einen zuvor genehmigten Plan autonom und ohne menschliche Überwachung auszuführen. Er ist speziell für Szenarien gedacht, in denen der Agent über einen längeren Zeitraum hinweg arbeiten soll – etwa über Nacht oder während einer Besprechung. Der Skill stellt klare, nicht verhandelbare Regeln auf: Der Agent darf keine Änderungen am geplanten Umfang vornehmen, keine externen Kommunikationen (wie Veröffentlichungen oder API-Aufrufe) tätigen, keine Kosten verursachen und keine destruktiven oder irreversiblen Aktionen durchführen. Um die Arbeit dauerhaft zu sichern, wird empfohlen, nach jeder logischen Einheit zu committen und zu pushen, Arbeitsbäume zu isolieren und vor Pausen keine uncommitteten Arbeiten zu hinterlassen. Der Skill unterstützt die Delegation einfacher, mechanischer Aufgaben an günstigere Modelle, wobei die Qualität jeder delegierten Arbeit vor der Integration überprüft werden muss. Blockaden sollen klar benannt werden, und vor dem Stoppen soll der Agent alles erledigen, was nicht von der Lösung dieser Blockaden abhängt. Abschließend erstellt der Agent einen Übergabebericht im Verzeichnis `docs/plans/`. Der Skill ist als allgemeine Anleitung für jede Agentenplattform gedacht, solange deren Sicherheits- und Budgetgrenzen beachtet werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/chukaofili/agent-plugins/tree/HEAD/plugins/coding-protocol/skills/unattended-run

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Unbeaufsichtigter Lauf

Dies ist der Modus für "Hier ist der Plan, los geht's": Setzen Sie ihn komplett um, ohne dass jemand an der Tastatur sitzt, und stellen Sie sicher, dass die Arbeit nach Rückkehr der Person überprüfbar ist. Er ist nicht an eine bestimmte Tageszeit gebunden. Er gilt für alle Zeiträume, in denen niemand zusieht, um eine Frage zu beantworten.

Voraussetzung: Ein genehmigter Plan

Dieser Modus hebt das Prinzip "Vorschlagen vor dem Bauen" nicht auf (siehe coding-process). Er kommt nach der Genehmigung zum Einsatz. Innerhalb des genehmigten Plans entscheiden Sie über reversible Implementierungsdetails selbst und schreiben jede Annahme auf. Eine dokumentierte Annahme ist besser als eine Sitzung, die die Nacht mit Warten verbracht hat. Das ist die gesamte Ausnahme.

Vier Kontrollpunkte, die Sie niemals allein passieren

Diese bleiben Kontrollpunkte, selbst wenn der Schritt reversibel ist. Keiner davon ist eine Ermessensentscheidung.

  1. Umfang. Alles, was der genehmigte Plan nicht bereits abdeckt: eine neue Funktion, eine nicht angeforderte Refaktorisierung oder das Auslassen eines Schritts, weil er sich als schwierig erwiesen hat. Das Einrichten eines fehlenden Test-Harnesses gilt als Umfang.
  2. Alles, was den Rechner verlässt: Externe Nachrichten, Veröffentlichungen oder Aufrufe eines Drittanbieterdienstes. Arbeiten im Repository (Branches, Commits, Pushen, PRs) sind Teil des Plans; die Kommunikation mit der Außenwelt ist es nicht.
  3. Alles, was Geld kostet: Kostenpflichtige APIs, bereitgestellte Infrastruktur, alles, was nach Verbrauch abgerechnet wird.
  4. Alles Destruktive oder Irreversible: Datenverlust, Force-Pushes auf geteilte Branches, Produktion.

Die Arbeit dauerhaft sichern

  • Zuerst isolieren. Verwenden Sie einen Worktree, es sei denn, das Harness hat Ihnen bereits einen bereitgestellt. Ein unbeaufsichtigter Lauf ist genau der Zeitpunkt, an dem jemand anderes das Haupt-Checkout berühren könnte.
  • Nach jeder logischen Einheit committen und pushen, nicht erst am Ende. Nicht gepushte Arbeit geht verloren, wenn die Sitzung abrupt endet. In diesem Modus überschreibt dies das übliche "Vor dem Committen fragen".
  • Gehen Sie niemals mit uncommitteter Arbeit in eine Pause. Wenn Ihr Agent Nutzungslimits hat, machen Sie kurz vor dem Limit eine Pause, warten Sie auf den Reset und setzen Sie dann fort.
  • Führen Sie die vollständigen Tests (Gates) an Kontrollpunkten aus, nicht nach jeder Änderung. Führen Sie während einer Änderung den engsten Test durch, der erfassen würde, was Sie gerade geändert haben: den Typtest eines Pakets oder eine einzelne Testdatei. Führen Sie den Build, Lint, die vollständige Testsuite und das CI-äquivalente Gate aus, sobald eine Arbeitseinheit abgeschlossen ist und bevor sie zur Überprüfung gepusht wird. Das erneute Ausführen einer Suite, die vor zehn Minuten bestanden wurde, an Code, den Sie nicht berührt haben, verbraucht Rechenleistung, um nichts zu lernen.

Delegation (wenn Ihr Agent Subagenten starten kann)

  • Delegieren Sie mechanische Arbeit an günstigere Modelle: Kopieren einer vorhandenen Struktur, Boilerplate, Synchronisieren von Dokumentationen, wiederholte Änderungen. Behalten Sie das primäre Modell für korrektheitskritische Logik (Schema, Sicherheitsgrenzen, Kerndienste) und für Ermessensentscheidungen.
  • Begrenzen Sie die Parallelität auf etwa fünf. Darüber hinaus wird die Prüfung unrealistisch, und parallele Agenten kollidieren in denselben Dateien.
  • Prüfen Sie alles, was delegiert wurde. Integrieren Sie niemals die Ausgabe eines Subagenten, ohne sie gelesen zu haben. Überprüfen Sie, ob sie sinnvoll ist, Konventionen folgt und Build und Tests grün sind. Wenn sie falsch ist, bewerten Sie die Lücke: Beheben Sie eine kleine selbst und senden Sie eine große mit der Korrektur zurück.

Blocker

  • Blockaden benennen; nicht raten. Wenn ein Planschritt einen expliziten Kontrollpunkt hat oder auf einen echten Blocker stößt (fehlende Infrastruktur, fehlgeschlagene Annahme), markieren Sie ihn deutlich, anstatt eine Problemumgehung zu erfinden, die das Design ändert.
  • Erledigen Sie zuerst alles, was nicht von der Antwort abhängt, sodass die Person bei ihrer Rückkehr eine Frage plus erledigte Arbeit vorfindet, nicht nur eine Frage.
  • Ein feststeckendes PR-Review ist ebenfalls ein Blocker. Markieren Sie es und bauen Sie die darüber liegenden Stufen lokal weiter, wo sie nicht von der Antwort abhängen.

UI-Verifizierung ist nicht optional, wenn niemand zusieht

Das Steuern der Benutzeroberfläche in einem Browser ist der Schritt, der am ehesten weggelassen wird, wenn niemand zusieht – und dessen Fehlen ein Prüfer nicht im Diff sehen kann. Befolgen Sie verify-ui. Wenn die Umgebung die Funktion nicht ausführen kann (fehlende Anmeldeinformationen, Infrastruktur, die Ihnen nicht gehört), geben Sie dies im Testbereich des PRs an: Nennen Sie, was blockiert hat und was stattdessen verifiziert wurde. Schweigen wird als "verifiziert" interpretiert.

Wenn Sie fertig sind

Berichten Sie den Stand der Arbeit: Was ausgeliefert wurde (PRs und Branches), was auf Review wartet, jede getroffene Annahme und jeden markierten Blocker. Schreiben Sie dies als Übergabe in docs/plans/, wenn die Sitzung endet.

Individual skills in this repo

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

chukaofili/agent-plugins

Use when starting a feature, refactor or bug fix; when asked to plan, spec, design or debug something; when writing a plan or handoff document; when choosing, adopting or upgrading a dependency, framework or external API; or when starting work that will become its own branch. Covers propose-before-building, scoping work to the PR size budget, debugging discipline, reading current docs instead of trusting memory, and when and how to use a git worktree.

chukaofili/agent-plugins

Use when a change is likely to exceed ~300 changed lines, when work spans several commits or stages, when opening a pull request, when receiving or responding to review feedback on any pull request, or when rebasing or landing a stack of dependent PRs. Covers the PR size budget and what counts toward it, how to split and stack PRs, sequential stage-by-stage review, and how to handle review findings by verifying each one, then fixing it or pushing back.

chukaofili/agent-plugins

Use when a PR stage or feature is finished and before its PR opens; when files, packages, routes, commands, env vars, APIs or conventions were added, renamed, moved or removed; or when asked to "update docs", "sync docs", "refresh the README/AGENTS.md", or told "docs are stale". Audits every doc against the code, fixes drift, regenerates generated docs, and commits the result to the current branch.

chukaofili/agent-plugins

Use when a change touches anything a user sees, such as components, pages, views, screens, styles, templates, dialogs, forms or copy, and before opening a PR for it. Covers driving the change in a real browser through every state, running a review sweep against the repo's design and framework guidelines, and capturing screenshots for the PR, including what to do when no browser is available.

Verwandte Skills