Communitygithub.com

leonhoffmann86/team-sprint

🏃 Sprint — jeder TODO-Eintrag erhält einen kompletten Mini-Sprint: autonom plan→implementieren→überprüfen für Claude Code per Git-Hook-Agentenkette, isoliertem Worktree, deterministischem Gate und Fail-Closed-Review

Was ist team-sprint?

Dieses Skill verwandelt eine grobe Idee in einen klar definierten Task in der `TODO.md` eines Projekts. Es ist als reiner Verfeinerungs-Workflow konzipiert, der kein Code-Schreiben beinhaltet. Der Skill arbeitet in fünf Schritten: Zuerst liest er die Konfigurationsdateien des Projekts (wie `sprint.conf`, `AGENTS.md` oder `CLAUDE.md`), um dessen Risikostufen und Autonomie-Regeln zu verstehen. Danach verortet er die Idee im tatsächlichen Code mithilfe von Code-Graphen-Tools oder Grep/Glob, um die betroffenen Symbole und Dateien zu identifizieren. Der Kern des Skills ist das kritische Hinterfragen der Idee: Er prüft, ob es sich um eine Frage oder einen Task handelt, bestimmt den minimalen Umfang, bewertet die Risikostufe und identifiziert die Entscheidungen, die der Benutzer treffen muss. Abschließend erstellt der Skill einen strukturierten TODO-Eintrag mit klarer Anweisung, Risikostufe, Erledigungskriterium und Datei-/Funktionshinweisen und schreibt ihn nach Benutzerfreigabe in die `TODO.md`. Der Skill ist primär für Claude Code und ähnliche KI-gesteuerte Entwicklungswerkzeuge gedacht, die über Git-Hooks und Worktrees eine automatisierte Plan-Implement-Review-Kette ermöglichen. Durch die strikte Trennung von Verfeinerung und Implementierung stellt er sicher, dass nur wohlgeformte, vom Benutzer genehmigte Tasks in die Automatisierung gelangen.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add leonhoffmann86/team-sprint

In Ihrer bevorzugten KI fragen

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

Dokumentation

Du verwandelst eine grobe Idee in eine wohlgeformte Aufgabe in der TODO.md. Die grobe Idee:

$ARGUMENTS

Dies ist ein Verfeinerungs-Workflow, keine Implementierung. Schreibe keinen Code. Schreibe nicht in die TODO.md, bis die Aufgabe klar ist und der Benutzer sie genehmigt hat. Arbeite in diesen Schritten:

1. Lies die Verfassung

Finde die Verfassungsdateien des Projekts und lies sie – befolge ihre Konventionen, insbesondere die Risikostufen und alle Regeln zu autonomen Agenten / TODO-Lebenszyklus.

  • Wenn sprint.conf existiert, lies die in SPRINT_CONSTITUTION_FILES aufgeführten Dateien (in der angegebenen Reihenfolge).
  • Ansonsten lies die vorhandenen Dateien AGENTS.md und CLAUDE.md (sowie alle projektspezifischen Anleitungen, auf die sie verweisen, z. B. ein frontend-spezifisches CLAUDE.md).
  • Überfliege .githooks/README.md, falls vorhanden, damit du den nachgelagerten Effekt korrekt beschreiben kannst. Wenn keine dieser Dateien existiert, teile dem Benutzer mit, dass das Repository noch nicht initialisiert ist, und biete /sprint:bootstrap an.

2. Verankere die Idee im echten Code (nicht raten)

Finde die tatsächlichen Symbole/Dateien, die von der Idee berührt werden, sowie ihren Einflussbereich:

  • Code-Graph (bevorzugt, falls verfügbar): die Tools mcp__codegraph__* (codegraph_search, …_callers, …_callees, …_impact, …_context) oder die CLI (codegraph context "<die Idee>", codegraph callers <symbol>, codegraph impact <symbol>); führe zuerst codegraph sync . aus, wenn der Index veraltet erscheint.
  • Fallback (kein Code-Graph): Verwende Grep/Glob, um die relevanten Symbole und ihre Aufrufer zu finden. Lies die wenigen Dateien, die tatsächlich relevant sind. Nenne konkrete Funktionen/Dateien und wo die Änderung landet.

3. Hinterfrage sie (der Kern dieses Skills)

Stelle die Idee dem vorhandenen Code kritisch gegenüber. Bringe Folgendes ans Licht:

  • Ist es eine Frage oder eine Aufgabe? Wenn es wirklich eine Frage ist („…oder übersehe ich etwas?“), beantworte sie zuerst anhand des Codes – die vorhandene Logik deckt möglicherweise bereits einen Teil davon ab.
  • Der tatsächliche Umfang und die kleinste Änderung, die einen Mehrwert liefert.
  • Die Risikostufe (gemäß der Verfassung / AGENTS.md). Wenn sie hoch ist, sage das – sie wird nicht automatisch implementiert; die Kette delegiert sie an einen Menschen.
  • Die Entscheidungen, die der Benutzer treffen muss, nicht du (Produkt-/UX-/Richtlinienentscheidungen). Stelle dem Benutzer diese wenigen Entscheidungen mit AskUserQuestion. Erfinde keine Antworten auf echte Produktentscheidungen; korrigiere falsche Annahmen anhand von Beweisen aus dem Codebestand.

4. Entwirf EINEN strukturierten Eintrag (die vier Zutaten)

Schreibe einen Entwurf mit:

  1. einer klaren zwingenden Aufgabe (keine Frage),
  2. der Risikostufe,
  3. einem konkreten Erledigungskriterium (welcher gezielte Test muss grün sein / welches Verhalten ist überprüfbar),
  4. Datei-/Funktionshinweisen aus Schritt 2. Halte dich an die kleinste wertvolle Änderung. Zeige den Entwurf und verfeinere ihn, bis der Benutzer zufrieden ist.

5. Schreibe ihn in die TODO.md und übergib dann

  • Füge den genehmigten Eintrag als - [ ]-Eintrag in der Nähe des Anfangs der TODO.md hinzu.
  • Frage, ob er zum einzigen aktiven Eintrag gemacht werden soll – wenn ja, verschiebe die anderen aktuell aktiven Einträge in einen <!-- … -->-Block (oder unter ## 🚧 Zurückgestellt) gemäß der Überspring-Konvention, sodass die Kette nur diesen einen aufgreift.
  • Committe nicht automatisch. Sage dem Benutzer: Das Committen der TODO.md startet die Plan→Implementieren→Überprüfen-Kette (die Implementierung landet auf dem impl-Branch, nichts wird automatisch gemergt). Biete an zu committen, wenn der Benutzer möchte, dass der Prozess jetzt beginnt.

Halte den Dialog knapp: Verankere zuerst, frage nur nach den Entscheidungen, die wichtig sind, und schreibe dann.

Verwandte Skills