code-intellisted
Install: claude install-skill This-HW/hiway-kit
# Code intelligence
질문에 맞는 가장 작은 도구를 쓴다. 문자열·파일명은 `rg`, 호출/선언의 모양은 AST,
정의·참조·타입 오류는 언어 서버다. 전체 저장소를 덤프하지 않고 관련 경로부터 좁힌다.
호스트에 해당 AST/LSP 도구가 실제로 있으면 그것을 먼저 쓴다. 도구 이름을 추측하지 않는다.
없으면 아래 일회성 CLI를 쓴다. 도구를 자동 설치하거나 전역 설정을 바꾸지 않는다.
`<kit-root>`는 이 SKILL.md의 두 단계 상위 디렉토리다. 프로젝트 cwd에 킷이 있다고
가정하지 않는다. 탐색 규약: `skills/plan-task/references/task-tools-fallback.md` §A.
**신뢰한 작업 공간과 실행 파일에만 사용한다.** 여기서 read-only는 편집 요청을 거부하고
AST 변경을 preview로만 반환한다는 계약이다. OS sandbox가 아니다. 언어 서버는
`build.rs`·proc-macro·toolchain·프로젝트 tsserver나 빌드 스크립트를 실행할 수 있으며,
네트워크 접근과 파일 쓰기도 가능하다. 격리가 필요하면 호스트에서 별도 sandbox를 적용한다.
## 구조 검색과 변경 미리보기
이미 설치된 `ast-grep` 이름만 자동 탐색한다. `sg`는 다른 프로그램일 수 있어 실행하지 않는다.
상대 PATH 결과와 작업 공간 안의 실행 파일은 버전 조회 전 거부하며 별도 허용 flag는 없다.
중립 임시 cwd에서 명시적 빈 설정과 절대 대상 경로로 실행하여 작업 공간 및 상위 경로의
`sgconfig.yml` 자동 탐색을 피한다. 사용자 정의 parser/config는 이 CLI에서 사용하지 않는다.
패턴은 정규식이 아니라 해당 언어로 파싱되는 코드다. 셸에서는 `$A`가 확장되지 않도록 단일 따옴표로 감싼다.
```bash
python3 -B <kit-root>/tools/code_intel.py --root . --lang c --pattern 'puts($A);' src/
python3 -B <kit-root>/tools/code_intel.py --root . --lang c --pattern 'puts($A);' --rewrite 'log($A);' src/
```
변경 명령도 **미리보기만** 반환한다. 파일/일치 수와 replacement를 읽은 뒤 기존 편집 도구로
검토한 범위만 바꾸고 프로젝트 검증을 실행한다. `--limit`은 출력 항목 수만 줄인다. 전체 조회가
너무 크면 경로를 좁힌다. 0건은 잘못된 언어/패턴일 수도 있으므로 알려진 양성 사례와 먼저 대조한다.
## 문맥 규칙과 반복 미리보기
문맥 조건이 필요한 변환은 `--rule-json`으로 JSON object 또는 object 배열을 명시한다.
규칙 파일·YAML 원문·프로젝트 설정은 받지 않는다. 기존 pattern 옵션과 혼용하지 않는다.
작은 대상에서 양성/음성 snippet을 먼저 시험한다. 아래 예시는 실제 프로젝트 규칙을 대신하지 않는다.