CommunitySchreiben & Editierengithub.com

giostriquer/agent-workshop

Bereitgestelltes Grundgerüst für Agents, Skills und Konventionen zur spezifikationsgetriebenen Entwicklung mit Claude Code, Codex und ähnlichen CLIs.

Was ist agent-workshop?

Dieses Skill-Paket dient als direkt einsetzbares Gerüst für die Entwicklung mit KI-Agenten wie Claude Code, Codex oder anderen kommandozeilenbasierten Werkzeugen. Es definiert klare Konventionen für die spezifikationsgetriebene Entwicklung, sodass Teams oder einzelne Entwickler schnell konsistente und wiederverwendbare Skills für ihre Projekte erstellen können. Die enthaltenen Skills, wie beispielsweise das Push-Skill, automatisieren wiederkehrende Git-Abläufe wie das Erkennen des aktuellen Branches, das Ziehen der neuesten Änderungen und das Durchführen von Commits mit standardisierten Nachrichtenformaten. Dies reduziert manuelle Schritte und stellt sicher, dass alle Commits den Projektkonventionen entsprechen, indem beispielsweise Trailer wie `Co-Authored-By:` automatisch angehängt werden. Der Fokus liegt auf Robustheit: Fehler werden klar gemeldet, und es werden keine erzwungenen Push-Operationen oder Umgehungen von Überprüfungen durchgeführt.

Funktioniert mit✓Claude Code✓Codex CLI~Cursor
npx skills add giostriquer/agent-workshop

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

Push

Änderungen committen und auf den aktuellen Branch pushen.

Dieses Skill ist nicht auf einen bestimmten Branch beschränkt – es arbeitet immer auf dem aktuell ausgecheckten Branch. Passen Sie die Trailer-Zeile in Schritt 8 unten an die Commit-Zuschreibungskonvention Ihres Projekts an.

Schnellstart

  1. Den aktuellen Branch mit git branch --show-current ermitteln.
  2. Wenn kein aktueller Branch-Name vorhanden ist, abbrechen und den Fehler melden.
  3. Die neueste Version von origin/<current-branch> mit git pull --ff-only origin <current-branch> ziehen. Falls dies fehlschlägt, abbrechen und den Fehler melden.
  4. Den Diff vor dem Staging inspizieren.
  5. Bei Relevanz den neuesten aussagekräftigen Eintrag in docs/change-log.md als Quelle für die Commit-Nachricht bevorzugen.
  6. Wenn kein Change-Log-Eintrag die tatsächliche Quelle der Änderung ist, die Nachricht aus dem primär geänderten Bereich im Diff ableiten.
  7. Alle Änderungen mit git add -A stagen.
  8. Mit einer mehrzeiligen Nachricht committen und den projektspezifischen Standard-Trailer anhängen (normalerweise eine Co-Authored-By:-Zeile oder eine ähnliche Zuschreibung; projektspezifisch).
  9. Mit git push origin <current-branch> pushen.
  10. Branch, Commit-Hash und Betreff in einem Satz melden.

Hinweise zur Commit-Nachricht

Verwenden Sie einen prägnanten Betreff im konventionellen Stil, z. B.:

  • docs: für Dokumentation oder Routing-Änderungen
  • feat: für neue Fähigkeiten, Systeme oder Inhalte
  • fix: für Verhaltenskorrekturen
  • refactor: für strukturelle Änderungen ohne wesentliche Verhaltensänderung
  • test: für sinnvolle Erweiterungen oder Überarbeitungen der Testabdeckung
  • chore: für Wartungsarbeiten, die nicht besser in eine andere Kategorie passen

Für den Textkörper:

  • die wichtigsten geänderten Bereiche zusammenfassen
  • pro wesentliche Änderung eine Zeile bevorzugen
  • am tatsächlichen Diff orientiert bleiben

Wenn docs/change-log.md als Quelle verwendet wird:

  • den neuesten aussagekräftigen Abschnitt oder Eintrag bevorzugen, der die zentrale Änderung tatsächlich beschreibt
  • keine aus dem Change-Log abgeleitete Nachricht erzwingen, wenn das Change-Log-Update nebensächlich ist

Wenn das Change-Log nicht als Quelle verwendet wird:

  • den Betreff aus dem wichtigsten geänderten Bereich im Diff ableiten
  • wenn der Diff zu mehrdeutig für eine sichere Zusammenfassung ist, den Benutzer stattdessen nach der Commit-Nachricht fragen

Regeln

  • Immer den aktuell ausgecheckten Branch verwenden.
  • Niemals --force oder --force-with-lease verwenden.
  • Niemals --no-verify verwenden.
  • Laut scheitern: Wenn ein Schritt fehlschlägt, abbrechen und den Fehler melden.

Verwandte Skills