Al0olo/Agents-village

In diesem Repository Branches erstellen, Commits schreiben und Pull Requests öffnen. Verwende dies beim Erstellen eines Branches, Verfassen einer Commit-Nachricht, Pushen, Öffnen oder Aktualisieren eines PRs oder wenn CI auf einem PR fehlschlägt.

Was ist Agents-village?

Diese Fähigkeit definiert einen standardisierten Git- und PR-Workflow für das Repository `Al0olo/agents-village`. Sie ist für KI-Agenten gedacht, die Codeänderungen vornehmen, und stellt sicher, dass Branches konsistent benannt werden (z. B. `S<n>/<bereich>/<slug>` für Sprint-Tickets, andernfalls `fix/`, `docs/` oder `chore/`), Commits mit Co-Authored-By- und Typpräfixen strukturiert werden und über die GitHub-API Pull Requests erstellt werden, da GraphQL in Cloud-Umgebungen blockiert ist. Die Fähigkeit behandelt auch den CI-Fehlerbehebungs-Workflow: Bei fehlschlagenden CI-Tests soll der Agent die Logs lesen, im selben Branch reparieren und erneut pushen – niemals auf `main` committen oder Force-Push auf gemeinsame Branches durchführen. Dadurch wird sichergestellt, dass der Entwicklungsprozess nachvollziehbar, qualitätsgesichert und für die Zusammenarbeit optimiert ist.

Funktioniert mit✓Claude Code~Codex CLI~Cursor

npx skills add https://github.com/Al0olo/Agents-village/tree/HEAD/.claude/skills/git-pr-workflow

Dokumentation

Git- und PR-Workflow

Synchronisieren: git fetch origin main && git checkout main && git reset --hard FETCH_HEAD (Der Klon kann flach sein; origin/main kann fehlschlagen).
Branch: git checkout -b S<n>/<bereich>/<slug> für ein Sprint-Ticket (siehe docs/sprints/), ansonsten fix/, docs/ oder chore/ plus einem Slug.
Arbeite in kleinen Commits. Vor jedem: siehe AGENTS.md Befehle.
Aktualisiere docs/HANDOFF.md im selben PR (Fähigkeit handoff).
Commit-Nachricht:

typ(bereich): imperative Zusammenfassung

Warum diese Änderung, in ein bis zwei Sätzen.

Co-Authored-By: Abdullah Farag <[email protected]>
Co-Authored-By: <Ihr Modellname> <[email protected]>

Pushen: git push -u origin <branch>.
Öffne den PR mit der REST-API (GraphQL ist in Cloud-Sitzungen blockiert):

gh api repos/al0olo/agents-village/pulls \
  -f title="typ: Zusammenfassung" -f head=<branch> -f base=main -F body=@/tmp/pr.md --jq '.html_url'

Body: was geändert wurde, warum, was du zur Überprüfung ausgeführt hast und was der Reviewer entscheiden muss. 8. Wenn CI fehlschlägt, lies das Log, behebe den Fehler im selben Branch und pushe erneut. Nicht rot mergen. 9. Merge-Reihenfolge: Wenn PRs voneinander abhängen, gib dies im Body an und merge in der richtigen Reihenfolge.

Niemals auf main committen, niemals Force-Push auf gemeinsame Branches ausführen, niemals Hooks überspringen.

Al0olo/Agents-village

Was ist Agents-village?

In Ihrer bevorzugten KI fragen

Dokumentation

Git- und PR-Workflow

Individual skills in this repo