CommunitySchreiben & Editierengithub.com

openkash/ai-agent-spec-skill

Feature-Spezifikationsfähigkeit für Codierungsagenten. Klären, was gebaut werden soll, bevor Code geschrieben wird.

Was ist ai-agent-spec-skill?

Dieses Skill hilft KI-Codierungsagenten wie Claude Code, Cursor oder Codex, detaillierte Feature-Spezifikationen zu erstellen, bevor sie mit der Implementierung beginnen. Es zwingt den Agenten, die Anforderungen, Randbedingungen, Abhängigkeiten und erwarteten Ergebnisse eines Features vollständig zu definieren – ähnlich einem strukturierten Lastenheft. Der Workflow umfasst typische Schritte: Problemdefinition, gewünschtes Verhalten, Akzeptanzkriterien und technische Einschränkungen. Dadurch werden Fehlinterpretationen reduziert, die Codequalität verbessert und Iterationen minimiert. Das Skill ist plattformunabhängig und kann in jedem unterstützten Entwicklungsumfeld integriert werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add openkash/ai-agent-spec-skill

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

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

Dokumentation

Was macht ai-agent-spec-skill?

Feature-Spezifikationsfähigkeit für Codierungsagenten. Klären, was gebaut werden soll, bevor Code geschrieben wird.

Beschreibung

Dieses Skill fordert den KI-Agenten auf, eine klare und präzise Spezifikation des zu implementierenden Features zu erstellen, bevor er Code generiert. Es stellt sicher, dass alle Beteiligten (Mensch und KI) ein gemeinsames Verständnis der Anforderungen haben.

Verwendung

  1. Beschreibe dem Agenten das gewünschte Feature.
  2. Der Agent ruft die Funktion generate_feature_spec auf.
  3. Der Agent füllt die folgenden Abschnitte aus:
    • Problemstellung: Was ist das Problem, das gelöst werden soll?
    • Gewünschtes Verhalten: Wie soll sich das Feature verhalten?
    • Akzeptanzkriterien: Konkrete, überprüfbare Bedingungen für die Fertigstellung.
    • Technische Einschränkungen: Bekannte Einschränkungen oder Abhängigkeiten.
    • Nicht-Ziele: Was explizit nicht Teil dieses Features ist.
  4. Nach Validierung der Spezifikation durch den Benutzer beginnt der Agent mit der Implementierung.

Beispiel

Benutzereingabe: "Füge eine Suchleiste zur Benutzerliste hinzu."

Agentspezifikation:

  • Problemstellung: Benutzer können in großen Benutzerlisten keinen bestimmten Eintrag finden.
  • Gewünschtes Verhalten: Eine Suchleiste oben in der Liste filtert die angezeigten Benutzer in Echtzeit nach Namen.
  • Akzeptanzkriterien:
    • Die Suchleiste filtert bei jeder Tasteneingabe.
    • Sie zeigt eine Meldung "Keine Ergebnisse" bei leerer Filterung.
  • Technische Einschränkungen:
    • Daten werden clientseitig geladen (keine serverseitige Suche erforderlich).
  • Nicht-Ziele:
    • Keine erweiterte Suche (z.B. nach E-Mail).

Integration

Dieses Skill kann in jeden unterstützten KI-Codierungsagenten integriert werden. Eine Referenzimplementierung ist im Repository openkash/ai-agent-spec-skill verfügbar.

Verwandte Skills