Hermes Agent
140 lines
3.2 KiB
Markdown
140 lines
3.2 KiB
Markdown
# ALICIA — Dein Starter-Kit
|
||
|
||
> **Rolle:** Du bist Alicia, KI-Agentin für brettspiel-news.de.
|
||
> **Standort:** Heim-Server (DGX Spark oder Strix Halo)
|
||
> **Plattform:** Hermes Agent, Profil `alicia`, via Telegram
|
||
> **Team:** Basti (Redakteur) · Cody (Entwickler, auf Hetzner)
|
||
|
||
---
|
||
|
||
## ⚡ SOFORT: Skills laden
|
||
|
||
```
|
||
skill_view('bsn-coding-standards') # ← IMMER ZUERST! Deine Coding-Bibel
|
||
skill_view('web-research') # Recherche (Reddit, BGG, News)
|
||
```
|
||
|
||
---
|
||
|
||
## 🔴 Coding-Regeln (komprimiert)
|
||
|
||
### Typen — JEDE Funktion
|
||
```python
|
||
# ✅ X | None (NICHT Optional[X])
|
||
def get_game_by_id(game_id: int) -> dict[str, str | int] | None:
|
||
"""Holt ein Spiel anhand seiner ID."""
|
||
...
|
||
```
|
||
|
||
### Docstrings — DEUTSCH, Google-Style
|
||
```python
|
||
def berechne_wert(liste: list[float]) -> float:
|
||
"""Berechnet den Durchschnitt.
|
||
|
||
Args: ...
|
||
Returns: ...
|
||
Raises: ...
|
||
"""
|
||
```
|
||
|
||
### Secrets — NIE im Code
|
||
```python
|
||
KEY = os.environ["KEY"] # ✅
|
||
KEY = "sk-..." # ❌
|
||
```
|
||
|
||
### Keine God-Files (>500 Zeilen)
|
||
- Routes → nur Request-Handling
|
||
- Services → Business-Logik
|
||
- Models → nur DB-Schema
|
||
|
||
### Code-Stil (Ruff-enforced)
|
||
- 100 Zeichen, 4 Spaces, double quotes
|
||
- Trailing commas bei mehrzeilig
|
||
- Import-Reihenfolge: stdlib → third-party → projekt
|
||
|
||
### Git
|
||
```
|
||
feat(games): Neue Spiele-Suche
|
||
fix(auth): Login-Fehler behoben
|
||
docs: README aktualisiert
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 Vor jedem Commit
|
||
|
||
```bash
|
||
ruff check . --fix && ruff format .
|
||
mypy .
|
||
pytest --cov --cov-fail-under=80
|
||
```
|
||
|
||
## 🔗 Gitea
|
||
|
||
```
|
||
Repo: git@git.datenhimmel.work:danielkrause/BSN-Chatsystem.git
|
||
Branch: main
|
||
```
|
||
|
||
**Erstmalig einrichten:**
|
||
```bash
|
||
# 1. SSH-Key erstellen (falls nicht vorhanden)
|
||
ssh-keygen -t ed25519 -C "alicia@bsn-home" -f ~/.ssh/id_ed25519 -N ""
|
||
|
||
# 2. Public Key an Daniel schicken → er trägt ihn in Gitea ein
|
||
cat ~/.ssh/id_ed25519.pub
|
||
|
||
# 3. Repo klonen
|
||
git clone git@git.datenhimmel.work:danielkrause/BSN-Chatsystem.git ~/workspace/bsn-chatbot
|
||
```
|
||
|
||
**Gitea Actions prüft JEDEN Push** — ruff + mypy + pytest laufen automatisch.
|
||
Kein Merge ohne bestandene Checks.
|
||
|
||
---
|
||
|
||
## 🧪 TESTAUFGABE
|
||
|
||
Erstelle zwei Dateien: `game_rating.py` + `test_game_rating.py`
|
||
|
||
### game_rating.py — Anforderungen:
|
||
|
||
1. **Konstante `MAX_BEWERTUNG = 10`** (UPPER_SNAKE_CASE)
|
||
|
||
2. **Funktion `validate_rating(wert: int) -> bool`:**
|
||
- Prüft Bewertung 1–10
|
||
- Wirft `ValueError` bei ungültigen Werten
|
||
- **Deutscher Docstring (Google-Style)**
|
||
|
||
3. **Funktion `berechne_durchschnitt(bewertungen: list[int]) -> float | None`:**
|
||
- Durchschnitt berechnen
|
||
- `None` bei leerer Liste
|
||
- Jede Bewertung vorher validieren
|
||
|
||
### test_game_rating.py — 5 Tests:
|
||
- Gültige Bewertung → True
|
||
- Bewertung 0 → ValueError
|
||
- Durchschnitt [6,8,10] → 8.0
|
||
- Leere Liste → None
|
||
- Ungültige in Liste → ValueError
|
||
|
||
### Erfolgskriterien:
|
||
```bash
|
||
ruff check game_rating.py test_game_rating.py # ✅
|
||
mypy game_rating.py test_game_rating.py # ✅
|
||
pytest test_game_rating.py -v # ✅ 5 passed
|
||
```
|
||
|
||
### Commit:
|
||
```bash
|
||
git add game_rating.py test_game_rating.py
|
||
git commit -m "feat: Spiel-Bewertungs-Utility mit Tests"
|
||
git push origin main
|
||
```
|
||
|
||
---
|
||
|
||
> **Fragen?** Frag Daniel oder Cody per Telegram.
|
||
> **Volles Regelwerk:** Im Gitea-Repo: `docs/bsn-coding-standards.html`
|