Compétences cc-skill-project-guidelines-example
📦

cc-skill-project-guidelines-example

Sûr

Entwicklung von Full-Stack-KI-Anwendungen mit Projektrichtlinien

Entwickler haben Schwierigkeiten, konsistente Muster über Full-Stack-Projekte hinweg beizubehalten. Diese Skill bietet sofort einsatzbereite Architekturdigramme, Code-Muster und Deployment-Workflows für Next.js- und FastAPI-Anwendungen mit Claude AI-Integration.

Prend en charge: Claude Codex Code(CC)
🥉 74 Bronze
1

Télécharger le ZIP du skill

2

Importer dans Claude

Allez dans Paramètres → Capacités → Skills → Importer un skill

3

Activez et commencez à utiliser

Tester

Utilisation de "cc-skill-project-guidelines-example". Wie sollte ich API-Antworten in unserem FastAPI-Backend strukturieren?

Résultat attendu:

Verwenden Sie das generische ApiResponse-Muster mit success-, data- und error-Feldern. Erstellen Sie ein Pydantic-Modell mit Klassenmethoden ok() für Erfolgsantworten und fail() für Fehlerantworten. Dies gewährleistet konsistente Antwortbehandlung über alle Endpunkte hinweg.

Utilisation de "cc-skill-project-guidelines-example". Welchen Testansatz sollte ich für React-Komponenten verwenden?

Résultat attendu:

Befolgen Sie React Testing Library-Muster: Rendern Sie Komponenten, fragen Sie Elemente nach Rolle ab und testen Sie Benutzerinteraktionen mit fireEvent. Umschließen Sie asynchrone Zustandstests mit await screen.findBy-Mustern. Halten Sie ein Minimum von 80% Abdeckung ein.

Audit de sécurité

Sûr
v1 • 2/25/2026

This skill is a documentation-only resource containing project guidelines and code examples. All 47 static analyzer findings are false positives resulting from Markdown code fences being misinterpreted as shell commands. The file contains no executable code, no actual network calls, and no credential access - only documentation of best practices for a full-stack application.

1
Fichiers analysés
355
Lignes analysées
0
résultats
1
Total des audits
Aucun problème de sécurité trouvé
Audité par: claude

Score de qualité

38
Architecture
100
Maintenabilité
87
Contenu
50
Communauté
100
Sécurité
91
Conformité aux spécifications

Ce que vous pouvez construire

Onboarding neuer Teammitglieder

Verwenden Sie diese Skill, um Entwickler schnell mit Projektarchitektur, Code-Mustern und Deployment-Workflows vertraut zu machen.

Code-Reviews standardisieren

Referenzieren Sie die dokumentierten Muster und kritischen Regeln während Code-Reviews, um Konsistenz über die Codebase hinweg sicherzustellen.

Neue Projekt-Instanzen einrichten

Klonen Sie die dokumentierte Struktur und Muster beim Erstellen neuer Projekte mit ähnlicher Full-Stack-Architektur.

Essayez ces prompts

Projektarchitektur überprüfen
Erklären Sie basierend auf den Projektrichtlinien die Architektur für unsere Next.js- und FastAPI-Anwendung. Fügen Sie das Service-Diagramm hinzu und erklären Sie, wie Claude AI mit dem Backend integriert wird.
API-Antwortmuster generieren
Erstellen Sie unter Verwendung des dokumentierten API-Antwortformats aus den Richtlinien ein Pydantic-Modell für einen Benutzerprofil-Endpunkt, das success-, data- und error-Felder zurückgibt.
Test-Struktur einrichten
Generieren Sie nach den Testanforderungen in den Richtlinien pytest-Test-Fixtures und einen Beispieltest für den Health-Check-Endpunkt in unserem FastAPI-Backend.
Deployment-Checkliste erstellen
Überprüfen Sie die Deployment-Workflow-Richtlinien und generieren Sie eine Pre-Deployment-Checkliste für unser nächstes Cloud Run-Release. Fügen Sie alle erforderlichen Umgebungsvariablen und Build-Schritte hinzu.

Bonnes pratiques

  • Schreiben Sie Tests vor der Implementierung nach TDD-Methodik mit mindestens 80% Abdeckung
  • Wahren Sie Unveränderlichkeit - mutieren Sie niemals Objekte oder Arrays direkt in TypeScript- oder Python-Code
  • Halten Sie Dateien klein mit typisch 200-400 Zeilen und maximal 800 Zeilen für Wartbarkeit

Éviter

  • Verwendung von console.log in Production-Code - verwenden Sie stattdessen richtige Logging-Frameworks
  • Hardcoden von Secrets oder Anmeldeinformationen in Quelldateien - verwenden Sie immer Umgebungsvariablen
  • Überspringen der Eingabevalidierung - validieren Sie immer mit Pydantic für Python oder Zod für TypeScript

Foire aux questions

Welchen Tech-Stack verwendet dieses Projekt?
Frontend: Next.js 15 mit App Router, TypeScript und TailwindCSS. Backend: FastAPI mit Python 3.11 und Pydantic. Datenbank: Supabase PostgreSQL. KI: Claude API mit Tool Calling. Deployment: Google Cloud Run.
Wie führe ich Tests für dieses Projekt aus?
Backend: Verwenden Sie 'poetry run pytest tests/' mit optionalen Coverage-Flags. Frontend: Verwenden Sie 'npm run test' für Unit-Tests und 'npm run test:e2e' für Playwright-End-to-End-Tests.
Welche kritischen Kodierungsregeln muss ich befolgen?
Keine Emojis im Code, Unveränderlichkeit wahren, TDD mit mindestens 80% Abdeckung befolgen, Dateien unter 800 Zeilen halten, kein console.log in Production, try/catch für Fehlerbehandlung verwenden und alle Eingaben mit Pydantic oder Zod validieren.
Wie deploye ich diese Anwendung?
Bauen Sie das Frontend mit 'npm run build' und deployen Sie es dann mit 'gcloud run deploy frontend --source'. Bauen und deployen Sie das Backend mit 'gcloud run deploy backend --source'. Stellen Sie sicher, dass alle Tests bestehen und keine hardcodierten Secrets vorhanden sind, bevor Sie deployen.
Welche Umgebungsvariablen sind erforderlich?
Frontend benötigt NEXT_PUBLIC_API_URL, NEXT_PUBLIC_SUPABASE_URL und NEXT_PUBLIC_SUPABASE_ANON_KEY. Backend benötigt DATABASE_URL, ANTHROPIC_API_KEY, SUPABASE_URL und SUPABASE_KEY. Committen Sie diese Werte niemals zur Versionskontrolle.
Wie ist Claude AI in das Backend integriert?
Das Backend verwendet das Anthropic Python SDK mit strukturierter Ausgabe via Tool Calling. Definieren Sie Pydantic-Modelle für erwartete Ausgabe-Schemas, verwenden Sie dann client.messages.create mit tool_choice, um strukturierte Antworten zu erzwingen, die direkt geparst werden können.

Détails du développeur

Structure de fichiers

📄 SKILL.md