← ClaudeAtlas

code-intellisted

Use AST search, replacement previews, and language-server diagnostics or navigation in trusted workspaces; servers may execute project code. Choose AST for code structure, LSP for semantic questions, and text search for literal strings.
This-HW/hiway-kit · ★ 5 · Code & Development · score 77
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을 먼저 시험한다. 아래 예시는 실제 프로젝트 규칙을 대신하지 않는다.