Einrichten GitHub Spec Kit in Ihrer Umgebung

Abgeschlossen

Bevor Sie GitHub Spec Kit verwenden können, um die spezifikationsgesteuerte Entwicklung zu üben, müssen Sie Ihre Umgebung einrichten. Diese Einheit behandelt die Erforderlichen, den Installationsprozess und die Konfigurationsschritte, um GitHub Spec Kit in Ihrer Entwicklungsumgebung auszuführen.

Voraussetzungen und Systemanforderungen

Stellen Sie vor der Installation GitHub Spec Kit sicher, dass Ihre Entwicklungsumgebung die Anforderungen für Betriebssystem, Softwareabhängigkeiten und KI-Codierungsassistenten erfüllt.

Betriebssystem

Ihre Entwicklungsumgebung muss eines der folgenden Betriebssysteme verwenden:

• Linux oder macOS: Vollständig unterstützt.
• Windows: Vollständig mit PowerShell-Skripts unterstützt.

Erforderliche Software

Ihre Entwicklungsumgebung muss die folgende Software enthalten:

• Python 3.11 oder höher: GitHub Cli des Spec Kit ist ein Python Tool.
• Git: Erforderlich für die Integration der Versionssteuerung und das Abrufen des Toolkits.
• uv tool: GitHub Spec Kit verwendet das Tool uv für die Paketverwaltung. Das tool uv ist ein moderner Paket-Manager, der Tools direkt aus GitHub installieren kann.

KI-Codierungsassistent

Ihre Entwicklungsumgebung muss mindestens einen unterstützten KI-gestützten Codierungsassistenten konfiguriert und in Betrieb haben. GitHub Spec Kit unterstützt:

Agent	Umwelt	Unterstützung für Slash-Befehle
GitHub Copilot	Visual Studio Code	Yes
Claude Code	CLI / IDE	Yes
Mauszeiger	Cursor-IDE	Yes
Windsurf	Windsurf IDE	Yes
Amazon Q Developer CLI	CLI / IDE	Aktivieren
Gemini CLI	Befehlszeilenschnittstelle (CLI)	Yes
Und andere	Verschiedene	Variiert

Die Laborübung in diesem Modul verwendet Visual Studio Code mit GitHub Copilot.

Installieren des UV-Tools

Sie können das uv Tool mit einer der folgenden Methoden installieren:

• Unter macOS und Linux:

  curl -LsSf https://astral.sh/uv/install.sh | sh
  

• On Windows (in PowerShell):

  powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
  

Starten Sie nach der Installation das Terminal neu, um sicherzustellen, dass uv in Ihrem PATH verfügbar ist.

Installieren Sie Specify-CLI

GitHub Spec Kit verwendet das CLI-Tool specify, um Spezifikationen zu verwalten und mit KI-Codierungsassistenten zu interagieren. Es gibt zwei Hauptmöglichkeiten zum Installieren des specify CLI-Tools.

Methode 1: Globale Installation (empfohlen)

Der empfohlene Ansatz besteht darin, specify-cli global mit uv zu installieren. Eine globale Installation stellt den specify Befehl in jedem Projekt zur Verfügung.

uv tool install specify-cli --from git+https://github.com/github/spec-kit.git

Die globale Installation bietet folgende Vorteile:

• Verfügbar in einem beliebigen Projektverzeichnis.
• Einfach zu aktualisieren mit uv tool upgrade specify-cli.
• Installationsbefehle müssen nicht jedes Mal erneut ausgeführt werden.

Methode 2: Einmalige Nutzung

Wenn Sie es vorziehen, global nicht zu installieren, können Sie GitHub Spec Kit direkt mit uvx ausführen:

uvx --from git+https://github.com/github/spec-kit.git specify init

Einmaliger Download und Ausführung von GitHub Spec Kit für diese einzelne Ausführung. Es ist nützlich für:

• Vor der Installation GitHub Spec Kit ausprobieren, bevor man sich festlegt.
• Wird auf Systemen ausgeführt, auf denen Sie global nicht installieren können (z. B. einige CI-Server)

Der Nachteil ist, dass Sie Befehle jedes Mal mit dem Präfix uvx --from ... voranstellen müssen, was für die regelmäßige Verwendung weniger bequem ist.

Überprüfen der Installation

Überprüfen Sie nach der Installation, ob GitHub Spec Kit ordnungsgemäß funktioniert:

specify check

Mit diesem Befehl werden die erforderlichen Tools überprüft und bestätigt, dass die Installation erfolgreich war. Es meldet:

• Gibt an, ob Git gefunden und konfiguriert ist.
• Gibt an, ob Ihr KI-Codierungsassistent erkannt wird.
• Fehlende Abhängigkeiten oder Konfigurationsprobleme.

Wenn specify check Probleme meldet, beheben Sie diese, bevor Sie fortfahren.

Einrichten von Visual Studio Code mit GitHub Copilot

Mit den folgenden Schritten können Sie Visual Studio Code mit GitHub Copilot einrichten (für die Verwendung mit GitHub Spec Kit):

1. Installieren Sie Visual Studio Code.

   Laden Sie Visual Studio Code von code.visualstudio.com herunter, falls noch nicht geschehen.

2. Installieren Sie GitHub Copilot Erweiterung.

   1. Öffnen Sie Visual Studio Code.
   2. Wechseln Sie zur Ansicht "Erweiterungen" (STRG+UMSCHALT+X oder CMD+UMSCHALT+X).
   3. Suchen Sie nach "GitHub Copilot".
   4. Installieren Sie die GitHub Copilot Erweiterung.
   5. Melden Sie sich mit Ihrem GitHub Konto an, das über ein aktives GitHub Copilot-Abonnement verfügt.

3. Stellen Sie sicher, dass GitHub Copilot funktioniert.

   Öffnen Sie den Bereich "GitHub Copilot Chat", und überprüfen Sie, ob die Chatfunktion funktioniert.

4. Öffnen Sie das integrierte Terminal.

   Sie können specify Befehle im integrierten Terminal Visual Studio Code ausführen:

   1. Öffnen Sie ein neues Terminal.
   2. Navigieren Sie zu Ihrem Projektverzeichnis.
   3. Führen Sie specify check aus, um zu überprüfen, ob alles konfiguriert ist.

Installieren für andere Umgebungen

Wenn Sie Visual Studio Code nicht verwenden, ist der Prozess ähnlich:

Claude Code

1. Global specify-cli installieren, wie zuvor beschrieben.
2. Öffnen Sie die Benutzeroberfläche von Claude in Ihrem Projektordner.
3. Geben Sie direkt im Chat Schrägstrichbefehle (/speckit.specifyusw.) ein.

Mauszeiger

1. Installiere specify-cli global.
2. Öffnen Sie Ihr Projekt im Cursor.
3. Stellen Sie sicher, dass der KI-Agent läuft.
4. Verwenden Sie Schrägstrichbefehle in der KI-Chatschnittstelle des Cursors.

Andere KI-Tools

Die meisten unterstützten KI-Codierungsassistenten folgen demselben Muster:

1. Installieren Sie die specify-cli App global.
2. Öffnen Sie Ihr Projekt in Ihrer bevorzugten Umgebung.
3. Verwenden Sie die Schrägstrichbefehle in der KI-Chatschnittstelle dieses Tools.

Überprüfen Sie die Tabelle "Unterstützte KI-Agenten" in der GitHub Spec Kit README-Datei auf spezifische Überlegungen zu den Tools.

Behandeln allgemeiner Probleme

Möglicherweise treten während der Installation oder einrichtung häufige Probleme auf. In den folgenden Abschnitten finden Sie Lösungen für häufige Probleme.

UV-Befehl nicht gefunden

Wenn uv nach der Installation nicht erkannt wird:

• Schließen Sie Ihr Terminal, und öffnen Sie es erneut.
• Stellen Sie sicher, dass sich das Installationsverzeichnis in Ihrem PATH befindet.
• Auf Windows müssen Sie den Computer möglicherweise neu starten.

Befehl nicht gefunden

Wenn specify nach der Installation nicht gefunden wird:

• Schließen Sie Ihr Terminal, und öffnen Sie es erneut.
• Überprüfen Sie, ob ~/.local/bin sich (oder das Verzeichnis des uv Toolcontainers) in Ihrem PATH befindet.
• Versuchen Sie, uv tool list auszuführen, um zu sehen, ob "specify-cli" angezeigt wird.

KI-Tool nicht erkannt

Wenn specify check meldet, dass Ihr KI-Tool nicht gefunden wird:

• Stellen Sie sicher, dass das KI-Tool installiert und ausgeführt wird.
• Stellen Sie für Visual Studio Code mit GitHub Copilot sicher, dass die Erweiterung installiert ist und Sie angemeldet sind.
• Überprüfen Sie, ob Sie die Überprüfung von einem Terminal aus ausführen, auf das das KI-Tool zugreifen kann.

Windows spezifische Probleme

Wenn Sie unter Windows Probleme haben:

• Stellen Sie sicher, dass PowerShell verfügbar ist (in der Regel vorinstalliert).
• Führen Sie PowerShell-Befehle in einem PowerShell-Terminal aus (keine Eingabeaufforderung).
• Installieren Sie die erforderlichen Komponenten (Python, uv, Git) für Windows.

Informationen zu Problemen, die über diese häufigen Probleme hinausgehen, finden Sie in den GitHub Spec Kit README- und Communityressourcen im GitHub Repository.

Zusammenfassung

GitHub Spec Kit unterstützt verschiedene Entwicklungsumgebungen und KI-Codierungsassistenten. Kernanforderungen sind Python 3.11+, Git und das Tool uv. Sie können das specify CLI global installieren oder einmalig über uvx ausführen. Visual Studio Code mit GitHub Copilot ist ein gängiges Setup, aber auch andere KI-Tools werden unterstützt. Mit specify check wird überprüft, ob Ihre Installation korrekt konfiguriert ist, um sicherzustellen, dass alles stimmt.

Hinweis

Weitere Details finden Sie auf der Registerkarte "Text und Bilder ".