Community라이팅 & 에디팅github.com

s0hv/agent-skills

나만의 맞춤형 에이전트 스킬 (JetBrains MCP 서버 활용)

agent-skills란 무엇인가요?

이 스킬은 JetBrains MCP 서버를 에이전트(Claude Code, Cursor 등)에서 효과적으로 활용할 수 있도록 가이드하는 설정입니다. IDE 환경에서 `grep`, `find` 같은 범용 CLI 명령어 대신 `search_file`, `search_symbol`, `rename_refactoring` 등 전용 도구를 사용하여 프로젝트 분석, 코드 탐색, 리팩터링을 더 정확하고 빠르게 수행합니다. JetBrains IDE(IntelliJ, PyCharm 등)와 연동되며, 프로젝트 파일에 한정된 작업, 1‑기반 라인/컬럼 번호 사용, 출력 길이 제어 등 구체적인 제약 조건을 명시하여 에이전트가 안정적으로 동작하도록 돕습니다. 참조 파일별로 분석, 디버깅, 실행, 서식, 검색 등 유스케이스에 맞게 도구가 분류되어 있어, 상황에 적합한 도구를 빠르게 선택할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add s0hv/agent-skills

Installed? Explore more 라이팅 & 에디팅 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

사용 시기

JetBrains MCP 서버는 grep이나 find 같은 범용 명령줄 도구 대신 사용해야 합니다. MCP 서버를 사용해야 하는 예시 상황은 다음과 같습니다:

  • 파일, 심볼 또는 텍스트 검색 시
    • search_file
    • search_symbol
    • search_text
    • search_regex
  • 심볼에 대한 문서가 필요할 때 (패키지 및 자체 코드 모두 동작)
    • get_symbol_info
  • 특정 코드가 사용되는 위치를 찾을 때
    • analyze_calls
  • 심볼 이름을 변경할 때
    • rename_refactoring
  • 파일 목록을 확인할 때
    • list_directory_tree

다른 사용 사례의 경우, 도구 이름이 사용 사례에 적합한지 확인하고 참고 자료에서 더 많은 정보를 확인하세요.

제약 사항

  • projectPath는 모호함을 방지하기 위해 항상 인수로 전달해야 합니다.
  • 도구는 프로젝트 파일에 대해서만 동작합니다.
  • 경우에 따라 사용자가 일부 MCP 서버 엔드포인트를 비활성화했을 수 있습니다. 해당 상황에서는 해당 도구를 사용하지 말아야 합니다. 여전히 도구가 필요하다면 사용자에게 확인을 요청하세요.
  • 도구 출력이 너무 길어지거나 처리 시간이 오래 걸리지 않도록 수동으로 출력을 제어하세요.
  • 라인 및 컬럼 번호는 1부터 시작합니다.

사용 가능한 도구

다음 섹션에서는 도구를 명시적으로 나열하거나, 참조 파일에서 언제 사용해야 하는지에 대한 간단한 설명을 제공합니다. 참조 파일은 사용 가능한 모든 내용에 대한 완전한 개요를 포함하고 있습니다. 해당 섹션에 도구가 포함될 수 있다면 파일을 로드하여 확인하세요.

reference/analysis-tools.md

프로젝트 구조와 코드를 분석하는 데 사용되는 도구를 포함합니다. 사용 가능한 도구:

  • analyze_calls
  • build_project
  • get_file_problems
  • get_project_dependencies
  • get_project_modules
  • lint_files

reference/code-insight-tools.md

  • get_symbol_info

reference/database-tools.md

프로젝트의 데이터베이스와 상호작용하는 데이터베이스 도구입니다. 데이터 손실을 초래할 수 있으므로 권한이 있을 때만 사용하세요.

reference/debugger-tools.md

활성 디버거 세션을 읽고 조작하는 데 도움을 주는 도구입니다. 활성 디버거 세션이 있다고 전달받았을 때만 사용하세요.

reference/execution-tools.md

다양한 실행 구성을 실행하는 도구입니다. 사용자가 실행 구성을 사용하도록 요청했을 때만 사용하세요.

  • execute_run_configuration
  • get_run_configurations

reference/file-tools.md

  • create_new_file
  • get_all_open_file_paths
  • list_directory_tree
  • open_file_in_editor

reference/formatting-tools.md

  • reformat_file

reference/read-tools.md

  • read_file

reference/refactoring-tools.md

  • rename_refactoring

reference/search-tools.md

  • search_file
  • search_regex
  • search_symbol
  • search_text

reference/terminal-tools.md

  • execute_terminal_command

관련 스킬