Tipps für Coding Agents
Dauer: 20 Minuten
- KI-CLI-Tools sinnvoll einsetzen
- Regeln im Repository klar festhalten
- Qualität durch kleine, feste Checks sichern
Ziel: Coding Agents mit hohem Nutzen und wenig Zusatzaufwand im Projekt einsetzen
CLIs: OpenCode, Copilot CLI, Gemini CLI
Für Coding Agents gibt es verschiedene CLI-Werkzeuge, z. B.:
- OpenCode: Hauptseite | Docs
- GitHub Copilot CLI: Hauptseite | Docs
- Gemini CLI: Hauptseite | Docs
Stand Anfang 2026 erleben Agent-CLIs eine große Beliebtheit (“Terminal-Renaissance”) und gelten als wichtige State-of-the-Art-Tools. Der Agent-Mode bietet dabei teilweise mehr Möglichkeiten als die klassische Copilot-Nutzung direkt in VS Code.
OpenCode kann mit verschiedenen Modell-Providern verbunden werden (inklusive GitHub-Copilot-Subscription als Provider). Gemini CLI kann kostenlos mit API-Key über Google AI Studio genutzt werden.
Wie bei KI-Tools üblich kann sich diese Landschaft schnell ändern, sodass sich der Fokus künftig wieder auf andere Tools verschieben kann.
AGENTS.md als Projektvertrag
Die Datei AGENTS.md legt Regeln für Agenten fest, z. B.:
- Projektstruktur und relevante Dateien,
- Coding-Style und Konventionen,
- notwendige Skripte vor einem Commit,
- Commit-Format und Review-Erwartungen.
Eine allgemeine Referenz zu diesem Format gibt es unter agents.md .
AGENTS.md sollte aktuell bleiben. Bei neuen Konventionen, neuen Skripten
oder geänderten Abläufen die Datei direkt mitpflegen.
Agents können explizit aufgefordert werden, AGENTS.md bei Änderungen
automatisch mit zu aktualisieren.
Start mit OpenCode: /init
Ein pragmatischer Einstieg:
- OpenCode im Projekt starten.
- Im Chat
/initausführen. - Dadurch wird eine erste Version von
AGENTS.mderzeugt. - Diese erste Version danach für euer Projekt erweitern und anpassen.
Commit Messages über AGENTS.md steuern
In AGENTS.md können wir festlegen, wie Coding Agents Commit Messages
aufbauen sollen. So entstehen konsistente Commit Messages im Team.
## Commit Message Rules
- Commit messages must be written in German.
- Commit messages must be shorter than 80 characters.Projekt-Skripte über AGENTS.md steuern
Auch Erwartungen zu Linting, Formatierung und Typecheck können direkt
in AGENTS.md festgelegt werden:
## Lint/Format/Typecheck Expectations
- Run `npm run lint` after changes touching JS/TS files.
- Run `npm run format` or `npm run format:check` before final review.
- Run `npm run typecheck` for changes in `.ts` or TS-adjacent logic.Für die Hintergründe zu diesen Checks siehe Abschnitt Codequalität, insbesondere:
Skills für wiederkehrende Aufgaben
Skills sind wiederverwendbare Arbeitsanweisungen für häufige Aufgaben (z. B. Refactoring, API-Integration, Test-Erstellung, Debugging, Setup-Schritte). Der Nutzen:
- weniger Prompt-Wiederholungen,
- konsistentere Ergebnisse,
- schnelleres Onboarding neuer Teammitglieder.
Eine zentrale Übersicht und Registry für Skills ist skills.sh — dort lassen sich Skills entdecken und für unterstützte Coding Agents installieren.
Ausblick: Fortgeschrittene Themen
- Hooks: Pre-/Post-Command-Hooks für automatische Checks (
lint,test,typecheck) und Policy-Checks.
Ressourcen: Gemini CLI Hooks | Copilot CLI Hooks - Subagents: Aufgabenteilung nach Rollen, z. B.
refactor-agent,test-agent,docs-agent.
Ressourcen: OpenCode Agents | Gemini CLI Subagents - Review-Agent (als Subagent): Separater Agent nur für Risiko-Review (Security, Breaking Changes, fehlende Tests).
Ressourcen: Custom Agents in Copilot - Guardrails/Permissions: Festlegen, welche Befehle ohne Rückfrage erlaubt sind und welche immer Freigabe brauchen.
Ressourcen: OpenCode Permissions | About GitHub Copilot CLI (Permissions) | Responsible use of Copilot CLI - Plan-Mode vs. Execute-Mode: Erst Plan/Dateiauswahl, danach gezielte Änderungen ausführen.
Ressourcen: OpenCode Plan/Build Agent-Modell | Gemini CLI Plan Mode | Copilot CLI Plan Mode - Memory/Project Context: Was zusätzlich zu
AGENTS.mdpersistent gespeichert wird (Konventionen, Spezifikationen, bekannte Fallen).
Ressourcen: AGENTS.md | Copilot Repository Instructions (copilot-instructions.md) | Gemini.md Kontext-Hierarchie - u. v. a. m.: Viele Tools entwickeln sich schnell weiter. Es lohnt sich, die Changelogs und Doku-Updates der eingesetzten Agent-CLIs regelmäßig zu prüfen. Ressourcen: OpenCode Changelog | Gemini CLI Release Notes | Copilot CLI Releases