Agent Skills: Load Context Skill

🔔 시스템 메시지: 이 Skill이 호출되면 [SEMO] Skill: load-context 호출 - {대상} 시스템 메시지를 첫 줄에 출력하세요.

Load Context Skill

도메인/기능의 빠른 컨텍스트 파악

When to Use

• 특정 도메인/기능 이해가 필요할 때
• 기존 기능 수정 전 컨텍스트 파악
• 세션 시작 시 작업 컨텍스트 로드
• 버그 수정 전 관련 코드 파악 (debug-master와 연계)

Context Sources

1. Spec Documents (specs/)

# 도메인 스펙 문서 확인
ls specs/{domain}/
# spec.md, plan.md, tasks.md

# 스펙 내용 요약
cat specs/{domain}/spec.md

수집 정보:

• 요구사항 정의
• 기술 계획
• 작업 항목

2. Source Code (domain/)

# 도메인 코드 구조 확인
ls -la domain/{domain}/

# 주요 파일 목록
find domain/{domain} -name "*.kt" -type f

수집 정보:

• Entity 구조
• Service 로직
• Controller 엔드포인트
• 예외 처리

3. Git History

# 최근 변경 이력
git log --oneline -10 -- domain/{domain}/

# 최근 변경 내용
git diff HEAD~5 -- domain/{domain}/

수집 정보:

• 최근 변경 사항
• 변경 이유 (커밋 메시지)
• 담당자

4. Related Issues

# 관련 이슈 확인
gh issue list --label "{domain}" --state all --limit 5

수집 정보:

• 진행 중인 이슈
• 완료된 이슈
• 알려진 문제

5. Test Files

# 테스트 파일 확인
ls src/test/**/*{Domain}*.kt

수집 정보:

• 테스트 커버리지
• 테스트 시나리오

📚 상세 소스 목록: references/context-sources.md

Workflow

1. 대상 식별
   ├── 도메인명 추출
   └── 관련 경로 매핑

2. Spec 문서 수집
   ├── specs/{domain}/ 존재 확인
   └── spec.md, plan.md 요약

3. 코드 구조 분석
   ├── domain/{domain}/ 파일 목록
   ├── 주요 클래스/함수 식별
   └── 의존성 파악

4. 이력 확인
   ├── git log 최근 변경
   └── 관련 이슈/PR

5. 컨텍스트 요약 출력

Output Format

[SEMO] Skill: load-context 호출 - {domain}

## 📋 컨텍스트 요약: {Domain}

### 📄 Spec 상태
| 파일 | 상태 | 요약 |
|------|------|------|
| spec.md | ✅/❌ | {brief_summary} |
| plan.md | ✅/❌ | {brief_summary} |
| tasks.md | ✅/❌ | {progress} |

### 📁 코드 구조
```text
domain/{domain}/
├── entity/{Domain}.kt         # {entity_fields_count} fields
├── repository/{Domain}Repository.kt
├── service/
│   ├── {Domain}CommandService.kt  # {command_methods}
│   └── {Domain}QueryService.kt    # {query_methods}
├── web/{Domain}Controller.kt      # {endpoints_count} endpoints
└── exception/{Domain}Exception.kt

🔄 최근 변경

| 날짜 | 커밋 | 내용 | |------|------|------| | {date} | {hash} | {message} |

🎫 관련 이슈

• #{issue_number}: {issue_title} ({state})

📊 테스트 현황

• 테스트 파일: {test_file_count}개
• 주요 테스트: {test_classes}

🔗 연관 도메인

• {related_domain_1}
• {related_domain_2}

다음 작업 제안:

1. {suggestion_1}
2. {suggestion_2}

## Options

| Option | Description | Example |
|--------|-------------|---------|
| `--deep` | 상세 분석 (코드 내용 포함) | `load-context posts --deep` |
| `--spec-only` | Spec 문서만 확인 | `load-context posts --spec-only` |
| `--code-only` | 코드 구조만 확인 | `load-context posts --code-only` |
| `--history` | Git 이력 중심 | `load-context posts --history` |

## Usage Examples

### 기본 사용

"posts 도메인 컨텍스트 파악해" → skill:load-context posts

Spec, 코드 구조, 최근 변경, 이슈 모두 확인

### 상세 분석

"채팅 기능 자세히 분석해줘" → skill:load-context chat --deep

코드 내용까지 포함한 상세 분석

### 수정 전 파악

"알림 기능 수정하려는데 먼저 파악해줘" → skill:load-context notification

컨텍스트 파악 후 debug-master로 연계 가능

## Integration Points

| Tool/Agent | When |
|------------|------|
| `debug-master` | 컨텍스트 파악 후 버그 수정 |
| `spec-master` | Spec 누락 시 작성 제안 |
| `implementation-master` | 구현 전 컨텍스트 확인 |

## Critical Rules

1. **읽기 전용**: 코드 수정하지 않음
2. **요약 중심**: 핵심 정보만 추출
3. **연계 제안**: 다음 작업 자동 제안
4. **최신 정보**: Git 이력으로 최신 상태 확인

## References

- [Context Sources](references/context-sources.md)
- [Output Format](references/output-format.md)