heydeer
Best Practices

Teams ohne Codeprüfung

Nutze dieses Setup, wenn Änderungen auf main landen, ohne dass jemand sie liest, etwa wenn Agenten direkt auf main committen oder Pull Requests gemergt werden, sobald die CI erfolgreich durchläuft. HeyDeer prüft jeden Push, und GitHub mergt den Pull Request, sobald HeyDeer ihn genehmigt.

Empfohlenes Setup

Ein Agent öffnet einen Pull Request
HeyDeer prüft jeden Push
Der Check besteht und HeyDeer genehmigt
GitHub mergt den Pull Request
Meldet HeyDeer Befunde, schlägt der Check fehl und nichts wird gemergt. Der Agent pusht eine Korrektur, und HeyDeer prüft die neuen Commits.
  1. Lass Agenten für jede Änderung in einen Branch pushen und einen Pull Request öffnen, statt direkt auf main zu committen.
  2. Wähle unter Arbeitsbereichseinstellungen → Prüfregeln → Wann prüfen die Option Bei jedem Push. Siehe Automatische Prüfungen.
  3. Aktiviere unter Ergebnisse veröffentlichen die Option Check bei gefundenen Problemen fehlschlagen lassen. Siehe Der Check HeyDeer Review.
  4. Aktiviere unter Ergebnisse veröffentlichen die Option Automatische Genehmigung. HeyDeer genehmigt dann einen Pull Request, sobald eine vollständige Prüfung keine Befunde mehr ergibt. Siehe Automatische Genehmigung.
  5. Lege fest, wer Änderungen mit hohem Risiko genehmigt. Standardmäßig warten Pull Requests mit hohem Risiko auf eine Person. Damit HeyDeer auch sie genehmigt, setze PRs, die HeyDeer genehmigen darf auf PRs jeder Risikostufe.
  6. Aktiviere in den GitHub-Branch-Regeln für main Require a pull request before merging mit einer erforderlichen Genehmigung. Aktiviere außerdem Dismiss stale pull request approvals when new commits are pushed.
  7. Mach in denselben Regeln neben deinen CI-Checks den Check HeyDeer Review erforderlich.
  8. Aktiviere Allow auto-merge in den GitHub-Einstellungen des Repositorys. Aktiviere dann Auto-Merge für jeden Pull Request, oder lass den Agenten nach dem Öffnen gh pr merge --auto --squash ausführen.
HeyDeer hat diese Änderungen genehmigt
Alle Checks bestanden
HeyDeer Review — Prüfung abgeschlossen – keine Probleme gefunden
CI / test — Erfolgreich
Auto-Merge ist aktiviert: GitHub mergt diesen Pull Request, sobald alle Voraussetzungen erfüllt sind.
Sobald HeyDeer genehmigt und alle erforderlichen Checks bestanden sind, mergt GitHub den Pull Request.

Den Agenten auf Befunde reagieren lassen

HeyDeer veröffentlicht seine Befunde als Prüfung im Pull Request, und der Check HeyDeer Review enthält den vollständigen Bericht. Lass den Agenten nach jedem Push die Prüfung lesen, die Befunde beheben und erneut pushen. HeyDeer prüft dann die neuen Commits.

Um einen Befund abzulehnen, erklärt jemand mit Schreibzugriff die Entscheidung in der Unterhaltung des Befunds oder markiert die Unterhaltung als erledigt und kommentiert dann @heydeer review. Siehe Einen Befund ablehnen.

Wenn HeyDeer die von dir ausgewählten Befunde stattdessen in einem separaten PR beheben soll, wähle in der Prüfung Mit HeyDeer beheben; siehe Mit HeyDeer beheben.

Standards als Repository-Prüfungen festhalten

Agenten erfüllen eine Anforderung zuverlässiger, wenn die Prüfung sie durchsetzt. Lege für jede Anforderung eine Markdown-Datei in .agents/checks/ an, und HeyDeer wendet sie auf jeden Pull Request an, der passende Dateien ändert. Siehe Repository-Prüfungen.

.agents/checks/tenant-scope.md

---
files:
  - "src/db/**/*.ts"
  - "!**/*.test.ts"
---
Every query that reads or writes customer data must be
scoped to one tenant, taken from the request context and
never from request parameters.

Warum eine separate Prüfung hilft

Die CI erkennt nur, was deine Tests abdecken. Ohne Prüfung rutschen zwei Arten von Problemen durch:

  • Das Modell, das den Code geschrieben hat, neigt dazu, seine eigene Argumentation zu akzeptieren und seine eigenen Fehler zu übersehen, selbst wenn du es bittest, seine Arbeit zu überprüfen.
  • Wenn ein Agent denselben Code immer wieder überarbeitet, kann jede Änderung unbemerkt etwas kaputt machen, das eine frühere richtig gemacht hat.

HeyDeer prüft jeden Pull Request getrennt von dem Agenten, der ihn geschrieben hat, und gleicht jeden Befund mit dem Code ab, bevor es ihn veröffentlicht. Bei späteren Pushes prüfen Folgeprüfungen frühere Bedenken erneut.