[추천 스킬 #4] 로컬 파일 시스템 탐색 & 편집 스킬: 대용량 디렉토리 및 파일 수정

실무 코드베이스나 대규모 프로젝트 워크스페이스는 수백 개의 폴더와 수천 개의 파일로 얽혀 있습니다. 전체 파일을 통째로 덮어쓰거나 읽는 방식은 비용과 토큰 효율성 면에서 불가능합니다. **에이전트 추천 스킬 4호**는 바로 **'파일 시스템 탐색 & 정밀 편집 스킬(File System Manipulation Skill)'**입니다.

1. 파일 시스템 스킬의 3가지 핵심 도구 조합

토큰 소비를 90% 이상 절감하며 안전하게 코드를 고치는 조합입니다.

• 디렉토리 탐색 (list_dir): 프로젝트 폴더 구조와 파일 목록을 재귀적으로 빠르게 스캔합니다.
• 패턴 고속 탐색 (grep_search / Ripgrep): 정규식(Regex) 또는 키워드로 관련 심볼이나 함수가 포함된 정확한 라인 번호를 도출합니다.
• 부분 교체 (replace_file_content / multi_replace): 전체 파일 덮어쓰기 없이 타겟 라인 블록만 비파괴적으로 정밀 수정합니다.

2. 파일 시스템 스킬 지침 설계

# SKILL.md 파일 편집 가이드라인 예시
name: file_manipulator
description: 소스 코드나 마크다운 문서를 읽고 특정 부분만 정밀 교체할 때 호출합니다.

rules:
  - 1. 수정 전 grep_search로 대상 라인 번호와 정확한 고유 문자열을 확인합니다.
  - 2. 변경되지 않는 주위 주석이나 기존 함수 코드는 원본 그대로 보존합니다.
  - 3. 대용량 파일 전체 덮어쓰기(Overwrite)는 금지하며 정밀 덩어리 교체를 수행합니다.

"정밀한 파일 편집 스킬을 장착한 에이전트는 거대한 기업 프로젝트도 무너뜨리지 않고 깨끗하게 리팩토링하는 최고의 개발 파트너가 됩니다."

3. 활용 예시: 프로젝트 전체 변수명 일괄 변경 및 의존성 업데이트

프로젝트 내 50개 파일에 흩어져 있는 구버전 API 함수명을 탐색하여 오차 없이 단 일회 호출로 안전하게 업데이트하는 워크플로우 완성이 가능해집니다.

4. 요약: 프로젝트 탐색 및 수정을 자동화하라

파일 시스템 제어 스킬을 활용하여 대규모 프로젝트를 손쉽게 조작하는 자율형 코딩 에이전트를 만나보세요.