도움이 필요하세요?

Kit 시작하기

Kit(스펙·상세 계획·구현 코드), Spec(확정 기능 정의), Skill(AI 지침·참조 자료)을 파일과 함께 비공개로 정리하고 필요할 때 공개할 수 있습니다. 웹에서 유형을 선택해 시작하세요.

예제 파일은 공식 저장소의 examples/beginner-kit 폴더에 있습니다. 저장소를 받아 그 폴더를 사용하세요. 별도 다운로드 페이지는 없습니다.

저장소 CLI 준비

Node.js 22와 pnpm 10.15.0, 캐시에 준비된 의존성이 필요합니다. 현재 전역 speckithub 설치 패키지는 공개되지 않았습니다. 공식 저장소 루트에서 의존성을 설치하고 공용 Kit 패키지와 CLI를 빌드하세요. SPECKITHUB_SERVER를 사용할 Hub 주소로 설정하세요. 기존 KITCAT_SERVER도 호환 입력으로 지원합니다. 아래 예제는 Bash이며 Windows에서는 Bash 또는 해당 Node 명령을 사용하세요.

# From the root of the official SpecKitHub repository
corepack pnpm install --offline --frozen-lockfile
corepack pnpm --filter @speckithub/kit build
corepack pnpm --filter @speckithub/cli build
export SPECKITHUB_SERVER=https://speckithub.com
node apps/cli/dist/index.js --help

비공개 Kit 게시 및 설치

로그인 코드를 브라우저에서 확인하고 승인하세요. 예제 폴더 게시 명령은 먼저 파일을 미리 보여줍니다. 내용을 확인한 뒤에만 --yes로 게시하세요. 검색·상세 확인 뒤 설치 대상 ./project와 파일 목록을 검토하고 --yes로 설치하세요.

node apps/cli/dist/index.js login --email you@example.com --server "$SPECKITHUB_SERVER"
node apps/cli/dist/index.js publish examples/beginner-kit --slug beginner-kit --version 1.0.0
node apps/cli/dist/index.js publish examples/beginner-kit --slug beginner-kit --version 1.0.0 --yes
node apps/cli/dist/index.js search beginner --private
node apps/cli/dist/index.js show beginner-kit@1.0.0 --private
node apps/cli/dist/index.js install beginner-kit@1.0.0 --private --target ./project
node apps/cli/dist/index.js install beginner-kit@1.0.0 --private --target ./project --yes
node apps/cli/dist/index.js update beginner-kit --private --target ./project
REVIEWED_VERSION=replace-with-reviewed-version
node apps/cli/dist/index.js update beginner-kit --private --target ./project --to "$REVIEWED_VERSION" --yes

공개 Kit 설치

웹에서 Kit의 공개 전환 내용을 검토하고 공개한 뒤, 상세 페이지에 표시된 공개 UUID와 버전을 사용하세요. 공개 검색·상세 확인·설치는 로그인 없이도 가능합니다. 설치 파일과 대상을 먼저 검토한 다음 --yes로 확인하세요.

# Use the public Kit UUID from its Web detail page
PUBLIC_KIT_ID=replace-with-public-uuid
node apps/cli/dist/index.js search beginner
node apps/cli/dist/index.js show "$PUBLIC_KIT_ID"@1.0.0
node apps/cli/dist/index.js install "$PUBLIC_KIT_ID"@1.0.0 --target ./project
node apps/cli/dist/index.js install "$PUBLIC_KIT_ID"@1.0.0 --target ./project --yes
node apps/cli/dist/index.js update "$PUBLIC_KIT_ID" --target ./project
REVIEWED_VERSION=replace-with-reviewed-version
node apps/cli/dist/index.js update "$PUBLIC_KIT_ID" --target ./project --to "$REVIEWED_VERSION" --yes

업데이트는 자동 적용되지 않습니다. 먼저 변경 목록을 확인하세요. 새 버전이 실제로 있을 때 REVIEWED_VERSION에 검토한 버전을 지정하고 --to와 --yes로 승인한 업데이트만 적용하세요.

더 자세한 CLI 안내: docs/cli-ai.ko.md · AI 작업 안내: docs/agents.ko.md (공식 저장소 안의 파일)

AI 플러그인으로 업로드 준비

공식 저장소의 plugins/speckithub/README.md를 따라 Claude Code 플러그인과 원격 MCP를 연결하세요. 선택한 폴더만 별도 준비 공간에 정리하며 원본은 보존합니다. 유형·파일 역할·누락·경고를 확인한 뒤 업로드와 게시를 각각 승인합니다. 기본은 비공개이며 파일이나 스크립트는 자동 실행하지 않습니다.

서버 가이드는 각 원격 작업 전에 확인해 갱신됩니다. 도구 목록 변경은 재연결, 로컬 플러그인·주소 변경은 패키지 갱신이 필요할 수 있습니다. CLI의 --variant로 게시된 지원 환경만 선택하고 다른 언어의 구현을 자동 생성하거나 지원으로 표시하지 않습니다.

토큰을 셸이나 AI에 붙여 넣지 마세요. Kit 파일은 자동으로 실행되지 않습니다.