code-documentation-doc-generate
Code-Dokumentation automatisch generieren
Erstellen Sie umfassende API-Dokumentation, Architekturdiagramme, Benutzerhandbücher und technische Referenzen aus Quellcode mittels KI-gestützter Analyse.
Télécharger le ZIP du skill
Importer dans Claude
Allez dans Paramètres → Capacités → Skills → Importer un skill
Activez et commencez à utiliser
Tester
Utilisation de "code-documentation-doc-generate". Generate API documentation for a FastAPI user service with endpoints for create, read, update, delete users
Résultat attendu:
- API-Dokumentation erstellt mit:
- - OpenAPI 3.0-Spezifikation
- - Benutzer-Endpunkte (/users, /users/{id})
- - Anfrage-/Antwort-Schemata mit Validierung
- - Authentifizierungs- und Autorisierungsabschnitte
- - Beispiel-curl-Befehle für jeden Endpunkt
Utilisation de "code-documentation-doc-generate". Create a README for a Python CLI tool that converts images to PDF
Résultat attendu:
- README generiert mit:
- - Projekttitel und Beschreibung
- - Installationsanleitung (pip, conda)
- - Schnellstartanleitung mit Beispielen
- - Konfigurationsoptionen-Tabelle
- - Lizenz- und Beitragsrichtlinien
Audit de sécurité
SûrAll 91 static findings are false positives triggered by documentation examples in the skill. The skill provides templates and examples for generating documentation. No actual code execution, network calls, or credential access occurs. Risk level: SAFE.
Problèmes à risque faible (1)
Score de qualité
Ce que vous pouvez construire
API-Dokumentation für Webdienste
Automatische Generierung von OpenAPI-Spezifikationen und interaktiver API-Dokumentation aus REST-Endpunktcode
Projekt-README-Generierung
Erstellen Sie umfassende README-Dateien mit Installationsanleitung, Nutzungsbeispielen und Beitragsrichtlinien
Architekturdokumentation
Generieren Sie Systemarchitekturdiagramme und Komponentendokumentation aus der Codestruktur
Essayez ces prompts
Generieren Sie API-Dokumentation für die Endpunkte in diesem Codebase. Beziehen Sie Anfrage-/Antwort-Schemata, Authentifizierungsanforderungen und Beispielanfragen mit ein.
Erstellen Sie eine umfassende README.md für dieses Projekt. Beziehen Sie ein: Projektbeschreibung, Installationsschritte, Nutzungsbeispiele, Konfigurationsoptionen und Beitragsrichtlinien.
Analysieren Sie die Codebase-Struktur und generieren Sie Architekturdokumentation. Beziehen Sie ein: Systembeschreibung, Komponentenbeschreibungen, Datenflüsse und Technologie-Stack-Zusammenfassung.
Richten Sie automatisierte Dokumentationsgenerierung für dieses Projekt ein. Beziehen Sie CI/CD-Konfiguration, Dokumentations-Linting-Regeln und Bereitstellung auf einer Dokumentations-Hosting-Plattform mit ein.
Bonnes pratiques
- Überprüfen Sie immer, ob generierte Dokumentation durch Tests mit dem tatsächlichen Codeverhalten übereinstimmt
- Halten Sie die Dokumentation mittels CI/CD-Automatisierung mit dem Code synchron
- Fügen Sie praktische Codebeispiele bei, die Benutzer kopieren und anpassen können
Éviter
- Dokumentation generieren, ohne sie auf Richtigkeit zu überprüfen
- Sensible Informationen wie API-Schlüssel oder interne URLs in öffentliche Dokumente aufnehmen
- Dokumentation erstellen, die nicht automatisch überprüft oder getestet werden kann