b9a76d4ca9
Implementiert Session Context Workflow für Cross-Machine Tracking: - WORKLOG.md Template für Projekt-Zustandsdokumentation - Session-Start Hook erweitert: zeigt WORKLOG.md Kontext, Commits, Issues - /session-end Skill: strukturiertes Session-Ende mit Auto-Dokumentation - /session-start Skill: manueller Session-Start mit Planung - /new-project Skill: Projekt-Initialisierung mit Tracking Inspiriert von Boris Cherny's Claude Code Tipps: - Learnings dokumentieren für Fehler/Erkenntnisse - Verification Loops in Skills - Separate Checkouts für parallele Sessions Tea CLI (Gitea) separat installiert in ~/.local/bin Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
127 lines
2.7 KiB
Markdown
127 lines
2.7 KiB
Markdown
---
|
|
name: session-start
|
|
description: Use when explicitly starting a work session - shows project context, Gitea issues, and helps decide what to work on
|
|
---
|
|
|
|
# Skill: Session Start
|
|
|
|
Expliziter Session-Start mit Kontext-Laden und Arbeitsplanung.
|
|
|
|
## Wann verwenden
|
|
|
|
- Beim manuellen Start einer Arbeitssession
|
|
- Wenn der automatische Hook nicht ausreicht
|
|
- Um bewusst in den "Arbeitsmodus" zu wechseln
|
|
|
|
## Workflow
|
|
|
|
### 1. Projekt-Kontext laden
|
|
|
|
```bash
|
|
# WORKLOG.md lesen falls vorhanden
|
|
if [[ -f "WORKLOG.md" ]]; then
|
|
cat WORKLOG.md
|
|
fi
|
|
|
|
# copilot-instructions.md lesen falls vorhanden
|
|
if [[ -f "copilot-instructions.md" ]]; then
|
|
cat copilot-instructions.md
|
|
fi
|
|
```
|
|
|
|
### 2. Git-Status anzeigen
|
|
|
|
```bash
|
|
# Aktueller Branch
|
|
git branch --show-current
|
|
|
|
# Uncommitted changes
|
|
git status --short
|
|
|
|
# Letzte Commits
|
|
git log --oneline -5
|
|
|
|
# Stashes (falls vorhanden)
|
|
git stash list
|
|
```
|
|
|
|
### 3. Gitea Issues laden
|
|
|
|
```bash
|
|
# Offene Issues für dieses Repo
|
|
tea issues --state open --limit 10
|
|
|
|
# Mir zugewiesene Issues
|
|
tea issues --state open --assignee @me --limit 5
|
|
```
|
|
|
|
### 4. Kontext-Zusammenfassung präsentieren
|
|
|
|
Zeige dem Benutzer:
|
|
|
|
```
|
|
=== SESSION START: [Projektname] ===
|
|
|
|
📍 Letzte Session: [Datum] auf [Hostname]
|
|
🔀 Branch: [branch]
|
|
📋 Status: [aus WORKLOG.md]
|
|
|
|
📝 Nächste Schritte (aus WORKLOG):
|
|
- [ ] Schritt 1
|
|
- [ ] Schritt 2
|
|
|
|
💡 Learnings zu beachten:
|
|
- [Learning 1]
|
|
- [Learning 2]
|
|
|
|
🎫 Offene Issues:
|
|
#12 - MQTT Integration (in progress)
|
|
#15 - Dashboard hinzufügen
|
|
|
|
❓ Woran möchtest du heute arbeiten?
|
|
```
|
|
|
|
### 5. Arbeitsauswahl
|
|
|
|
Frage den Benutzer:
|
|
- "Woran möchtest du arbeiten?"
|
|
- Optionen: Next Steps aus WORKLOG, Issues, oder etwas Neues
|
|
|
|
### 6. WORKLOG.md aktualisieren
|
|
|
|
Aktualisiere Current State:
|
|
```markdown
|
|
**Zuletzt:** [HEUTE] auf `[HOSTNAME]`
|
|
**Status:** Gestartet - [gewählte Aufgabe]
|
|
```
|
|
|
|
Commit ist NICHT nötig bei Session-Start (nur bei Session-End).
|
|
|
|
## Checkliste
|
|
|
|
- [ ] WORKLOG.md gelesen und verstanden
|
|
- [ ] Git-Status geprüft
|
|
- [ ] Gitea Issues geladen (falls verfügbar)
|
|
- [ ] Kontext-Zusammenfassung präsentiert
|
|
- [ ] Benutzer hat Arbeitsrichtung gewählt
|
|
- [ ] Current State in WORKLOG.md aktualisiert
|
|
|
|
## Hinweise für Claude
|
|
|
|
- **Plan Mode aktivieren** nach Session-Start für strukturierte Arbeit
|
|
- Learnings aus WORKLOG.md beachten und anwenden
|
|
- Bei Unklarheiten auf vorherige Session History verweisen
|
|
- Hostname: `hostname`
|
|
- Datum: `date +%Y-%m-%d`
|
|
|
|
## Integration mit Hooks
|
|
|
|
Der automatische Hook (`session-start.sh`) zeigt bereits Basis-Kontext.
|
|
Dieser Skill geht tiefer und ermöglicht interaktive Planung.
|
|
|
|
Workflow-Kombination:
|
|
1. Claude starten → Hook zeigt Kontext automatisch
|
|
2. `/session-start` → Detaillierte Planung wenn gewünscht
|
|
3. Arbeiten...
|
|
4. `/session-end` → Alles dokumentieren
|