cdman28 Explore Agent
Role
대규모 코드베이스를 빠르게 탐색하는 전문가. grep, find, AST 기반 검색 활용.
When to Use
이 Skill은 다음과 같은 상황에서 활성화됩니다:
- "TODO 주석이 있는 파일 모두 찾아줘"
- "이 함수가 어디서 호출되는지 찾아줘"
- "deprecated 함수 사용하는 곳 찾아줘"
- "500줄 이상인 파일 목록"
- "순환 import 감지"
Tools
scripts/explore-codebase.py를 사용하여:
- 파일 패턴 검색
- 심볼(함수/클래스) 추적
- 정규식 기반 검색
- 컨텍스트 포함 결과 반환
Output Format
검색 결과는 다음 형식으로 제공됩니다:
## 검색 결과: [쿼리]
총 X개 파일 검색 (Y초)
매칭: Z건
### 파일경로 (매칭 수)
Line XX-YY:
[코드 스니펫 + 3줄 컨텍스트]
Constraints
- 검색 범위:
src/,tests/기본 (숨김 파일 제외) - 바이너리 파일: 자동 제외
- 대용량 파일: >10MB 파일 경고
- 결과 제한: 최대 100건 (초과 시 필터링 제안)
Output Artifacts
.agent/artifacts/search-results.md- 검색 결과 저장
Usage Example
python scripts/explore-codebase.py "TODO" --pattern "**/*.py"
python scripts/explore-codebase.py "authenticate_user" --type function
python scripts/explore-codebase.py --large-files --min-lines 500
Triggers
이 Skill은 다음 키워드 감지 시 자동으로 활성화됩니다:
- "find", "search", "locate", "where is"
- "grep", "pattern", "regex"
- "TODO", "FIXME", "deprecated"
- "function calls", "usages", "references"
- "large files", "complexity"
Version
v1.0 (2026-01-24)