grading-shared

Files (3)

• EMAIL-EXAMPLES.md
• SKILL.md
• aggregate-emails.py

SKILL.md (first lines)

# Grading Shared Configuration

## Purpose

This skill provides centralized configuration for all grading workflows,
ensuring consistent email formatting, address styles, second-person address
throughout all grading content, and database access across different
assessment types.

## Output Language: MANDATORY GERMAN

All student-facing content (grading reports, feedback, email bodies) MUST be 
written in natural German with proper UTF-8 umlauts (ä, ö, ü, ß). 
Never use English for content intended for students.

## Usage

Import this skill at the beginning of any grading-related skill or command.
Reference the sections below for consistent behavior.

## Anrede-Gate (CRITICAL, Pflicht)

Die Anrede (Du/Sie) wird **nicht** aus dem Klassennamen und **nicht** aus der
Datenbank abgeleitet. Sie steht in genau einer Datei pro Kohorte:

```
<subject>-T/<kohorte>/anrede.txt
```

Die Datei enthält genau ein Wort: `Sie` oder `Du`.

Ablauf:

1. `-T`-Repo-Wurzel und Kohorten-Ordner bestimmen (der Lauf-Ordner
   `<kohorte>/<YYYY-MM-DD>_<slug>/` liegt darin; `_class` zeigt auf das
   öffentliche Schwester-Repo).
2. Anrede mit dem mitgelieferten Skript lesen:

   ```bash
   ANREDE=$(~/.opencode/skills/grading-shared/read-anrede.sh \
       "$T_REPO/$KOHORTE/anrede.txt") || exit 1
   ```

3. `Du` → informell, `Sie` → formell. Die Anrede gilt für **alle**
   studentengerichteten Texte (E-Mails, `*_grading.md`, `GRADINGS.md`,
   `CLASS.md`).

**Stop-Regel (CRITICAL):** Fehlt die Datei, ist sie leer oder enthält sie
etwas anderes als `Sie`/`Du`, sofort **STOPPEN** — vor dem ersten Schreibzugriff
— und den Pfad samt Soll-Inhalt auf Deutsch melden:

```
FEHLT: /home/georg/r/GRG-WMC-T/3aaif/anrede.txt
Bitte die Datei anlegen und genau 'Sie' oder 'Du' hineinschreiben.
```

Es gibt **keinen** Fallback auf eine Klassenliste und kein Raten. Das Gate gilt
für `repograde`, `knowledge-assessment`, `knowledge-exam` und `projectgrade`;
es läuft immer vor dem ersten Schreibzugriff eines Laufs.

## Lauf-Umgebung (Grading)

Repositorien-basierte Läufe (`repograde`) starten im Grading-Arbeitsverzeichnis
`~/gits/<kohorte>-<fach>/` (z. B. `~/gits/3aaif-wmc/`). Das ist **kein**
Git-Repo; es enthält:

```
~/gits/3aaif-wmc/_class            -> /home/georg/r/GRG-WMC/3aaif
~/gits/3aaif-wmc/Abazi Hamza       -> Hamza473A        (Namens-Symlink)
~/gits/3aaif-wmc/Hamza473A/        (Schüler-Repo, gelesen)
```

- `_class` zeigt in den öffentlichen Klassenordner des Teaching-Repos. Immer
  mit `readlink -f` auflösen: `~/r` ist selbst ein Symlink auf
  `repos/georgernstgraf/`, und das Ziel kann mit oder ohne Schrägstrich enden.
- Das private Test-Repo ist das **Schwesterverzeichnis** mit Suffix `-T`:
  `/…/GRG-<FACH>/<kohorte>` → `/…/GRG-<FACH>-T`.
- Lauf-Ordner (alle Ausgaben eines Laufs, inkl. `noten.tsv`):
  `<…>-T/<kohorte>/<YYYY-MM-DD>_<slug>/` — bei Bedarf anlegen.
- Anrede-Datei: `<…>-T/<kohorte>/anrede.txt`.
- `roster.tsv` (aus `wu … roster`) ist ein Zwischenprodukt und liegt unter
  `/tmp/opencode/`, nie im Lauf-Ordner und nie im Commit.
- `knowledge-assessment` läuft dagegen direkt im `-T`-Repo; der Lauf-Ordner
  `<kohorte>/<YYYY-MM-DD>_<slug>/` ist dort CWD bzw. wird angelegt.

## Class Configuration

### Name Parsing from Repository Basename (CRITICAL)

Repository directory names follow the convention `Lastname Firstname`. The **last
word** is always the first name; **everything before it** is the last name. This
applies to compound last names as well.

**Parsing rule:** Split the basename on spaces → `parts[0:-1]` = last name,
`parts[-1]` = first name.

| Repository Basename | Last Name | First Name |
|---------------------|-----------|------------|
| `Umlauf Ellen` | Umlauf | Ellen |
| `Quintero Castañeda Nicolas` | Quintero Castañeda | Nicolas |
| `Prodanovic Jovana` | Prodanovic | Jovana |
| `Wahringer Tobias` | Wahringer | Tobias |
| `Leeb Samuel` | Leeb | Samuel |
| `Zore Elsner Marija` | Zore Elsner | Marija |

**Wrong vs Correct — Formal salutation:**
```
❌ Sehr geehrte Frau Ellen,        ← used first name as last name
✅ Sehr geehrte Frau Umlauf,       ← correct last name

❌ Sehr geehrter Herr Nicolas,      ← used first name as last name
✅ Sehr geehrter Herr Quintero Castañeda,  ← correct compound last name

❌ Sehr geehrter Herr Tobias,       ← used first name as last name
✅ Sehr geehrter Herr Wahringer,    ← correct last name
```

**Wrong vs Correct — Informal salutation:**
```

From georgernstgraf/opencode-helpers, MIT.

More from georgernstgraf/opencode-helpers