로컬 코드 검색은(는) 무엇을 하나요?
설치 및 주의사항
도구가 없거나, 다른 머신에 이 스킬을 설치하거나, 가속을 확인하거나, 업데이트할 때는 설정 및 문제 해결을 읽으십시오. 일반적인 코딩 작업이 이 스킬을 호출한다고 해서 도구를 설치하거나 재구성하지 마십시오. 선택적 휴대용 cgrep 헬퍼는 검색 플래그를 제공합니다. 플랫폼별 설정과 그 제한 사항은 설정 문서에 설명되어 있습니다.
지향으로 시작하기
코딩 세션을 시작할 때, 그리고 리팩터링이나 복잡한 코드 질문을 조사하기 전에, 저장소의 지침과 관련 프로젝트 안내를 읽은 후, 광범위한 소스 읽기나 구현 계획 전에 첫 번째 코드 탐색 단계로 범위가 지정된 개요를 사용하십시오. 개요 하위 가이드를 읽으십시오.
가장 작은 관련 패키지, 디렉터리 또는 파일을 선택하십시오. 기본적으로 전체 모노레포를 개요로 작성하지 마십시오. 영역을 모르는 경우 파일 이름이나 집중된 ColGREP 쿼리를 사용하여 후보를 찾은 다음 개요를 작성하십시오. 이미 이 세션에서 현재 사용 중인 개요가 있으면 재사용하십시오. 구조적 편집 후에는 영향을 받은 파일을 새로고침하십시오. 이미 이해된 코드에서의 간단한 정확한 조회, 작은 변경, 비코드 관련 대화는 직접 진행할 수 있습니다. 이것은 백그라운드 프로세스나 모든 턴마다의 스캔이 아닌 작업 습관입니다.
다음 도구 선택
대상에 대해 알려진 정보를 바탕으로 선택하고 관련 하위 가이드만 읽으십시오. 이 가이드들은 이 스킬에 속하며, 별도의 스킬 등록이 아닙니다.
| 필요사항 | 도구 | 하위 가이드 |
|---|---|---|
| 세션 지향, 리팩터링 범위 또는 복잡한 코드 조사 | ast-grep outline | 먼저 개요 작성 |
| 정확한 문자열, 오류 메시지, 파일 이름 또는 간단한 식별자 발생 | rg | 정확한 검색 |
| 동작 설명으로 구현 찾기 | ColGREP / cgrep | 의미 검색 |
| 코드 구조 내 구문, 관계, 반복 가능한 구문 기반 변경 | ast-grep | 구조적 검색 |
관련 영역을 알고 있다면 좁은 파일 또는 디렉터리 범위부터 시작하십시오. ColGREP으로 후보를 발견하고, rg로 알려진 심볼을 검사하고, ast-grep으로 구문 패턴을 구체화하는 것은 일반적입니다. 세 가지를 자동으로 모두 실행하지 마십시오. 파일 읽기/편집, 테스트 및 git 작업에는 네이티브 에이전트 도구를 사용하십시오.
검색 결과는 후보를 찾습니다. 동작에 대한 주장을 하기 전에 관련 소스를 검사하십시오. 구문 일치를 타입이 확인된 참조로 취급하지 마십시오.
하나의 표준 설치로 Codex와 Claude Code를 지원합니다. 도구 안내를 여기서 유지 관리하십시오. 독립 실행형 도구 스킬을 재설치하거나 중복 검색 훅을 활성화하지 마십시오.