From 1b1554313f8b304b6b3acfd29ec5fe995c5f32c5 Mon Sep 17 00:00:00 2001 From: martin Date: Sun, 22 Feb 2026 12:13:00 +0100 Subject: [PATCH] update naming --- skills/init-project/SKILL.md | 97 +++++++++++++++++++++++++++--------- 1 file changed, 73 insertions(+), 24 deletions(-) diff --git a/skills/init-project/SKILL.md b/skills/init-project/SKILL.md index 3affbda..dd31d3b 100644 --- a/skills/init-project/SKILL.md +++ b/skills/init-project/SKILL.md @@ -1,6 +1,6 @@ --- name: init-project -description: Initialisiert die .claude/ Projektstruktur mit code-reviewer Agent, create-todo und code-review-todo Skills, sowie code-review/ und todos/ Ordnern. Analysiert den Tech-Stack automatisch. +description: Initialisiert die .claude/ Projektstruktur mit project-code-reviewer Agent, project-todo und project-review-todo Skills, sowie code-review/ und todos/ Ordnern. Analysiert den Tech-Stack automatisch. argument-hint: "[optional: pfad zum projekt]" allowed-tools: Read, Write, Edit, Glob, Grep, Bash, WebSearch --- @@ -19,16 +19,18 @@ Erstellt eine vollstaendige `.claude/`-Struktur fuer jedes Projekt. Analysiert a ``` .claude/ -├── agents/code-reviewer.md # Projektspezifischer Code-Review Agent -├── code-review/ # Code-Review Findings (P0-P4) +├── agents/project-code-reviewer.md # Projektspezifischer Code-Review Agent +├── code-review/ # Code-Review Findings (P0-P4) │ └── .gitkeep -├── todos/ # Feature-Todos, Bugfixes, Verbesserungen +├── todos/ # Feature-Todos, Bugfixes, Verbesserungen │ └── .gitkeep └── skills/ - ├── create-todo/SKILL.md # Erstellt Todos im .claude/todos/ Ordner - └── code-review-todo/SKILL.md # Erstellt Review-Findings im .claude/code-review/ Ordner + ├── project-todo/SKILL.md # Erstellt Todos im .claude/todos/ Ordner + └── project-review-todo/SKILL.md # Erstellt Review-Findings im .claude/code-review/ Ordner ``` +**Namenskonvention:** `project-*` Prefix vermeidet Kollisionen mit globalen Claude-Skills/Agents (`create-todo`, `code-review-todo`, `code-reviewer`). + ## Workflow ### Schritt 1: Projekt analysieren @@ -75,17 +77,17 @@ find .claude -type f 2>/dev/null | sort ### Schritt 3: Verzeichnisse anlegen ```bash -mkdir -p .claude/{agents,code-review,todos,skills/create-todo,skills/code-review-todo} +mkdir -p .claude/{agents,code-review,todos,skills/project-todo,skills/project-review-todo} touch .claude/code-review/.gitkeep .claude/todos/.gitkeep ``` ### Schritt 4: Code-Reviewer Agent erstellen -Erstelle `.claude/agents/code-reviewer.md` mit diesem Geruest. **Passe den Inhalt vollstaendig an den erkannten Tech-Stack an:** +Erstelle `.claude/agents/project-code-reviewer.md` mit diesem Geruest. **Passe den Inhalt vollstaendig an den erkannten Tech-Stack an:** ~~~markdown --- -name: code-reviewer +name: project-code-reviewer description: > Projektspezifischer Code-Review Agent fuer [PROJEKTNAME]. Analysiert Code auf Security, Performance, Architektur und Best Practices. @@ -192,13 +194,13 @@ Beispiel: `P1-performance-n-plus-1-scenario-list.md` 9. **Web-Recherche nutzen** - aktuelle Docs verifizieren. ~~~ -### Schritt 5: Create-Todo Skill erstellen +### Schritt 5: Project-Todo Skill erstellen -Erstelle `.claude/skills/create-todo/SKILL.md`: +Erstelle `.claude/skills/project-todo/SKILL.md`: ~~~markdown --- -name: create-todo +name: project-todo description: Erstellt Todo-Dateien im .claude/todos/-Ordner. Kennt [TECH-STACK STICHWORTE]. Fuer Feature-Requests, Bugfixes und Verbesserungen. argument-hint: allowed-tools: Read, Write, Edit, Glob, Grep @@ -231,7 +233,7 @@ Erstelle eine Datei in `.claude/todos/`: # [Kurzer, praegnanter Titel] **Status:** Offen -**Prioritaet:** Hoch | Mittel | Niedrig +**Prioritaet:** P[0-4] - [Kritisch|Hoch|Wichtig|Mittel|Niedrig] **Bereich:** [GENERIERT: Projekt-spezifische Bereiche] ## Beschreibung @@ -251,7 +253,30 @@ Erstelle eine Datei in `.claude/todos/`: ``` ### Schritt 3: Dateiname waehlen -Format: `kebab-case-beschreibung.md` + +**Format:** `P[0-4]-[typ]-[kebab-case-beschreibung].md` + +**Prioritaet:** + +| Prio | Kriterien | +|------|-----------| +| `P0` | Blockiert Entwicklung, Security-Fix, Datenverlust | +| `P1` | Wichtiges Feature, schwerwiegender Bug | +| `P2` | Verbesserung, mittlerer Bug, technische Schuld | +| `P3` | Nice-to-have, kleine Verbesserung | +| `P4` | Kosmetik, Dokumentation, irgendwann | + +**Typ-Tags:** + +| Tag | Verwendung | +|-----|------------| +| `feature` | Neue Funktionalitaet | +| `bugfix` | Fehlerbehebung | +| `enhancement` | Verbesserung bestehender Features | +| `refactor` | Code-Umstrukturierung ohne Funktionsaenderung | +| `infra` | Build, CI/CD, Deployment, Dependencies | +| `test` | Tests hinzufuegen oder verbessern | +| `docs` | Dokumentation | ## Haeufige Bereiche [GENERIERT: Die 4-6 wichtigsten Bereiche mit Dateipfaden] @@ -263,13 +288,13 @@ Format: `kebab-case-beschreibung.md` 4. **Keine Implementierung** - Nur beschreiben WAS, nicht WIE ~~~ -### Schritt 6: Code-Review-Todo Skill erstellen +### Schritt 6: Project-Review-Todo Skill erstellen -Erstelle `.claude/skills/code-review-todo/SKILL.md`: +Erstelle `.claude/skills/project-review-todo/SKILL.md`: ~~~markdown --- -name: code-review-todo +name: project-review-todo description: Erstellt Code-Review Todo-Dateien mit Problemanalyse, Impact-Bewertung und Best-Practice-Empfehlungen. Fuer Security, Performance und Architektur-Findings. argument-hint: "[problembeschreibung oder dateipfad]" allowed-tools: Read, Glob, Grep, Write, Edit, Bash, WebSearch @@ -356,7 +381,31 @@ Thematische Tags: `security`, `auth`, `performance`, `architecture`, `error-hand 5. **Sprache: Deutsch** ~~~ -### Schritt 7: Zusammenfassung ausgeben +### Schritt 7: .gitignore aktualisieren + +Fuege folgende Regeln zur `.gitignore` des Projekts hinzu (falls nicht bereits vorhanden). +Falls keine Root-`.gitignore` existiert, erstelle sie. + +```gitignore +### Claude Code ### +.claude/* +!.claude/agents/ +.claude/agents/* +!.claude/agents/project-code-reviewer.md +!.claude/skills/ +!.claude/code-review/ +!.claude/todos/ +``` + +**Logik:** +- `.claude/*` → alles ignorieren (settings, memory, docs, sonstige lokale Dateien) +- `!.claude/agents/` + `.claude/agents/*` → Ordner erlauben, Inhalt ignorieren... +- `!.claude/agents/project-code-reviewer.md` → **Ausnahme**: der Code-Reviewer soll allen Entwicklern zur Verfuegung stehen +- `!.claude/skills/` → **tracked**: definiert Team-Konventionen +- `!.claude/code-review/` → **tracked**: Team-Roadmap fuer Code-Qualitaet +- `!.claude/todos/` → **tracked**: Feature-Backlog + +### Schritt 8: Zusammenfassung ausgeben Zeige dem User was erstellt wurde: @@ -364,12 +413,12 @@ Zeige dem User was erstellt wurde: Projektstruktur initialisiert fuer [PROJEKTNAME]: .claude/ -├── agents/code-reviewer.md # [TECH-STACK Stichworte] -├── code-review/ # Review-Findings -├── todos/ # Feature-Todos +├── agents/project-code-reviewer.md # [TECH-STACK Stichworte] +├── code-review/ # Review-Findings +├── todos/ # Feature-Todos └── skills/ - ├── create-todo/SKILL.md # → .claude/todos/ - └── code-review-todo/SKILL.md # → .claude/code-review/ + ├── project-todo/SKILL.md # → .claude/todos/ + └── project-review-todo/SKILL.md # → .claude/code-review/ Erkannter Stack: [FRAMEWORK VERSION, SPRACHE VERSION, ...] ``` @@ -381,5 +430,5 @@ Erkannter Stack: [FRAMEWORK VERSION, SPRACHE VERSION, ...] 3. **Projektsprache** - Wenn CLAUDE.md oder README auf Deutsch ist, alle generierten Inhalte auf Deutsch. 4. **Minimal aber vollstaendig** - Keine Checklisten-Punkte fuer Technologien die im Projekt nicht vorkommen. 5. **Code-Beispiele anpassen** - Template-Snippets in der Projektsprache (Python, TypeScript, Rust, Go, etc.). -6. **Bereiche aus dem Projekt** - Die "Haeufige Bereiche" Sektion im create-todo Skill muss die tatsaechlichen Verzeichnisse des Projekts abbilden, nicht generische Platzhalter. +6. **Bereiche aus dem Projekt** - Die "Haeufige Bereiche" Sektion im project-todo Skill muss die tatsaechlichen Verzeichnisse des Projekts abbilden, nicht generische Platzhalter. 7. **Check-Commands** - Akzeptanzkriterien muessen den tatsaechlichen Test/Lint-Command des Projekts verwenden (`npm run check`, `python manage.py test`, `cargo test`, `make test`, etc.).