GitHub 사양 키트 개발 환경 검사

Completed

GitHub 사양 키트에는 사양 기반 개발 워크플로를 지원하기 위해 올바르게 구성된 개발 환경이 필요합니다. 올바르게 구성된 환경에는 CLI 지정, AI 코딩 도우미, 코드 편집기 및 버전 제어 시스템이 포함됩니다. GitHub 사양 키트 개발 환경, 지원되는 구성, 설치 및 초기화 개념을 구성하는 구성 요소를 이해하는 것이 중요합니다.

개발 환경 구성 요소

GitHub 사양 키트 개발 환경은 사양 기반 개발 프로세스를 지원하기 위해 함께 작동하는 몇 가지 필수 구성 요소로 구성됩니다.

  • CLI 지정: 프로젝트를 초기화하고, 템플릿 구조를 만들고, 사양 기반 워크플로를 관리하는 명령줄 인터페이스 도구입니다. CLI 지정은 Python 기반이며 Python 3.11 이상이 필요하며 GitHub 사양 키트 프로젝트를 설정하기 위한 기초 역할을 합니다.

  • uv 패키지 관리자: Specify CLI를 설치하고 관리하는 데 권장되는 도구입니다. 이 도구는 Specify CLI에 대한 지속적인 설치, 버전 관리 및 업그레이드 기능을 제공합니다.

  • AI 통합 코드 편집기: GitHub 사양 키트는 채팅 인터페이스 및 슬래시 명령을 통해 AI 코딩 도우미를 지원하는 코드 편집기에서 작동하도록 설계되었습니다. GitHub Copilot를 사용하는 Visual Studio Code는 지원되는 기본 구성이지만 도구 키트는 다른 AI 에이전트를 지원합니다.

  • 버전 제어 시스템: GitHub 사양 키트 아티팩트(사양, 계획, 작업 및 헌법 파일)는 버전 제어 리포지토리에 markdown 파일로 저장됩니다. Git은 GitHub, GitHub Enterprise Server 및 Azure Repos를 지원하는 표준 버전 제어 시스템입니다.

  • AI 코딩 도우미: 사양 기반 워크플로는 AI 모델을 사용하여 사양을 해석하고 구현 계획 및 코드를 생성합니다. GitHub Spec Kit는 여러 AI 에이전트를 지원하지만 GitHub Copilot는 이 학습에 권장되는 AI 도우미입니다.

  • 프로그래밍 런타임(컨텍스트 종속): GitHub 사양 키트 자체에는 특정 프로그래밍 런타임이 필요하지 않지만 선택한 기술 스택(예: .NET SDK, Node.js또는 Python)을 기반으로 기능을 구현하기 위한 적절한 런타임이 필요합니다.

지원되는 AI 에이전트 및 모델

GitHub 사양 키트는 채팅 인터페이스 및 사용자 지정 슬래시 명령을 지원하는 다양한 AI 코딩 도우미와 함께 작동하도록 설계되었습니다. 지원되는 옵션을 이해하면 개발 워크플로에 적합한 구성을 선택할 수 있습니다.

  • GitHub Copilot: GitHub Spec Kit에서 지원하는 기본 AI 도우미로, Visual Studio Code의 GitHub Copilot 채팅 확장을 통해 사용할 수 있습니다. GitHub Copilot는 GitHub Spec Kit 워크플로를 트리거하는 사용자 지정 슬래시 명령에 대한 통합 채팅 환경, 인라인 코드 제안 및 지원을 제공합니다.

  • 광범위한 AI 에이전트 지원: GitHub Spec Kit는 Claude Code, Cursor, Windsurf, Gemini CLI, Qwen Code, Kilo Code, Auggie CLI, CodeBuddy CLI, Roo Code, Codex CLI 및 Amp를 포함하여 15개 이상의 AI 코딩 도우미를 지원합니다. 각 에이전트는 유사한 패턴(슬래시 명령을 인식하고 /speckit.* 프로젝트 아티팩트를 읽어 구현을 안내하는 채팅 인터페이스)을 통해 GitHub Spec Kit와 통합됩니다.

  • 에이전트별 제한 사항: 대부분의 에이전트는 GitHub 사양 키트를 완벽하게 지원하지만 일부 에이전트에는 제한 사항이 있습니다. 예를 들어 Amazon Q 개발자 CLI는 슬래시 명령에 대한 사용자 지정 인수를 지원하지 않으므로 특정 워크플로 사용자 지정에 영향을 줄 수 있습니다.

  • 모델 요구 사항: GitHub 사양 키트 워크플로는 복잡한 사양을 이해하고, 여러 아티팩트에서 컨텍스트를 유지 관리하고, 구조화된 출력을 생성할 수 있는 AI 모델에 따라 달라집니다. 광범위한 컨텍스트 창이 있는 최신 대형 언어 모델은 사양을 해석하고 포괄적인 구현 계획을 생성하는 데 가장 적합합니다.

기술 스택 및 언어 지원

GitHub Spec Kit의 핵심 원칙 중 하나는 기술 독립성입니다. 사양 기반 접근 방식은 다양한 기술 스택, 프로그래밍 언어 및 프레임워크에 적용됩니다.

  • 언어 불가지론자: 사양은 빌드하는 방법이 아니라 빌드할 내용을 설명합니다. .NET, Node.js, Python, Java 또는 기타 언어에서 동일한 사양을 구현할 수 있습니다. 기술 스택 선택은 사양 중이 아니라 계획 단계 중에 발생합니다.

  • 프레임워크 유연성: GitHub Spec Kit는 프로젝트에 적합한 모든 프레임워크 또는 라이브러리를 지원합니다. React, Angular 또는 Blazor를 사용하여 웹 애플리케이션을 빌드하든, Express 또는 ASP.NET Core를 사용하는 백 엔드 서비스든, .NET MAUI 또는 React Native를 사용하는 모바일 앱을 빌드하든, 사양 기반 프로세스는 일관성을 유지합니다.

  • 클라우드 플랫폼 중립성: 사양에는 아키텍처 제약 조건(예: "Azure 서비스 사용" 또는 "AWS에 배포")이 포함될 수 있지만 GitHub 사양 키트는 특정 클라우드 공급자를 적용하지 않습니다. 헌법 파일에 정의된 조직 표준은 클라우드 플랫폼 선택을 안내합니다.

  • 여러 동시 구현: 고급 GitHub Spec Kit 워크플로는 서로 다른 기술 스택을 사용하여 동일한 사양의 여러 병렬 구현을 만들도록 지원하므로 최종 접근 방식을 커밋하기 전에 다양한 솔루션을 탐색할 수 있습니다.

플랫폼 및 운영 체제 지원

GitHub Spec Kit는 주요 운영 체제에서 작동하므로 개발 팀이 선호하는 플랫폼을 사용할 수 있습니다.

  • Windows 지원: Windows 10 이상에서 PowerShell 및 명령 프롬프트 호환성을 모두 지원합니다. CLI 지정에는 초기화 및 구성을 위한 Windows 관련 스크립트가 포함되어 있습니다.

  • macOS 및 Linux 지원: bash 및 zsh 셸 호환성이 있는 macOS 및 Linux 배포판에서 기본 지원 설치는 패키지 관리자 및 pip를 사용하는 표준 Unix 규칙을 따릅니다.

  • 플랫폼 간 일관성: GitHub 사양 키트 아티팩트(Markdown 파일, 프롬프트 템플릿 및 구성)는 플랫폼 독립적 형식을 사용하여 다양한 운영 체제에서 사양과 계획이 동일하게 작동하도록 합니다.

엔터프라이즈 환경 고려 사항

조직에는 개발 환경 구성에 영향을 주는 특정 요구 사항, 정책 및 인프라가 있는 경우가 많습니다.

  • 회사 네트워크 제한: 엔터프라이즈 환경에서는 패키지 설치 및 Git 작업에 영향을 주는 프록시 서버, 사용자 지정 인증 기관 또는 방화벽 규칙을 사용할 수 있습니다. 개발 환경에서는 프록시 구성 및 인증서 신뢰 설정을 통해 이러한 제약 조건을 고려해야 합니다.

  • 확장 및 소프트웨어 승인: 일부 조직에서는 Visual Studio Code 확장 설치를 승인된 마켓플레이스로 제한하거나 보안 검토가 필요합니다. 이러한 정책을 이해하면 환경 설정 타임라인을 계획하는 데 도움이 됩니다.

  • 관리되는 개발 환경: 많은 조직에서 미리 구성된 개발 가상 머신, 컨테이너 또는 클라우드 기반 개발 환경을 제공합니다. 이러한 관리되는 환경에는 Python, Git 및 Visual Studio Code가 미리 설치되어 설치를 간소화하고 조직 표준을 준수하도록 보장하는 경우가 많습니다.

  • Azure DevOps 통합: GitHub 대신 Azure DevOps를 사용하는 팀의 경우 GitHub Spec Kit 아티팩트가 Azure Repos와 원활하게 통합됩니다. 작업은 Azure Boards 작업 항목에 연결할 수 있으며 사양은 끌어오기 요청의 설명서 역할을 합니다.

  • GitHub Enterprise Server: GitHub Enterprise Server(자체 호스팅 GitHub)를 사용하는 조직은 엔터프라이즈별 인증, 규정 준수 제어 및 조직 정책과 함께 GitHub 사양 키트를 사용할 수 있습니다.

설치 및 초기화 개념

GitHub 사양 키트를 설치하고 초기화하는 방법을 이해하면 환경 설정 프로세스를 이해하는 데 도움이 됩니다.

주요 설치 및 초기화 개념은 다음과 같습니다.

  • CLI 설치 지정: 도구를 사용하여 uv CLI 지정을 영구적으로 설치하여 시스템 전체에서 specify 명령을 사용할 수 있도록 하거나 영구 설치 없이 일회성 uvx 으로 사용할 수 있습니다. 지속적인 설치는 지속적인 개발 작업에 권장되며, uv tool listuv tool upgrade 명령을 통해 uv tool uninstall더 나은 도구 관리를 제공합니다.

  • 환경 확인: 이 specify check 명령은 Git 및 선택한 AI 코딩 에이전트를 포함하여 필요한 도구가 설치되고 액세스할 수 있는지 확인합니다. 이 확인 단계는 개발 작업을 시작하기 전에 환경 문제를 진단하는 데 도움이 됩니다.

  • 프로젝트 초기화: 이 specify init 명령은 사양 기반 개발을 위한 프로젝트 구조를 만듭니다. 이 프로세스는 AI 도우미가 슬래시 명령을 인식하고 응답할 수 있도록 하는 프롬프트 템플릿 디렉터리, 아티팩트 템플릿 파일 및 구성을 /speckit.* 생성합니다.

  • 고급 초기화 옵션: 이 specify init 명령은 Git 초기화를 건너뛰고(, 기존 디렉터리 사용), 회사 환경에--no-git 대한 GitHub 토큰 지정(--here--force--github-token, 프록시 시나리오에 대한 TLS 확인 건너뛰기) 및 자세한 디버그 출력(--skip-tls)을 사용하도록 설정하는 옵션을 포함하여 엔터프라이즈 및 특수 시나리오에 대한 다양한 플래그를 지원합니다.--debug

  • AI 에이전트 선택: 초기화 중에 사용하는 AI 코딩 도우미(예: GitHub Copilot, Claude 등)를 선택합니다. 이 선택은 구성된 프롬프트 템플릿 및 통합 스크립트를 결정합니다.

  • 버전 제어 통합: GitHub Spec Kit는 기본적으로 Git 리포지토리를 초기화하며(명시적으로 사용하지 않도록 설정되지 않은 경우) 모든 아티팩트가 처음부터 버전 제어되도록 합니다. 버전 제어 통합을 사용하면 팀이 사양을 공유하고 시간에 따른 변경 내용을 추적하는 공동 작업 워크플로를 사용할 수 있습니다.

초기화 후의 프로젝트 구조

초기화 후 GitHub Spec Kit는 표준화된 프로젝트 구조를 만듭니다.

  • .github/prompts/ 디렉터리: 사양 기반 워크플로의 각 단계를 통해 AI 도우미를 안내하는 프롬프트 템플릿 파일이 포함되어 있습니다. 파일에는 constitution.prompt.md, specify.prompt.md, clarify.prompt.md, plan.prompt.md, tasks.prompt.md, implement.prompt.md, analyze.prompt.md, 및 checklist.prompt.md가 포함되어 있습니다.

  • 아티팩트 템플릿 파일: GitHub Spec Kit는 프로젝트 루트에 constitution.md, spec.mdplan.md및 tasks.md 템플릿 버전을 만듭니다. 이러한 템플릿은 워크플로 중에 채워진 섹션 자리 표시자를 사용하여 시작점을 제공합니다.

  • 구성 파일: 선택한 AI 에이전트에 따라 GitHub 사양 키트는 코딩 도우미의 환경과 통합되는 다른 구성 파일을 만들 수 있습니다.

  • 스크립트 변형: 플랫폼 간 지원을 위해 GitHub Spec Kit는 bash/zsh 스크립트(.sh 파일) 및 PowerShell 스크립트(.ps1 파일)를 모두 생성하여 다른 운영 체제 및 셸과의 호환성을 보장할 수 있습니다.

슬래시 명령 아키텍처

/speckit.* AI 코딩 도우미에 표시되는 명령은 GitHub 사양 키트의 프롬프트 템플릿 아키텍처를 통해 사용하도록 설정됩니다.

  • 명령 인식: AI 채팅 인터페이스를 입력 /speckit 하면 도우미는 다음의 프롬프트 템플릿에 따라 사용자 지정 명령을 인식합니다 .github/prompts/.

  • 핵심 워크플로 명령: 사양 기반 개발 워크플로의 필수 명령에는 (프로젝트 원칙 만들기), (요구 사항 정의), /speckit.constitution (기술 계획 만들기), /speckit.specify (작업 목록 생성) /speckit.plan 및 /speckit.tasks (구현 실행)이 포함 /speckit.implement 됩니다.

  • 품질 향상 명령: 기타 명령은 (지정되지 않은 영역 명확히), (아티팩트 간 일관성 분석) /speckit.clarify 및(품질 유효성 검사 검사 목록 생성)을 포함하여 /speckit.analyze 반복적인 구체화 및 /speckit.checklist 유효성 검사를 지원합니다.

  • 템플릿 기반 지침: 각 슬래시 명령은 특정 아티팩트를 생성하거나 업데이트하는 방법을 AI에 지시하는 프롬프트 템플릿 파일에 해당합니다. 예를 들어, specify.prompt.md는 요약, 요구 사항, 수용 기준 및 엣지 사례에 대한 섹션을 포함하는 구조화된 사양을 만드는 데 AI를 안내합니다.

  • 컨텍스트 인식: 프롬프트 템플릿은 프로젝트의 다른 아티팩트들을 참조하여 AI가 일관성을 유지할 수 있도록 합니다. 예를 들어 /speckit.plan 기술 계획을 생성할 때(제약 조건) 및 constitution.md (요구 사항) 모두를 spec.md 참조합니다.

  • 사용자 지정 가능성: 조직은 프롬프트 템플릿을 사용자 지정하여 특정 설명서 표준을 적용하거나, 필요한 섹션을 추가하거나, 도메인별 용어를 통합할 수 있습니다.

환경 확인 개념

올바르게 구성된 환경을 사용하면 원활한 사양 기반 개발 워크플로를 사용할 수 있습니다.

주요 확인 지점은 다음과 같습니다.

  • CLI 접근성: specify 성공적인 CLI 설치를 나타내는 명령을 터미널 경로에서 사용할 수 있어야 합니다.

  • Visual Studio Code 확장 활성화: GitHub Copilot 채팅 확장을 설치, 활성화 및 인증하여 슬래시 명령에 사용되는 채팅 인터페이스를 사용하도록 설정해야 합니다.

  • 프로젝트 인식: 초기화 후 Visual Studio Code에서 프로젝트를 열면 GitHub Copilot 채팅 자동 완성에서 명령을 사용할 수 있습니다 /speckit.* .

  • 버전 제어 준비: Git을 구성하고 리포지토리를 초기화하여 아티팩트 커밋 및 공동 작업을 허용해야 합니다.

  • 환경 변수: GitHub Spec Kit는 환경 변수를 통한 구성을 지원합니다. 예를 들어 변수는 SPECIFY_FEATURE Git이 아닌 리포지토리의 기능 검색을 재정의하여 Git 분기가 사용되지 않을 때 특정 기능에 대한 작업을 사용하도록 설정할 수 있습니다.

일반적인 환경 고려 사항

다양한 개발 시나리오는 다양한 환경 문제를 제시합니다.

  • 회사 프록시 및 방화벽: 엔터프라이즈 네트워크에는 종종 패키지 설치 및 Git 작업에 대한 프록시 구성이 필요합니다. 인증 기관은 회사 HTTPS 가로채기를 신뢰하기 전에 구성이 필요할 수 있습니다.

  • 확장 승인 프로세스: 보안 정책을 사용하는 조직은 Visual Studio Code 확장을 설치하기 전에 승인이 필요할 수 있으므로 설치 타임라인에 영향을 줍니다.

  • Python 버전 관리: 단일 컴퓨터의 여러 Python 버전으로 인해 경로 충돌이 발생할 수 있습니다. 어떤 Python 인터프리터가 활성 상태인지 이해하면 설치 문제를 해결하는 데 도움이 됩니다.

  • PATH 구성: pip 또는 uv를 통해 설치된 CLI 도구는 시스템 PATH에 해당 설치 디렉터리를 필요로 합니다. 다른 운영 체제와 셸은 PATH 구성을 다르게 처리합니다.

  • 관리되는 환경과 셀프 서비스 환경: 미리 구성된 개발 VM은 설정을 간소화하지만 사용자 지정이 제한될 수 있습니다. 셀프 서비스 로컬 설치는 유연성을 제공하지만 더 많은 개별 구성이 필요합니다.

요약

GitHub Spec Kit 개발 환경은 CLI 지정, AI 코딩 도우미, 코드 편집기 및 버전 제어 시스템과 같은 필수 구성 요소를 결합하여 효과적인 사양 기반 개발 워크플로를 가능하게 합니다. 슬래시 명령, 프로젝트 구조 및 환경 확인 프로세스의 아키텍처를 이해하면 생산적인 개발 환경을 설정하고 유지할 수 있습니다. 엔터프라이즈 설정에서 일반적인 고려 사항을 해결하면 일관되고 추적 가능한 구현을 위해 AI 기반 코딩 지원을 사용하는 동안 조직의 요구 사항을 충족하도록 GitHub Spec Kit를 조정할 수 있습니다.