Github actions and code review

📝 Lernnotizen: CodeReview und Custom CI mit Anthropic

Ziel: Automatisierung repetitiver Aufgaben (z. B. Code-Reviews) in Pull Requests (PRs).

1. Managed Service: CodeReview (Anthropic)

• Funktion: Überprüft PRs über die Cloud GitHub App und postet Ergebnisse als Inline-Kommentare.
• Vorteile: Kein Hosting oder Bau erforderlich; vollständig verwaltet.
• Prozess:
• Ein Satz von Review-Agenten analysiert den Diff gegen die gesamte Codebasis.
• Ergebnisse werden mit Schweregrad und einer Zusammenfassung im Check-Run getaggt.
• Deduplizierung und Rangfolge der Befunde (wenige, relevante Ergebnisse statt Flut von "Nits").
• Einschränkungen:
• Keine automatische Genehmigung oder Blockierung des PRs (Entscheidung bleibt beim Menschen).
• Aktuell nur in Research Preview (Team/Enterprise Pläne).
• Keine verwaltete Auto-Fix-Funktion; Fixes müssen lokal angewendet werden.
• Lokale Anwendung: Befehl /code review --fix im Terminal, um Befunde anzuwenden.

2. Custom CI: Cloud Code GitHub Action

• Funktion: Für Aufgaben, die über das reine Review hinausgehen (z. B. benutzerdefinierte CI, Implementierung von Änderungen aus Kommentaren, Scheduling).
• Einrichtung:
• Muss vom Organisations-Admin in den Cloud Code Admin Settings aktiviert werden.
• Installation der Cloud GitHub App.
• Trigger:
• Auf PR-Pushes (alle oder nur bei Kommentaren).
• Auf PR-Kommentaren (z. B. Triggerphrase at cloud).
• Geplante Jobs (Cron).
• Jedes GitHub-Ereignis.
• **Konfiguration (via cloud. yaml):**
• API Key: Anthropic API Key (erforderlich).
• Trigger Phrase: Was die Aktion in Kommentaren überwacht (Standard: at cloud).
• Prompt: Die spezifische Anweisung für die Ausführung.
• Cloud Arguments: CLI-Argument-String für Feinabstimmung (z. B. max turns auf 5, permission mode auf don't ask, allow tools).
• Setup-Befehl: /install GitHub App (erfordert Repo Admin) führt zur Installation der App und zum Setzen des Anthropic API Key Secrets.

3. Zusammenfassung der Nutzung

• Managed Path (CodeReview): Aktivieren → GitHub App postet Inline-Befunde → Fixes lokal mit /code review --fix anwenden.
• Action Path (Custom CI): GitHub App installieren → Workflow definieren (z. B. für at cloud Mentions oder Cron) → Alle Feinabstimmungen in cloud args konfigurieren.

Takeaways

• Managed Service (CodeReview): Überprüft Pull Requests (PRs) in der Cloud und postet Ergebnisse als Inline-Kommentare; die Anwendung von Fixes erfolgt lokal über den Befehl /code review --fix.
• Custom CI (Cloud Code GitHub Action): Ermöglicht die Automatisierung komplexer, benutzerdefinierter Workflows (z. B. Scheduling, spezifische Trigger) und erfordert eine Konfiguration über die Datei cloud. yaml.
• Nutzungsunterschied: Der Managed Service liefert Feedback, blockiert PRs aber nicht automatisch; die Entscheidung über die Genehmigung bleibt immer beim Menschen.