@ist/skit

Session Kit (skit) 패키지를 관리하기 위한 CLI 도구입니다. Claude Code 세션에서 사용할 profiles, prompts, packs 등을 설치하고 관리합니다.

설치

npm install -g @ist/skit

요구 사항: Node.js >= 18.0.0

사용법

패키지 설치

# GitLab 레지스트리에서 설치
skit install @ist/qa-kit

# 특정 버전 설치
skit install @ist/[email protected]

# 로컬 .tgz 파일에서 설치
skit install ./my-kit-1.0.0.tgz

# 로컬 디렉토리에서 설치 (개발용)
skit install .

# 상세 출력
skit install @ist/qa-kit -v

# 드라이 런 (실제 설치 없이 확인)
skit install @ist/qa-kit --dry-run

패키지 삭제

skit uninstall @ist/qa-kit
# 또는
skit rm @ist/qa-kit

설치된 패키지 목록

skit list
# 또는
skit ls

# JSON 형식 출력
skit list --json

패키지 탐색

# 특정 조직의 skit 패키지 목록 조회
skit browse @ist

# JSON 형식 출력
skit browse @ist --json

패키지 정보

# 현재 디렉토리의 skit.json 정보 표시
skit info

# JSON 형식 출력
skit info --json

패키지 패킹

# 현재 디렉토리를 .tgz 파일로 패킹
skit pack

# 출력 디렉토리 지정
skit pack -o ./dist

# 포함될 파일 확인 (드라이 런)
skit pack --dry-run

패키지 배포

# GitLab에 배포
skit publish
# 또는
skit p

# 버전 범프와 함께 배포
skit publish --bump patch   # 0.1.0 → 0.1.1
skit publish --bump minor   # 0.1.0 → 0.2.0
skit publish --bump major   # 0.1.0 → 1.0.0

# 드라이 런
skit publish --dry-run

.gitignore 생성

# skit 기본 .gitignore 생성/업데이트
skit gitignore

# 기존 파일 덮어쓰기
skit gitignore -f

skit.json 구조

{
  "name": "@ist/my-kit",
  "version": "1.0.0",
  "description": "My awesome session kit",
  "type": "skit",
  "files": ["**/*"],
  "exclude": ["*.test.ts"],
  "dependencies": {
    "cli": [
      {
        "name": "git-nested",
        "install": "gitlab-install add @microature/git-nested -g",
        "check": "git-nested --version",
        "optional": true
      }
    ],
    "skit": {
      "@ist/base-kit": "latest"
    }
  },
  "components": {
    "profiles": [
      { "name": "my-profile", "file": "profiles/my-profile.md" }
    ],
    "prompts": [
      { "name": "my-prompt", "file": "prompts/my-prompt.md" }
    ],
    "packs": [
      { "name": "my-pack", "file": "packs/my-pack.json" }
    ],
    "clis": [
      { "name": "mycli", "package": "@ist/mycli" }
    ]
  },
  "install": {
    "profiles": "~/.ist/profiles/",
    "prompts": "~/.ist/prompts/global/",
    "pre": ["echo 'Installing...'"],
    "post": ["echo 'Done!'"]
  }
}

dependencies 필드

| 필드 | 설명 | |------|------| | cli | CLI 도구 의존성 (gitlab-install, npm, pip 등 어떤 패키지 매니저든 가능) | | cli[].name | 도구 이름 (표시용) | | cli[].install | 설치 명령어 | | cli[].check | (선택) 설치 확인 명령어 - 성공하면 설치 스킵 | | cli[].optional | (선택) true면 설치 실패해도 계속 진행 | | skit | 다른 skit 패키지 의존성

## 기본 설치 경로

| 컴포넌트 타입 | 기본 경로 |
|--------------|----------|
| profiles | `~/.ist/profiles/` |
| prompts | `~/.ist/prompts/global/` |
| states | `~/.ist/state/profiles/` |
| packs | `~/.sesh/permission-packs.json` (병합) |

## 개발

```bash
# 의존성 설치
npm install

# TypeScript 컴파일
npm run build

# 개발 모드 (watch)
npm run dev

# 테스트 실행
npm test

# 테스트 단일 실행
npm run test:run

라이선스

MIT