instinct-import

언제 쓰나

외부 소스의 인스턴트를 프로젝트나 전역에 추가할 때 사용합니다.

---
name: instinct-import
description: 프로젝트/전역 범위로 파일 또는 URL에서 인스팅트 가져오기
command: true
---

# Instinct Import 명령어

## 구현

플러그인 루트 경로를 사용하여 instinct CLI를 실행합니다:

```bash
python3 "${CLAUDE_PLUGIN_ROOT}/skills/continuous-learning-v2/scripts/instinct-cli.py" import <file-or-url> [--dry-run] [--force] [--min-confidence 0.7] [--scope project|global]
```

또는 `CLAUDE_PLUGIN_ROOT`가 설정되지 않은 경우 (수동 설치):

```bash
python3 ~/.claude/skills/continuous-learning-v2/scripts/instinct-cli.py import <file-or-url>
```

로컬 파일 경로 또는 HTTP(S) URL에서 인스팅트를 가져옵니다.

## 사용법

```
/instinct-import team-instincts.yaml
/instinct-import https://github.com/org/repo/instincts.yaml
/instinct-import team-instincts.yaml --dry-run
/instinct-import team-instincts.yaml --scope global --force
```

## 수행할 작업

1. 인스팅트 파일 가져오기 (로컬 경로 또는 URL)
2. 형식 구문 분석 및 유효성 검사
3. 기존 인스팅트와의 중복 확인
4. 새 인스팅트 병합 또는 추가
5. 상속된 인스팅트 디렉토리에 저장:
   - 프로젝트 범위: `~/.claude/homunculus/projects/<project-id>/instincts/inherited/`
   - 전역 범위: `~/.claude/homunculus/instincts/inherited/`

## 가져오기 프로세스

```
 Importing instincts from: team-instincts.yaml
================================================

Import할 인스팅트 12개를 찾았습니다.

충돌 분석 중...

## 새 인스팅트 (8)
추가될 내용:
  ✓ use-zod-validation (confidence: 0.7)
  ✓ prefer-named-exports (confidence: 0.65)
  ✓ test-async-functions (confidence: 0.8)
  ...

## 중복 인스팅트 (3)
유사한 인스팅트가 이미 존재합니다:
  WARNING: prefer-functional-style
     Local: 0.8 confidence, 12 observations
     Import: 0.7 confidence
     → 로컬 유지 (더 높은 신뢰도)

  WARNING: test-first-workflow
     Local: 0.75 confidence
     Import: 0.9 confidence
     → 가져오기로 업데이트 (더 높은 신뢰도)

새 인스팅트 8개, 업데이트 1개 가져올까요?
```

## 병합 동작

기존 ID를 가진 인스팅트를 가져올 때:
- 더 높은 신뢰도의 가져오기가 업데이트 후보가 됩니다.
- 동일하거나 더 낮은 신뢰도의 가져오기는 건너뜁니다.
- `--force`가 사용되지 않은 경우 사용자에게 확인을 요청합니다.

## 출처 추적

가져온 인스팅트에는 다음이 표시됩니다:
```yaml
source: inherited
scope: project
imported_from: "team-instincts.yaml"
project_id: "a1b2c3d4e5f6"
project_name: "my-project"
```

## 플래그

- `--dry-run`: 가져오기 없이 미리 보기
- `--force`: 확인 프롬프트 건너뛰기
- `--min-confidence <n>`: 임계값 이상의 인스팅트만 가져오기
- `--scope <project|global>`: 대상 범위 선택 (기본값: `project`)

## 출력

가져오기 후:
```
PASS: Import complete!

추가됨: 인스팅트 8개
업데이트됨: 인스팅트 1개
건너뜀: 인스팅트 3개 (동일하거나 더 높은 신뢰도의 인스팅트가 이미 존재함)

새 인스팅트가 다음 위치에 저장되었습니다: ~/.claude/homunculus/instincts/inherited/

모든 인스팅트를 보려면 /instinct-status를 실행하세요.
```

1. 1

   SKILL.md 저장

   아래 버튼으로 복사 → 다음 경로로 저장.

   SKILL.md 복사

   macOSLinuxWindows

   ~/.claude/skills/everything-claude-code-instinct-import/SKILL.md경로 복사
2. 2

   호출

   Claude Code 채팅창에서 자연어로 부르면 자동 발동:

   예) 외부 소스의 인스턴트를 프로젝트나 전역에 추가할 때 사용합니다

   트리거가 안 잡히면 SKILL.md의 description 줄에 더 구체적인 한국어 키워드를 추가해보세요.