# skill-sync

> 팀 Private GitHub 저장소에서 스킬을 동기화합니다.
전체 또는 특정 스킬만 선택하여 가져올 수 있습니다.
"스킬 동기화", "팀 스킬 가져와", "skill sync", "팀 저장소 동기화" 등의 요청 시 사용하세요.

- Author: 조한솔
- Repository: fnf-ax-team/CC_ax_team
- Version: 20260126155147
- Stars: 1
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/fnf-ax-team/CC_ax_team
- Web: https://mule.run/skillshub/@@fnf-ax-team/CC_ax_team~skill-sync:20260126155147

---

---
name: skill-sync
description: |
  팀 Private GitHub 저장소에서 스킬을 동기화합니다.
  전체 또는 특정 스킬만 선택하여 가져올 수 있습니다.
  "스킬 동기화", "팀 스킬 가져와", "skill sync", "팀 저장소 동기화" 등의 요청 시 사용하세요.
---

# Skill Sync - 팀 저장소 스킬 동기화 (선택적)

팀 Private GitHub 저장소(CC_ax_team)에서 최신 스킬을 가져와 `team/` 폴더에 동기화합니다.
**전체 동기화** 또는 **특정 스킬만 선택**하여 가져올 수 있습니다.
기존 로컬 스킬은 그대로 유지되며, 팀 스킬과 분리 관리됩니다.

## When to Use This Skill

다음과 같은 요청 시 이 스킬을 사용하세요:
- "팀 스킬 동기화해줘"
- "CC_ax_team에서 스킬 가져와"
- "skill sync"
- "팀 저장소 최신 스킬 받아줘"
- "팀 스킬 업데이트해줘"
- "특정 스킬만 가져와줘"

## Configuration

```
TEAM_REPO_URL: https://github.com/davidcho0326/CC_ax_team.git
SKILLS_BASE_DIR: C:/Users/AC1059/.claude/skills/
TEAM_SKILLS_DIR: C:/Users/AC1059/.claude/skills/team/
TEMP_CLONE_DIR: C:/Users/AC1059/.claude/skills/.team_repo_temp/
```

## Your Task

### Step 1: 팀 저장소 동기화

1. **TEMP_CLONE_DIR 존재 확인**
   ```bash
   # 폴더가 없으면 클론
   if [ ! -d "C:/Users/AC1059/.claude/skills/.team_repo_temp" ]; then
     git clone https://github.com/davidcho0326/CC_ax_team.git "C:/Users/AC1059/.claude/skills/.team_repo_temp"
   else
     # 폴더가 있으면 풀
     cd "C:/Users/AC1059/.claude/skills/.team_repo_temp" && git pull
   fi
   ```

2. **Git Credential Manager가 자동으로 인증 처리**
   - Windows Credential Manager에 저장된 GitHub 자격증명 사용
   - 추가 로그인 없이 자동 진행

### Step 2: 스킬 목록 파싱 ⭐

팀 레포에서 사용 가능한 스킬 목록을 조회합니다.

1. **스킬 폴더 목록 조회**
   ```bash
   ls "C:/Users/AC1059/.claude/skills/.team_repo_temp/skills/"
   ```

2. **각 스킬의 설명 추출**
   각 스킬 폴더의 SKILL.md 파일에서 `description` 필드를 읽어 사용자에게 보여줄 정보를 수집합니다.

   ```bash
   # 예시: 스킬별 설명 추출
   for skill_dir in C:/Users/AC1059/.claude/skills/.team_repo_temp/skills/*/; do
     skill_name=$(basename "$skill_dir")
     echo "- $skill_name"
   done
   ```

3. **스킬 목록 정리**
   파싱된 정보를 테이블 형식으로 정리:

   | 스킬명 | 설명 |
   |--------|------|
   | ceo-ppt | 회장님 보고용 PPT 자동 생성 |
   | kpop-sns | K-pop SNS 계정 검색 |
   | llm-api-docs | LLM API 문서 수집 |
   | session-summary | 세션 요약 생성 |
   | skill-push | 스킬 GitHub 푸시 |
   | skill-sync | 팀 스킬 동기화 |

### Step 3: 사용자 선택 요청 ⭐

**AskUserQuestion** 도구를 사용하여 사용자에게 동기화할 스킬을 선택받습니다.

**중요**: 반드시 `AskUserQuestion` 도구를 호출하여 사용자의 선택을 받아야 합니다.

```
질문: "어떤 스킬을 동기화할까요?"
헤더: "스킬 선택"
멀티셀렉트: true (여러 스킬 선택 가능)

옵션:
1. "전체 동기화 (Recommended)" - 팀 레포의 모든 스킬을 가져옵니다
2. "ceo-ppt" - 회장님 보고용 PPT
3. "kpop-sns" - K-pop SNS 검색
4. "llm-api-docs" - LLM API 문서 수집
5. "session-summary" - 세션 요약 생성
6. "skill-push" - 스킬 GitHub 푸시
7. "skill-sync" - 팀 스킬 동기화
```

**AskUserQuestion 도구 호출 예시:**
```json
{
  "questions": [{
    "question": "어떤 스킬을 동기화할까요?",
    "header": "스킬 선택",
    "multiSelect": true,
    "options": [
      {"label": "전체 동기화 (Recommended)", "description": "팀 레포의 모든 스킬을 가져옵니다"},
      {"label": "ceo-ppt", "description": "회장님 보고용 PPT"},
      {"label": "kpop-sns", "description": "K-pop SNS 검색"},
      {"label": "llm-api-docs", "description": "LLM API 문서 수집"},
      {"label": "session-summary", "description": "세션 요약 생성"},
      {"label": "skill-push", "description": "스킬 GitHub 푸시"},
      {"label": "skill-sync", "description": "팀 스킬 동기화"}
    ]
  }]
}
```

### Step 4: 선택된 스킬 복사

사용자의 선택에 따라 스킬을 복사합니다.

1. **team/ 폴더 생성 확인**
   ```bash
   mkdir -p "C:/Users/AC1059/.claude/skills/team/"
   ```

2. **선택에 따른 복사 실행**

   **"전체 동기화" 선택 시:**
   ```bash
   cp -r "C:/Users/AC1059/.claude/skills/.team_repo_temp/skills/"* "C:/Users/AC1059/.claude/skills/team/"
   ```

   **특정 스킬 선택 시 (예: ceo-ppt, kpop-sns):**
   ```bash
   cp -r "C:/Users/AC1059/.claude/skills/.team_repo_temp/skills/ceo-ppt" "C:/Users/AC1059/.claude/skills/team/"
   cp -r "C:/Users/AC1059/.claude/skills/.team_repo_temp/skills/kpop-sns" "C:/Users/AC1059/.claude/skills/team/"
   ```

3. **복사 결과 확인**
   ```bash
   ls -la "C:/Users/AC1059/.claude/skills/team/"
   ```

### Step 5: 결과 리포트 출력

다음 형식으로 결과를 사용자에게 보고:

```markdown
## ✅ 팀 스킬 동기화 완료

- **동기화 일시**: YYYY-MM-DD HH:MM:SS
- **저장소**: CC_ax_team (Private)
- **브랜치**: main
- **동기화 모드**: 전체 / 선택적 (선택한 스킬 수)

### 동기화된 스킬
| 스킬 | 상태 | 설명 |
|------|------|------|
| ceo-ppt | ✅ 동기화됨 | 회장님 보고용 PPT |
| kpop-sns | ✅ 동기화됨 | K-pop SNS 검색 |
| ... | ... | ... |

### 디렉토리 구조
- **로컬 스킬**: ~/.claude/skills/ (루트)
- **팀 스킬**: ~/.claude/skills/team/

### 스킬 호출 방법
- 로컬 스킬: `/ceo-ppt` 또는 "PPT 만들어"
- 팀 스킬: `/team:ceo-ppt` 또는 "팀 ceo-ppt로 PPT 만들어"
```

## Error Handling

### 인증 실패
```
Git 인증에 실패했습니다.
해결 방법:
1. Windows 자격 증명 관리자에서 GitHub 항목 확인
2. `git credential-manager` 설정 확인
3. GitHub 토큰 만료 여부 확인
```

### 네트워크 오류
```
네트워크 연결에 실패했습니다.
- 인터넷 연결 상태 확인
- VPN 연결 상태 확인 (회사 네트워크인 경우)
```

### 저장소 없음
```
저장소를 찾을 수 없습니다.
- 저장소 URL 확인: https://github.com/davidcho0326/CC_ax_team
- 저장소 접근 권한 확인
```

## Important Notes

1. **로컬 스킬은 절대 덮어쓰지 않음**
   - 루트 폴더의 기존 스킬은 그대로 유지
   - 팀 스킬은 항상 `team/` 폴더에만 저장

2. **충돌 없음**
   - 같은 이름의 스킬이 루트와 team/에 동시에 존재 가능
   - 루트 스킬이 우선, `team:` 접두사로 팀 버전 호출

3. **자동 인증**
   - Git Credential Manager가 설정되어 있으면 추가 인증 없이 진행
   - Private 저장소도 자동 접근 가능

4. **선택적 동기화** ⭐
   - 전체 동기화 또는 특정 스킬만 선택 가능
   - 사용자가 명시적으로 선택해야 복사 진행
   - "Other" 옵션으로 직접 스킬명 입력도 가능