berkekcay/link-shortener-agent-ready

Verwende diesen Skill, um eine Aufgabe aus docs/TASKS.md (benutzerdefinierter Alias, Klickzähler, Ablaufdatum) oder andere Änderungen am Verhalten des Linkverkürzers zu implementieren. Er führt dich durch Tests, die kleinste Änderung, pytest und eine Zusammenfassung.

Was ist link-shortener-agent-ready?

Dieser Skill bietet eine strukturierte Schritt-für-Schritt-Anleitung für Entwickler, die Änderungen an einem Linkverkürzer-Dienst vornehmen möchten, der in Python mit FastAPI und SQLite implementiert ist. Er eignet sich besonders für Aufgaben wie das Hinzufügen benutzerdefinierter Aliase, Klickzähler oder Ablaufdaten basierend auf der Aufgabenliste in `docs/TASKS.md`. Der Skill stellt sicher, dass alle Änderungen testgetrieben erfolgen: Zuerst wird ein fehlschlagender Test geschrieben, dann die minimale Implementierung in `main.py` durchgeführt, gefolgt von der vollständigen Testsuite. Er unterstützt die Plattformen, die mit dem Repository verbunden sind (z. B. Claude Code, Cursor) und ist ideal, um Regressionen zu vermeiden und qualitativ hochwertige, gut dokumentierte Änderungen zu gewährleisten. Der Skill bindet explizit wichtige Dateien wie `AGENTS.md`, `docs/TASKS.md` und `tests/AGENTS.md` ein und fordert den Entwickler auf, bei Unklarheiten innezuhalten und nachzufragen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/berkekcay/link-shortener-agent-ready/tree/HEAD/.claude/skills/implement-task

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

Implementiere eine Linkverkürzer-Aufgabe

Befolge diese Schritte der Reihe nach. Halte inne und frage nach, wenn die Aufgabe unklar ist oder etwas unter „Vorher eine Person fragen“ in AGENTS.md aufgeführt ist.

  1. Lesen. Öffne AGENTS.md, die ausgewählte Aufgabe in docs/TASKS.md und tests/AGENTS.md. Arbeite nur an dieser einen Aufgabe.

  2. Inspizieren. Lese main.py (die Tabelle, encode(), das Anfragemodell und beide Routen) und tests/test_main.py. Notiere alles, womit die Aufgabe interagiert, z. B. wie Codes generiert werden oder wie die Datenbank zwischen Ausführungen gemeinsam genutzt wird.

  3. Plan festlegen. Schreibe vor dem Bearbeiten auf:

    • das erwartete Verhalten, einschließlich Statuscodes und Antwortkörper für Erfolg und jeden Fehlerfall;
    • die Dateien, die du ändern wirst;
    • Randfälle (leere oder ungewöhnliche Eingaben, Kollisionen mit vorhandenen Codes, sich wiederholende Werte).
  4. Einen fehlschlagenden Test schreiben. Füge Verhaltenstests in tests/test_main.py gemäß tests/AGENTS.md hinzu: mindestens ein Erfolgs- und ein Fehlerfall. Führe sie aus und bestätige, dass sie aus dem richtigen Grund fehlschlagen (die Funktion fehlt, nicht ein Tippfehler):

    pytest tests/test_main.py -k <neuer_test_name>
    
  5. Die kleinste Änderung implementieren in main.py, die die Tests bestehen lässt. Behalte das bestehende Verhalten und die Antwortstrukturen bei. Wenn die Tabelle eine neue Spalte benötigt, füge sie so hinzu, dass eine vorhandene links.db weiterhin funktioniert (oder erkläre, warum sie neu erstellt werden muss).

  6. Alles ausführen.

    pytest
    

    Alle ursprünglichen und neuen Tests müssen bestehen. Korrigiere und führe erneut aus, bis sie bestehen.

  7. Zusammenfassen in dieser Form:

    Aufgabe:
    Verhalten:
    Geänderte Dateien:
    Hinzugefügte Tests:
    pytest-Ergebnis:
    Verbleibende Risiken:
    

Verwandte Skills