콘텐츠로 이동

탐색 도구 사용

도구 용도 주요 인자
initial_instructions 탐색 안내 및 모노레포 범위 목록 조회 task (Jev 필터 활성화 시)
search 심볼, 문서 주석, 문자열 리터럴 BM25 검색 query, workspace_scope, language_hint, extension_hint, caller_context, include_seen
find glob 또는 파일명 정규식으로 파일·디렉터리 찾기(최근 수정 순) pattern, path, include_ignored, entry_type, max_depth, pattern_type
grep 실시간 파일 정규식 검색 pattern, path, glob, output_mode, view, expand
read 실시간 파일 줄 범위 읽기 또는 선언 목록 조회 file_path, offset, limit, ranges, view, expand, include_seen
analyze 색인 용량 및 읽기 이력 JSON 집계 target, limit, offset, sort, filter, view, days, tool
synonyms (선택형) 관련 영어 코드 용어 및 유의어 조회 terms(1–16개 단어 또는 짧은 기술 구절)

config.toml 옵션에 따라 각 도구의 출력이 어떻게 달라지는지는 설정 옵션에 따른 출력 차이와 설정 플레이그라운드에서 확인할 수 있습니다.

세션 시작 시 호출하면 탐색 규칙과 모노레포에서 선택 가능한 workspace_scope 목록을 반환합니다.

{ "name": "initial_instructions", "arguments": {} }
The scope inventory below lists selectable scopes; call initial_instructions again only if it reports a warming indexer.
Selectable workspace_scope values:
- pkg (11,420 files; Go)
- public (9,810 files; TypeScript, SCSS)
- packages/grafana-data (640 files; TypeScript)
- packages/grafana-ui (1,510 files; TypeScript)

심볼이나 동작 개념을 BM25로 검색하며, workspace_scope로 검색 대상 패키지를 좁힐 수 있습니다.

{
"name": "search",
"arguments": {
"query": "SaveDashboard",
"workspace_scope": "pkg"
}
}
_Workspace scope: `pkg`. Pass `workspace_scope: "all"` for repo-wide search._
# codemap-search
## 1. pkg/services/dashboards/service/dashboard_service.go
- `method DashboardServiceImpl.SaveDashboard` (L142-178)
- _callers (approximate name scan):_
- `pkg/api/dashboard.go:318` (`HTTPServer.PostDashboard`)
- _calls (depth 1, approximate):_
- `buildSaveDashboardCommand` — `pkg/services/dashboards/service/dashboard_service.go:96`
### results
```
142→func (dr *DashboardServiceImpl) SaveDashboard(ctx context.Context, dto *dashboards.SaveDashboardDTO, allowUiUpdate bool) (*dashboards.Dashboard, error) {
143→ cmd, err := dr.buildSaveDashboardCommand(ctx, dto, allowUiUpdate)
144→ if err != nil {
145→ return nil, err
146→ }
147→ return dr.store.SaveDashboard(ctx, *cmd)
148→}
```

정확한 식별자, 오류 상수, 방금 수정한 코드를 정규식으로 찾습니다. pattern에 정규식 특수문자가 들어가면 이스케이프하세요.

{
"name": "grep",
"arguments": {
"pattern": "ErrDashboardVersionMismatch",
"path": "pkg",
"view": "source_grouped",
"expand": "none"
}
}
# codemap-search
## 1. pkg/services/dashboards/models.go
48:var ErrDashboardVersionMismatch = errors.New("the dashboard has been changed by someone else")
## 2. pkg/api/dashboard.go
334: if errors.Is(err, dashboards.ErrDashboardVersionMismatch) {

파일 내용이 아니라 파일명·경로 패턴으로 파일이나 디렉터리를 찾습니다.

{
"name": "find",
"arguments": {
"pattern": "*dashboard*service*.go",
"path": "pkg/services"
}
}
pkg/services/dashboards/service/dashboard_service.go
pkg/services/dashboards/service/dashboard_service_test.go

단일 줄 범위(offset + limit 또는 start_line + end_line)를 읽거나, ranges 배열(최대 20개)로 여러 구간을 한 번에 읽습니다.

{
"name": "read",
"arguments": {
"ranges": [
{ "file_path": "pkg/api/dashboard.go", "offset": 315, "limit": 8 },
{ "file_path": "pkg/services/dashboards/models.go", "offset": 46, "limit": 5 }
],
"view": "source"
}
}

색인 규모(target: "index")나 기록된 조회 통계(target: "reads")를 JSON으로 확인합니다.

{
"name": "analyze",
"arguments": { "target": "index", "language": "go", "sort": "size", "limit": 2 }
}
{
"target": "index",
"status": "ok",
"summary": { "files": 11420, "symbols": 198430 },
"columns": ["path", "language", "stored", "size", "lines", "symbols"],
"rows": [
["pkg/services/sqlstore/migrations/migrations.go", "go", 98210, 84210, 2140, 68],
["pkg/api/api.go", "go", 61400, 52380, 1180, 12]
]
}

.codemap/config.toml에서 [related_terms].enabled = true로 활성화한 뒤 사용합니다. 저장소 코드에 등장하는 관련 영어 용어와 유의어를 찾습니다. DashboardQuota → ["dashboard", "quota"]처럼 복합어는 단어별로 쪼개고, "rate limit" 같은 단일 개념 구절은 그대로 넣으세요.

{ "name": "synonyms", "arguments": { "terms": ["quota"] } }
### Resource Allocation ("quota")
Direct (showing 3 of 3; 3 in code): "allowance", "limit", "threshold"